|
Programming Interface Information:
This information is NOT
intended to be
used as Programming Interfaces of VM/ESA. It is to be used for diagnosis only. |
LKBK
Cross Reference (Contains links to field and bit definitions)
LKBK Prolog
NAME : HCPLKBK
DESCRIPTION: Minidisk LINK Block
DSECT : LKBK
STATUS : VM/ESA Version 1, Release 2.2
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 Signed 2 LKXITOV link-to vdevno 000A 10 Signed 2 LKXIASV link-as vdevno 000C 12 Character 2 LKXIMODC link mode (string) 000E 14 Bitstring 1 LKXIMODE link mode code (less than X'40') 000F 15 Bitstring 1 LKXIMODX link mode code w/extensions 0010 16 Character 8 LKXIPSWD password entered link description in direct terms (actual mdisk) 0018 24 Character 8 LKXOWNRU owning userid 0020 32 Signed 2 LKXRDEVN rdevno 0022 34 Character 6 LKXVSER volume serial number 0028 40 Signed 2 LKXOWNRV owning vdevno 002A 42 Signed 2 * reserved 002C 44 Signed 4 LKXSEXT start cylinder/block of minidisk extent 0030 48 Signed 4 LKXEEXT end cylinder/block of minidisk 0034 52 Signed 4 LKXNEXT number of cylinders/blocks 0038 56 Signed 2 LKXCODE (0) (class and type together) \ 0038 56 Bitstring 1 LKXCLAS device class (=DASD) | 0039 57 Bitstring 1 LKXTYPE DASD type / 003A 58 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. 003B 59 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 003C 60 Bitstring 1 LKXAMODE link mode, directory authorization 003D 61 Bitstring 1 LKXAMODX link mode (w/ exten), dir auth 003E 62 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 003F 63 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 0040 64 Signed 4 LKXGMDSK address of MDISK with same extent 0044 68 Signed 4 LKXGVDEV address of VDEV just created or being relinked description of other links including overlapping minidisks 0048 72 Signed 4 LKXRCNT count of read links 004C 76 Signed 4 LKXWCNT count of write links 0050 80 Signed 4 LKXSCNT count of stable links 0054 84 Signed 4 LKXECNT count of exclusive links (0 or 1) 0058 88 Character 8 LKXRUSER userid of read link, if one exists 0060 96 Character 8 LKXWUSER userid of write link, if one exists 0068 104 Character 8 LKXSUSER userid of stable link, if one exists 0070 112 Character 8 LKXEUSER userid of exclusive link, if one exists 0078 120 Bitstring 1 LKXGMODE link mode 0079 121 Bitstring 1 LKXGMODX link mode extended 007A 122 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 007B 123 Bitstring 1 LKXFMTNO format number (device class) 007C 124 Bitstring 1 LKXFROM style of link: 00000000 LKXFLOG 0 - from logon (dir MDISK or LINK) 00000001 LKXFLOGQ 1 - from logon (with quiet option) 00000002 LKXFLINK 2 - from command LINK 00000003 LKXFDEF 3 - from command DEFINE MDISK 00000004 LKXFINFO 4 - from diag E4 INFO f1 DISK or SET/Q MDCACHE command 00000005 LKXFFPO2 5 - from diag E4 FPO f2 DISK 00000006 LKXFFPO3 6 - from diag E4 FPO f3 DISK 00000007 LKXFCPAC 7 - from command CPACCESS 00000008 LKXFDEFQ 8 - from command DEFINE VFB-512 00000009 LKXFDG88 9 - from Diagnose 88 special parameters for error messages 007D 125 Bitstring 1 LKXERROR LKX* error number .... ...1 LKX002 X'01' .... ..1. LKX020 X'02' .... ..11 LKX022 X'03' .... .1.. LKX024 X'04' .... .1.1 LKX026 X'05' .... .11. LKX046 X'06' .... .111 LKX052 X'07' .... 1... LKX053 X'08' .... 1..1 LKX091 X'09' ..11 .1.1 LKX091V2 X'35' .... 1.1. LKX092 X'0A' .... 1.11 LKX107 X'0B' .... 11.. LKX108 X'0C' .... 11.1 LKX109 X'0D' ..11 .1.. LKX109V2 X'34' .... 111. LKX110 X'0E' .... 1111 LKX114 X'0F' ...1 .... LKX115 X'10' ...1 ...1 LKX117 X'11' ...1 ..1. LKX118 X'12' ...1 ..11 LKX153 X'13' ...1 .1.. LKX298 X'14' ...1 .1.1 LKX844 X'15' ...1 .11. LKX6525 X'16' ...1 .111 LKX1150 X'17' ...1 1... LKX1151 X'18' ...1 1..1 LKX1152 X'19' ...1 1.1. LKX1153 X'1A' ...1 1.11 LKX1155 X'1B' ...1 11.. LKX1156 X'1C' ...1 11.1 LKX111 X'1D' ...1 111. LKX112 X'1E' ...1 1111 LKX113 X'1F' ---------- messages with counts & userids -------+ ..1. .... LKX100 X'20' base | emsg-s | ..1. ...1 LKX101 X'21' | ..1. ..1. LKX102 X'22' | ..1. ..11 LKX103 X'23' | ..1. .1.. LKX104 X'24' | ..1. .1.1 LKX105 X'25' | ..1. .11. LKX106 X'26' | imsg-s (responses) | ..1. 1.1. LKXR1 X'2A' | ..1. 1.11 LKXR2 X'2B' | ..1. 11.. LKXR3 X'2C' | ..1. 11.1 LKXR4 X'2D' | ..1. 111. LKXR5 X'2E' | ..1. 1111 LKXR6 X'2F' | ********************************* ************----+ ..11 .... LKX1157 X'30' ..11 ...1 LKX1158 X'31' ..11 ..1. LKX6761 X'32' ..11 ..11 LKX1159 X'33' ..11 .11. LKX2880 X'36' 111. .... LKXE23 X'E0' 007E 126 Signed 2 LKXERRV vdevno for some error messages link processing options 0080 128 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 0081 129 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 0082 130 Bitstring 1 LKXINMOD Input behavior modifier field 1... .... LKXNOLKS X'80' Hold no locks upon exit 0083 131 Bitstring 1 * (reserved) 0084 132 Signed 4 LKXEMSGN emsgno that was last issued 0088 136 Character 8 LKXAUSER user to perform checks for 0090 144 Character 112 LKXBUFF message data buffer 0100 256 Dbl-Word 8 LKXTOD TOD buffer for Vdisk 0108 264 Character 8 LKXACTNM Account number for Vdisk 00000022 LKXSIZE (*-LKBK+7)/8 Size, in doublewords, of LKBK
LKBK Storage Layout
*** LKBK - Minidisk LINK Block * * +-------------------------------------------------------+ * 0 | LKXITOU | * +-------------+-------------+-------------+------+------+ * 8 | LKXITOV | LKXIASV | LKXIMODC |:IMODE|:IMODX| * +-------------+-------------+-------------+------+------+ * 10 | LKXIPSWD | * +-------------------------------------------------------+ * 18 | LKXOWNRU | * +-------------+-----------------------------------------+ * 20 | LKXRDEVN | LKXVSER | * +-------------+-------------+---------------------------+ * 28 | LKXOWNRV |/////////////| LKXSEXT | * +-------------+-------------+---------------------------+ * 30 | LKXEEXT | LKXNEXT | * +------+------+------+------+------+------+------+------+ * 38 |:CLAS |:TYPE |:MFLAG|:JFLAG|:AMODE|:AMODX|:AFLAG|:HFLAG| * +------+------+------+------+------+------+------+------+ * 40 | LKXGMDSK | LKXGVDEV | * +---------------------------+---------------------------+ * 48 | LKXRCNT | LKXWCNT | * +---------------------------+---------------------------+ * 50 | LKXSCNT | LKXECNT | * +---------------------------+---------------------------+ * 58 | LKXRUSER | * +-------------------------------------------------------+ * 60 | LKXWUSER | * +-------------------------------------------------------+ * 68 | LKXSUSER | * +-------------------------------------------------------+ * 70 | LKXEUSER | * +------+------+------+------+------+------+-------------+ * 78 |:GMODE|:GMODX|:CFLAG|:FMTNO|:FROM |:ERROR| LKXERRV | * +------+------+------+------+------+------+-------------+ * 80 |:OPTS |:JOURN|:INMOD|//////| LKXEMSGN | * +------+------+------+------+---------------------------+ * 88 | LKXAUSER | * +-------------------------------------------------------+ * 90 | | * = LKXBUFF = * | | * +-------------------------------------------------------+ * 100 | LKXTOD | * +-------------------------------------------------------+ * 108 | LKXACTNM | * +-------------------------------------------------------+ * 110 * *** LKBK - Minidisk LINK Block
LKBK Cross Reference
(contains links to field and bit definitions)Symbol Dspl Value -------------- ---- -----LKXACIDN 003E 04
LKXACION 003E 02
LKXACIRO 003E 01
LKXACI2 003E 08
LKXACTNM 0108
LKXAFLAG 003E
LKXAMODE 003C
LKXAMODX 003D
LKXAUSER 0088
LKXBUFF 0090
LKXCFLAG 007A
LKXCFORC 007A 80
LKXCLAS 0038
LKXCMDCP 007A 40
LKXCODE 0038
LKXCRECC 007A 20
LKXDED 003A 40
LKXDVFP 003A 04
LKXECNT 0054
LKXEEXT 0030
LKXEMSGN 0084
LKXEND 003A 20
LKXERROR 007D
LKXERRV 007E
LKXEUSER 0070
LKXEXIST 003F 80
LKXE23 007D E0
LKXFB512 003A 02
LKXFCPAC 007C 00000007
LKXFDEF 007C 00000003
LKXFDEFQ 007C 00000008
LKXFDG88 007C 00000009
LKXFFPO2 007C 00000005
LKXFFPO3 007C 00000006
LKXFINFO 007C 00000004
LKXFLINK 007C 00000002
LKXFLOG 007C 00000000
LKXFLOGQ 007C 00000001
LKXFMTNO 007B
LKXFROM 007C
LKXGMDSK 0040
LKXGMODE 0078
LKXGMODX 0079
LKXGVDEV 0044
LKXHFLAG 003F
LKXIASV 000A
LKXIMODC 000C
LKXIMODE 000E
LKXIMODX 000F
LKXINMOD 0082
LKXIPSWD 0010
LKXITOU 0000
LKXITOV 0008
LKXJCNA 003B 40
LKXJDCTL 003B 10
LKXJFLAG 003B
LKXJNCTL 003B 08
LKXJNMDC 003B 04
LKXJOURN 0081
LKXJQDSK 003B 02
LKXJSCTL 003B 20
LKXJYMDC 003B 01
LKXMFLAG 003A
LKXNEXT 0034
LKXNJOUR 0081 40
LKXNOASN 003A 08
LKXNOLKS 0082 80
LKXNOMSG 0080 80
LKXNOPWD 0080 40
LKXOPTS 0080
LKXOVLAP 003F 20
LKXOWNRU 0018
LKXOWNRV 0028
LKXPWALL 0081 80
LKXPWDRQ 0080 20
LKXPWMOD 0080 10
LKXQDLOK 003F 10
LKXRCNT 0048
LKXRDEVN 0020
LKXRELIN 003F 40
LKXRUSER 0058
LKXR1 007D 2A
LKXR2 007D 2B
LKXR3 007D 2C
LKXR4 007D 2D
LKXR5 007D 2E
LKXR6 007D 2F
LKXSCNT 0050
LKXSELFL 0081 20
LKXSEXT 002C
LKXSIZE 0108 00000022
LKXSUSER 0068
LKXTDISK 003A 80
LKXTOD 0100
LKXTYPE 0039
LKXV 003A 10
LKXVSER 0022
LKXWCNT 004C
LKXWRKAL 003A 01
LKXWUSER 0060
LKX002 007D 01
LKX020 007D 02
LKX022 007D 03
LKX024 007D 04
LKX026 007D 05
LKX046 007D 06
LKX052 007D 07
LKX053 007D 08
LKX091 007D 09
LKX091V2 007D 35
LKX092 007D 0A
LKX100 007D 20
LKX101 007D 21
LKX102 007D 22
LKX103 007D 23
LKX104 007D 24
LKX105 007D 25
LKX106 007D 26
LKX107 007D 0B
LKX108 007D 0C
LKX109 007D 0D
LKX109V2 007D 34
LKX110 007D 0E
LKX111 007D 1D
LKX112 007D 1E
LKX113 007D 1F
LKX114 007D 0F
LKX115 007D 10
LKX1150 007D 17
LKX1151 007D 18
LKX1152 007D 19
LKX1153 007D 1A
LKX1155 007D 1B
LKX1156 007D 1C
LKX1157 007D 30
LKX1158 007D 31
LKX1159 007D 33
LKX117 007D 11
LKX118 007D 12
LKX153 007D 13
LKX2880 007D 36
LKX298 007D 14
LKX6525 007D 16
LKX6761 007D 32
LKX844 007D 15
Last updated on 3 Aug 1999 at 12:10:29 EDT.
Copyright IBM Corporation, 1990, 1999