|
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 Bitstring 1 LKXMFLG2 Additional MDISK flags
1... .... LKXLOCAL X'80' LKXLOCAL - minidisk local
to this system
.1.. .... LKXPRVMD X'40' LKXPRVMD - private minidisk
..1. .... LKXLKCOM X'20' LKXLKCOM - communicated for
LINK
...1 .... LKXVFORC X'10' LKXVFORC - "v" suffix
forced
.... 1... LKXWFORC X'08' LKXWFORC - WRKALLEG forced
.... .1.. LKXWKADD X'04' LKXWKADD - WRKALLEG added
0033 51 Bitstring 1 * 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' LKXTDISK - temporary dasd
(tdisk) request
.1.. .... LKXDED X'40' LKXDED - dedicated dasd
..1. .... LKXEND X'20' LKXEND - 'END' specified
...1 .... LKXV X'10' LKXV - virtual
reserve/release request
.... 1... LKXNOASN X'08' LKXNOASN - 'NOASSIGN'
option
.... .1.. LKXDVFP X'04' LKXDVFP - 'DEVNO' option
specified
.... ..1. LKXFB512 X'02' LKXFB512 - 'FB-512' (any
FBA) specified
.... ...1 LKXWRKAL X'01' LKXWRKAL - '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' LKXEXIST - LKXIASV already
def'd
.1.. .... LKXRELIN X'40' LKXRELIN - relink (request
= have)
..1. .... LKXOVLAP X'20' LKXOVLAP - requested mdisk
overlaps others
...1 .... LKXQDLOK X'10' LKXQDLOK - 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' LKXCFORC - R/W request
downgraded to R/O
.1.. .... LKXCMDCP X'40' LKXCMDCP - MDC prohibited
..1. .... LKXCRECC X'20' LKXCRECC - MDC record cache
requested
...1 .... LKXNOPLX X'10' LKXNOPLX - Don't ask SSI
.... 1... LKXWTLNK X'08' LKXWTLNK - Other member of
SSI has a write link
.... .1.. LKXRDFPO X'04' LKXRDFPO - Other member of
SSI has a DIAG xE4 fullpack
overlay
.... ..1. LKXOSUBC X'02' LKXOSUBC - Defined in
SUBCONFIG for a different SSI
member miscellanea
0093 147 Bitstring 1 LKXFMTNO format number (device class)
0094 148 Bitstring 1 LKXFROM style of link:
.... .... LKXFLOG 0 LKXFLOG - from logon (dir MDISK
or LINK)
.... ...1 LKXFLOGQ 1 LKXFLOGQ - from logon (with
quiet option)
.... ..1. LKXFLINK 2 LKXFLINK - from command LINK
.... ..11 LKXFDEF 3 LKXFDEF - from command DEFINE
MDISK
.... .1.. LKXFINFO 4 LKXFINFO - from diag E4 INFO f1
DISK or SET/Q MDCACHE command
.... .1.1 LKXFFPO2 5 LKXFFPO2 - from diag E4 FPO f2
DISK
.... .11. LKXFFPO3 6 LKXFFPO3 - from diag E4 FPO f3
DISK
.... .111 LKXFCPAC 7 LKXFCPAC - from command
CPACCESS
.... 1... LKXFDEFQ 8 LKXFDEFQ - from command DEFINE
VFB-512
.... 1..1 LKXFDG88 9 LKXFDG88 - from Diagnose 88
.... 1.1. LKXFRELO 10 LKXFRELO - from Live Guest
Relocation special parameters for
error messages
0095 149 Bitstring 1 LKXERROR LKX* error number
00000001 LKX002 X'01' LKX002
00000002 LKX020 X'02' LKX020
00000003 LKX022 X'03' LKX022
00000004 LKX024 X'04' LKX024
00000005 LKX026 X'05' LKX026
00000006 LKX046 X'06' LKX046
00000007 LKX052 X'07' LKX052
00000008 LKX053 X'08' LKX053
00000009 LKX091 X'09' LKX091
00000035 LKX091V2 X'35' LKX091V2
0000000A LKX092 X'0A' LKX092
0000000B LKX107 X'0B' LKX107
0000000C LKX108 X'0C' LKX108
0000000D LKX109 X'0D' LKX109
00000034 LKX109V2 X'34' LKX109V2
0000000E LKX110 X'0E' LKX110
0000000F LKX114 X'0F' LKX114
00000010 LKX115 X'10' LKX115
00000011 LKX117 X'11' LKX117
00000012 LKX118 X'12' LKX118
00000013 LKX153 X'13' LKX153
00000014 LKX298 X'14' LKX298
00000015 LKX844 X'15' LKX844
00000016 LKX6525 X'16' LKX6525
00000017 LKX1150 X'17' LKX1150
00000018 LKX1151 X'18' LKX1151
00000019 LKX1152 X'19' LKX1152
0000001A LKX1153 X'1A' LKX1153
0000001B LKX1155 X'1B' LKX1155
0000001C LKX1156 X'1C' LKX1156
0000001D LKX111 X'1D' LKX111
0000001E LKX112 X'1E' LKX112
0000001F LKX113 X'1F' LKX113 messages with counts
& userids follow
00000020 LKX100 X'20' LKX100 base emsg-s
00000021 LKX101 X'21' LKX101
00000022 LKX102 X'22' LKX102
00000023 LKX103 X'23' LKX103
00000024 LKX104 X'24' LKX104
00000025 LKX105 X'25' LKX105
00000026 LKX106 X'26' LKX106 imsg-s (responses)
0000002A LKXR1 X'2A' LKXR1
0000002B LKXR2 X'2B' LKXR2
0000002C LKXR3 X'2C' LKXR3
0000002D LKXR4 X'2D' LKXR4
0000002E LKXR5 X'2E' LKXR5
0000002F LKXR6 X'2F' LKXR6 End of messages with
counts & userids
00000030 LKX1157 X'30' LKX1157
00000031 LKX1158 X'31' LKX1158
00000032 LKX6761 X'32' LKX6761
00000033 LKX1159 X'33' LKX1159
00000036 LKX2880 X'36' LKX2880
00000037 LKX6867 X'37' LKX6867
00000038 LKX6867H X'38' LKX6867H
00000039 LKX6640 X'39' LKX6640
0000003A LKX6645 X'3A' LKX6645
0000003B LKX048 X'3B' LKX048
0000003C LKX66409 X'3C' LKX66409 X'E0'-X'FF' all
reserved for return codes.
000000E0 LKXE23 X'E0' LKXE23
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' LKXNOMSG - Don't issue any
messages
.1.. .... LKXNOPWD X'40' LKXNOPWD - No password
needed (regardless of VMDLNKNP
setting)
..1. .... LKXPWDRQ X'20' LKXPWDRQ - Password
required (regardless of VMDLNKNP
setting)
...1 .... LKXPWMOD X'10' LKXPWMOD - Establish link
with mode authorized by supplied
password journaling bits
0099 153 Bitstring 1 LKXJOURN Status of journaling operations
1... .... LKXPWALL X'80' LKXPWALL - password of ALL
encountered
.1.. .... LKXNJOUR X'40' LKXNJOUR - user is
relinking with same addr & mode,
no journaling needed
..1. .... LKXSELFL X'20' LKXSELFL - disk being
linked is own disk
009A 154 Bitstring 1 LKXINMOD Input behavior modifier field
1... .... LKXNOLKS X'80' LKXNOLKS Hold no locks upon
exit
009B 155 Bitstring 1 LKXGFLGS General link flags
1... .... LKXQMDIS X'80' LKXQMDIS Diag E4 function
called via Q Mdisk
.1.. .... LKXPAVAL X'40' LKXPAVAL Virtual PAV Alias
is being defined
..1. .... LKXHYPAL X'20' LKXHYPAL Virtual HPV Alias
is being defined
...1 .... LKXQRMDI X'10' LKXQRMDI Diag E4 function
called via Q Mdisk reserved
.... 1... LKXCPACA X'08' LKXCPACA Asynch CPACCESS
issued
.... .1.. LKXCPACS X'04' LKXCPACS Synch CPACCESS
issued
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
0128 296 Character 8 LKRESSYS Name of system which holds the
reserve OR the system on which
LKRESUSR resides.
0130 304 Character 8 LKRESUSR Name of the user who holds the
reserve
0138 312 Signed 4 LKXWMASK Mask of system(s) with write link
013C 316 Signed 4 LKXLGRVD Address of LGRVDEV
0140 320 Dbl-Word 8 LKXLKTIM Time spent communicating for LINK
0148 328 Character 8 LKXRMEMB Member name for read link
0150 336 Character 8 LKXWMEMB Member name for write link
0158 344 Character 8 LKXSMEMB Member name for stable link
0160 352 Character 8 LKXEMEMB Member name for exclusive link
0168 360 Character 8 LKXTUSR Userid for ACITUSR
0170 368 Character 8 LKXSUBCF Userid for ACISUBCF
0178 376 Signed 4 LKXATVMD Addr of AT Command VMDBK
00000030 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 |:MFLG2|//////| 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 | LKRESSYS |
* +-------------------------------------------------------+
* 130 | LKRESUSR |
* +---------------------------+---------------------------+
* 138 | LKXWMASK | LKXLGRVD |
* +---------------------------+---------------------------+
* 140 | LKXLKTIM |
* +-------------------------------------------------------+
* 148 | LKXRMEMB |
* +-------------------------------------------------------+
* 150 | LKXWMEMB |
* +-------------------------------------------------------+
* 158 | LKXSMEMB |
* +-------------------------------------------------------+
* 160 | LKXEMEMB |
* +-------------------------------------------------------+
* 168 | LKXTUSR |
* +-------------------------------------------------------+
* 170 | LKXSUBCF |
* +---------------------------+---------------------------+
* 178 | LKXATVMD | 17C
* +---------------------------+
*
*** LKBK - Minidisk LINK Block
LKBK Cross Reference
Symbol Dspl Value -------------- ---- ----- LKRESSYS 0128 LKRESUSR 0130 LKXACIDN 0046 04 LKXACION 0046 02 LKXACIRO 0046 01 LKXACI2 0046 08 LKXACTNM 0120 LKXAFLAG 0046 LKXAMODE 0044 LKXAMODX 0045 LKXATVMD 0178 LKXAUSER 00A0 LKXBUFF 00A8 LKXCFLAG 0092 LKXCFORC 0092 80 LKXCLAS 0040 LKXCMDCP 0092 40 LKXCODE 0040 LKXCPACA 009B 08 LKXCPACS 009B 04 LKXCRECC 0092 20 LKXDED 0042 40 LKXDVFP 0042 04 LKXECMSA 006C LKXECNT 005C LKXEEXT 0038 LKXEMEMB 0160 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 LKXFRELO 0094 0A LKXFROM 0094 LKXGFLGS 009B LKXGMDSK 0048 LKXGMODE 0090 LKXGMODX 0091 LKXGVDEV 004C LKXHFLAG 0047 LKXHYPAL 009B 20 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 LKXLGRVD 013C LKXLKCOM 0032 20 LKXLKTIM 0140 LKXLOCAL 0032 80 LKXMFLAG 0042 LKXMFLG2 0032 LKXNEXT 003C LKXNJOUR 0099 40 LKXNOASN 0042 08 LKXNOLKS 009A 80 LKXNOMSG 0098 80 LKXNOPLX 0092 10 LKXNOPWD 0098 40 LKXOPTS 0098 LKXOSUBC 0092 02 LKXOVLAP 0047 20 LKXOWNRU 0020 LKXOWNRV 0030 LKXPAVAL 009B 40 LKXPRVMD 0032 40 LKXPWALL 0099 80 LKXPWDRQ 0098 20 LKXPWMOD 0098 10 LKXQDLOK 0047 10 LKXQMDIS 009B 80 LKXQRMDI 009B 10 LKXRCMSA 0060 LKXRCNT 0050 LKXRDEVN 0028 LKXRDFPO 0092 04 LKXRELIN 0047 40 LKXRMEMB 0148 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 0178 00000030 LKXSMEMB 0158 LKXSUBCF 0170 LKXSUSER 0080 LKXTDISK 0042 80 LKXTOD 0118 LKXTUSR 0168 LKXTYPE 0041 LKXV 0042 10 LKXVFORC 0032 10 LKXVSER 002A LKXWCMSA 0064 LKXWCNT 0054 LKXWFORC 0032 08 LKXWKADD 0032 04 LKXWMASK 0138 LKXWMEMB 0150 LKXWRKAL 0042 01 LKXWTLNK 0092 08 LKXWUSER 0078 LKX002 0095 00000001 LKX020 0095 00000002 LKX022 0095 00000003 LKX024 0095 00000004 LKX026 0095 00000005 LKX046 0095 00000006 LKX048 0095 0000003B 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 LKX6640 0095 00000039 LKX66409 0095 0000003C LKX6645 0095 0000003A LKX6761 0095 00000032 LKX6867 0095 00000037 LKX6867H 0095 00000038 LKX844 0095 00000015
Copyright IBM Corporation, 1990, 2011