|
Programming Interface Information:
This information is NOT intended to be used as Programming Interfaces of z/VM. |
LKBK
Control Block Contents
LKBK DSECT
Cross Reference (Contains links to field and bit definitions)
LKBK Prolog
NAME : HCPLKBK
DESCRIPTION: Minidisk LINK Block
DSECT : LKBK
FUNCTION : A representation of a minidisk being defined.
LOCATED BY : None
CREATED BY : HCPDEF,HCPLNK,HCPLGD,HCPDMD,HCPZIA,HCPZAC
DELETED BY : HCPDEF,HCPLNK,HCPLGD,HCPDMD,HCPZIA,HCPZAC
SERIALIZED : None
Exists only during the creation of a link due to one of
- Command LINK
- Command DEFINE MDISK
- Command DEFINE VFB-512 (qdisk)
- Command DEFINE Tnnnn (tdisk)
- Logon directory statement LINK
- Logon directory statement MDISK
- Logon directory statement MDISK V-DISK
- Logon directory statement MDISK T-DISK
- Diagnose X'E4' subcode X'01'
- Diagnose X'E4' subcode X'02' (fullpack overlay)
- Diagnose X'E4' subcode X'03' (fullpack overlay)
- Execution of CP_ACCESS statement or CPACCESS command
LKBK Control Block Content
LKBK DSECT
Hex Dec Type/Val Lng Label (dup) Comments
---- ---- --------- ---- -------------- --------
0000 0 Structure LKBK Minidisk LINK Block
link description in indirect terms
0000 0 Character 8 LKXITOU link-to userid
0008 8 Character 8 LKXITOCM link-to CMS adjunct user
identifier
0010 16 Signed 2 LKXITOV link-to vdevno
0012 18 Signed 2 LKXIASV link-as vdevno
0014 20 Character 2 LKXIMODC link mode (string)
0016 22 Bitstring 1 LKXIMODE link mode code (less than X'40')
0017 23 Bitstring 1 LKXIMODX link mode code w/extensions
0018 24 Character 8 LKXIPSWD password entered
link description in direct terms (actual mdisk)
0020 32 Character 8 LKXOWNRU owning userid
0028 40 Signed 2 LKXRDEVN rdevno
002A 42 Character 6 LKXVSER volume serial number
0030 48 Signed 2 LKXOWNRV owning vdevno
0032 50 Signed 2 * reserved
0034 52 Signed 4 LKXSEXT start cylinder/block of minidisk
extent
0038 56 Signed 4 LKXEEXT end cylinder/block of minidisk
003C 60 Signed 4 LKXNEXT number of cylinders/blocks
0040 64 Signed 2 LKXCODE (0) (class and type together) \
0040 64 Bitstring 1 LKXCLAS device class (=DASD) |
0041 65 Bitstring 1 LKXTYPE DASD type /
0042 66 Bitstring 1 LKXMFLAG mdisk flags:
1... .... LKXTDISK X'80' - temporary dasd (tdisk)
request
.1.. .... LKXDED X'40' - dedicated dasd
..1. .... LKXEND X'20' - 'END' specified
...1 .... LKXV X'10' - virtual reserve/release
request
.... 1... LKXNOASN X'08' - 'NOASSIGN' option
.... .1.. LKXDVFP X'04' - 'DEVNO' option specified
.... ..1. LKXFB512 X'02' - 'FB-512' (any FBA)
specified
.... ...1 LKXWRKAL X'01' - 'WRKALLEG' specified The
following byte is copied intact
from DDEVFLGB.
0043 67 Bitstring 1 LKXJFLAG minidisk caching directory flags:
X'80' - (would be from DDEVWKAL)
.1.. .... LKXJCNA X'40' - caching not available
..1. .... LKXJSCTL X'20' - subsystem control
...1 .... LKXJDCTL X'10' - device control
.... 1... LKXJNCTL X'08' - no control
.... .1.. LKXJNMDC X'04' - NOMDC specified
.... ..1. LKXJQDSK X'02' - Vdisk request
.... ...1 LKXJYMDC X'01' - MDC specified
link authorization
0044 68 Bitstring 1 LKXAMODE link mode, directory
authorization
0045 69 Bitstring 1 LKXAMODX link mode (w/ exten), dir auth
0046 70 Bitstring 1 LKXAFLAG authorization flags: X'E0' -
password exists on MDISK stmt
(three bits defined for DDEVALNK)
.... 1... LKXACI2 X'08' - Calling the ESM a second
time for audit of link mode
granted
.... .1.. LKXACIDN X'04' - Call to ESM routine was
made
.... ..1. LKXACION X'02' - Indicates ESM should be
called for authorization and/or
audit
.... ...1 LKXACIRO X'01' - forced R/O by ACI
description of link device already defined
0047 71 Bitstring 1 LKXHFLAG "have" flags
1... .... LKXEXIST X'80' - LKXIASV already def'd
.1.. .... LKXRELIN X'40' - relink (request = have)
..1. .... LKXOVLAP X'20' - requested mdisk overlaps
others
...1 .... LKXQDLOK X'10' - have Vdisk allocation
lock blocks
0048 72 Signed 4 LKXGMDSK address of MDISK with same extent
004C 76 Signed 4 LKXGVDEV address of VDEV just created or
being relinked
description of other links
including overlapping minidisks
0050 80 Signed 4 LKXRCNT count of read links
0054 84 Signed 4 LKXWCNT count of write links
0058 88 Signed 4 LKXSCNT count of stable links
005C 92 Signed 4 LKXECNT count of exclusive links (0 or 1)
0060 96 Signed 4 LKXRCMSA Adjunct read link work area
0064 100 Signed 4 LKXWCMSA Adjunct write link work area
0068 104 Signed 4 LKXSCMSA Adjunct stable link work area
006C 108 Signed 4 LKXECMSA Adjunct exclusive link work area
0070 112 Character 8 LKXRUSER userid of read link, if one
exists
0078 120 Character 8 LKXWUSER userid of write link, if one
exists
0080 128 Character 8 LKXSUSER userid of stable link, if one
exists
0088 136 Character 8 LKXEUSER userid of exclusive link, if one
exists
0090 144 Bitstring 1 LKXGMODE link mode
0091 145 Bitstring 1 LKXGMODX link mode extended
0092 146 Bitstring 1 LKXCFLAG conflict flags
1... .... LKXCFORC X'80' - R/W request downgraded to
R/O
.1.. .... LKXCMDCP X'40' - MDC prohibited
..1. .... LKXCRECC X'20' - MDC record cache
requested miscellanea
0093 147 Bitstring 1 LKXFMTNO format number (device class)
0094 148 Bitstring 1 LKXFROM style of link:
.... .... LKXFLOG 0 - from logon (dir MDISK or
LINK)
.... ...1 LKXFLOGQ 1 - from logon (with quiet
option)
.... ..1. LKXFLINK 2 - from command LINK
.... ..11 LKXFDEF 3 - from command DEFINE MDISK
.... .1.. LKXFINFO 4 - from diag E4 INFO f1 DISK or
SET/Q MDCACHE command
.... .1.1 LKXFFPO2 5 - from diag E4 FPO f2 DISK
.... .11. LKXFFPO3 6 - from diag E4 FPO f3 DISK
.... .111 LKXFCPAC 7 - from command CPACCESS
.... 1... LKXFDEFQ 8 - from command DEFINE VFB-512
.... 1..1 LKXFDG88 9 - from Diagnose 88 special
parameters for error messages
0095 149 Bitstring 1 LKXERROR LKX* error number
00000001 LKX002 X'01'
00000002 LKX020 X'02'
00000003 LKX022 X'03'
00000004 LKX024 X'04'
00000005 LKX026 X'05'
00000006 LKX046 X'06'
00000007 LKX052 X'07'
00000008 LKX053 X'08'
00000009 LKX091 X'09'
00000035 LKX091V2 X'35'
0000000A LKX092 X'0A'
0000000B LKX107 X'0B'
0000000C LKX108 X'0C'
0000000D LKX109 X'0D'
00000034 LKX109V2 X'34'
0000000E LKX110 X'0E'
0000000F LKX114 X'0F'
00000010 LKX115 X'10'
00000011 LKX117 X'11'
00000012 LKX118 X'12'
00000013 LKX153 X'13'
00000014 LKX298 X'14'
00000015 LKX844 X'15'
00000016 LKX6525 X'16'
00000017 LKX1150 X'17'
00000018 LKX1151 X'18'
00000019 LKX1152 X'19'
0000001A LKX1153 X'1A'
0000001B LKX1155 X'1B'
0000001C LKX1156 X'1C'
0000001D LKX111 X'1D'
0000001E LKX112 X'1E'
0000001F LKX113 X'1F' messages with counts &
userids follow
00000020 LKX100 X'20' base emsg-s
00000021 LKX101 X'21'
00000022 LKX102 X'22'
00000023 LKX103 X'23'
00000024 LKX104 X'24'
00000025 LKX105 X'25'
00000026 LKX106 X'26' imsg-s (responses)
0000002A LKXR1 X'2A'
0000002B LKXR2 X'2B'
0000002C LKXR3 X'2C'
0000002D LKXR4 X'2D'
0000002E LKXR5 X'2E'
0000002F LKXR6 X'2F' End of messages with counts
& userids
00000030 LKX1157 X'30'
00000031 LKX1158 X'31'
00000032 LKX6761 X'32'
00000033 LKX1159 X'33'
00000036 LKX2880 X'36'
000000E0 LKXE23 X'E0'
0096 150 Signed 2 LKXERRV vdevno for some error messages
link processing options
0098 152 Bitstring 1 LKXOPTS Options to use for linking
1... .... LKXNOMSG X'80' - Don't issue any messages
.1.. .... LKXNOPWD X'40' - No password needed
(regardless of VMDLNKNP setting)
..1. .... LKXPWDRQ X'20' - Password required
(regardless of VMDLNKNP setting)
...1 .... LKXPWMOD X'10' - Establish link with mode
authorized by supplied password
journaling bits
0099 153 Bitstring 1 LKXJOURN Status of journaling operations
1... .... LKXPWALL X'80' - password of ALL
encountered
.1.. .... LKXNJOUR X'40' - user is relinking with
same addr & mode, no journaling
needed
..1. .... LKXSELFL X'20' - disk being linked is own
disk
009A 154 Bitstring 1 LKXINMOD Input behavior modifier field
1... .... LKXNOLKS X'80' Hold no locks upon exit
009B 155 Bitstring 1 LKXGFLGS General link flags
1... .... LKXQMDIS X'80' Diag E4 function called via
Q Mdisk
009C 156 Signed 4 LKXEMSGN emsgno that was last issued
00A0 160 Character 8 LKXAUSER user to perform checks for
00A8 168 Character 112 LKXBUFF message data buffer
0118 280 Dbl-Word 8 LKXTOD TOD buffer for Vdisk
0120 288 Character 8 LKXACTNM Account number for Vdisk
00000025 LKXSIZE (*-LKBK+7)/8 Size, in
doublewords, of LKBK
LKBK Storage Layout
*** LKBK - Minidisk LINK Block
*
* +-------------------------------------------------------+
* 0 | LKXITOU |
* +-------------------------------------------------------+
* 8 | LKXITOCM |
* +-------------+-------------+-------------+------+------+
* 10 | LKXITOV | LKXIASV | LKXIMODC |:IMODE|:IMODX|
* +-------------+-------------+-------------+------+------+
* 18 | LKXIPSWD |
* +-------------------------------------------------------+
* 20 | LKXOWNRU |
* +-------------+-----------------------------------------+
* 28 | LKXRDEVN | LKXVSER |
* +-------------+-------------+---------------------------+
* 30 | LKXOWNRV |/////////////| LKXSEXT |
* +-------------+-------------+---------------------------+
* 38 | LKXEEXT | LKXNEXT |
* +------+------+------+------+------+------+------+------+
* 40 |:CLAS |:TYPE |:MFLAG|:JFLAG|:AMODE|:AMODX|:AFLAG|:HFLAG|
* +------+------+------+------+------+------+------+------+
* 48 | LKXGMDSK | LKXGVDEV |
* +---------------------------+---------------------------+
* 50 | LKXRCNT | LKXWCNT |
* +---------------------------+---------------------------+
* 58 | LKXSCNT | LKXECNT |
* +---------------------------+---------------------------+
* 60 | LKXRCMSA | LKXWCMSA |
* +---------------------------+---------------------------+
* 68 | LKXSCMSA | LKXECMSA |
* +---------------------------+---------------------------+
* 70 | LKXRUSER |
* +-------------------------------------------------------+
* 78 | LKXWUSER |
* +-------------------------------------------------------+
* 80 | LKXSUSER |
* +-------------------------------------------------------+
* 88 | LKXEUSER |
* +------+------+------+------+------+------+-------------+
* 90 |:GMODE|:GMODX|:CFLAG|:FMTNO|:FROM |:ERROR| LKXERRV |
* +------+------+------+------+------+------+-------------+
* 98 |:OPTS |:JOURN|:INMOD|:GFLGS| LKXEMSGN |
* +------+------+------+------+---------------------------+
* A0 | LKXAUSER |
* +-------------------------------------------------------+
* A8 | |
* = LKXBUFF =
* | |
* +-------------------------------------------------------+
* 118 | LKXTOD |
* +-------------------------------------------------------+
* 120 | LKXACTNM |
* +-------------------------------------------------------+
* 128
*
*** LKBK - Minidisk LINK Block
LKBK Cross Reference
Symbol Dspl Value -------------- ---- ----- LKXACIDN 0046 04 LKXACION 0046 02 LKXACIRO 0046 01 LKXACI2 0046 08 LKXACTNM 0120 LKXAFLAG 0046 LKXAMODE 0044 LKXAMODX 0045 LKXAUSER 00A0 LKXBUFF 00A8 LKXCFLAG 0092 LKXCFORC 0092 80 LKXCLAS 0040 LKXCMDCP 0092 40 LKXCODE 0040 LKXCRECC 0092 20 LKXDED 0042 40 LKXDVFP 0042 04 LKXECMSA 006C LKXECNT 005C LKXEEXT 0038 LKXEMSGN 009C LKXEND 0042 20 LKXERROR 0095 LKXERRV 0096 LKXEUSER 0088 LKXEXIST 0047 80 LKXE23 0095 000000E0 LKXFB512 0042 02 LKXFCPAC 0094 07 LKXFDEF 0094 03 LKXFDEFQ 0094 08 LKXFDG88 0094 09 LKXFFPO2 0094 05 LKXFFPO3 0094 06 LKXFINFO 0094 04 LKXFLINK 0094 02 LKXFLOG 0094 00 LKXFLOGQ 0094 01 LKXFMTNO 0093 LKXFROM 0094 LKXGFLGS 009B LKXGMDSK 0048 LKXGMODE 0090 LKXGMODX 0091 LKXGVDEV 004C LKXHFLAG 0047 LKXIASV 0012 LKXIMODC 0014 LKXIMODE 0016 LKXIMODX 0017 LKXINMOD 009A LKXIPSWD 0018 LKXITOCM 0008 LKXITOU 0000 LKXITOV 0010 LKXJCNA 0043 40 LKXJDCTL 0043 10 LKXJFLAG 0043 LKXJNCTL 0043 08 LKXJNMDC 0043 04 LKXJOURN 0099 LKXJQDSK 0043 02 LKXJSCTL 0043 20 LKXJYMDC 0043 01 LKXMFLAG 0042 LKXNEXT 003C LKXNJOUR 0099 40 LKXNOASN 0042 08 LKXNOLKS 009A 80 LKXNOMSG 0098 80 LKXNOPWD 0098 40 LKXOPTS 0098 LKXOVLAP 0047 20 LKXOWNRU 0020 LKXOWNRV 0030 LKXPWALL 0099 80 LKXPWDRQ 0098 20 LKXPWMOD 0098 10 LKXQDLOK 0047 10 LKXQMDIS 009B 80 LKXRCMSA 0060 LKXRCNT 0050 LKXRDEVN 0028 LKXRELIN 0047 40 LKXRUSER 0070 LKXR1 0095 0000002A LKXR2 0095 0000002B LKXR3 0095 0000002C LKXR4 0095 0000002D LKXR5 0095 0000002E LKXR6 0095 0000002F LKXSCMSA 0068 LKXSCNT 0058 LKXSELFL 0099 20 LKXSEXT 0034 LKXSIZE 0120 00000025 LKXSUSER 0080 LKXTDISK 0042 80 LKXTOD 0118 LKXTYPE 0041 LKXV 0042 10 LKXVSER 002A LKXWCMSA 0064 LKXWCNT 0054 LKXWRKAL 0042 01 LKXWUSER 0078 LKX002 0095 00000001 LKX020 0095 00000002 LKX022 0095 00000003 LKX024 0095 00000004 LKX026 0095 00000005 LKX046 0095 00000006 LKX052 0095 00000007 LKX053 0095 00000008 LKX091 0095 00000009 LKX091V2 0095 00000035 LKX092 0095 0000000A LKX100 0095 00000020 LKX101 0095 00000021 LKX102 0095 00000022 LKX103 0095 00000023 LKX104 0095 00000024 LKX105 0095 00000025 LKX106 0095 00000026 LKX107 0095 0000000B LKX108 0095 0000000C LKX109 0095 0000000D LKX109V2 0095 00000034 LKX110 0095 0000000E LKX111 0095 0000001D LKX112 0095 0000001E LKX113 0095 0000001F LKX114 0095 0000000F LKX115 0095 00000010 LKX1150 0095 00000017 LKX1151 0095 00000018 LKX1152 0095 00000019 LKX1153 0095 0000001A LKX1155 0095 0000001B LKX1156 0095 0000001C LKX1157 0095 00000030 LKX1158 0095 00000031 LKX1159 0095 00000033 LKX117 0095 00000011 LKX118 0095 00000012 LKX153 0095 00000013 LKX2880 0095 00000036 LKX298 0095 00000014 LKX6525 0095 00000016 LKX6761 0095 00000032 LKX844 0095 00000015
Copyright IBM Corporation, 1990, 2004