|
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 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:
.... .... 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
007D 125 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'
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 LKXGFLGS General link flags
1... .... LKXQMDIS X'80' Diag E4 function called via
Q Mdisk
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|:GFLGS| LKXEMSGN |
* +------+------+------+------+---------------------------+
* 88 | LKXAUSER |
* +-------------------------------------------------------+
* 90 | |
* = LKXBUFF =
* | |
* +-------------------------------------------------------+
* 100 | LKXTOD |
* +-------------------------------------------------------+
* 108 | LKXACTNM |
* +-------------------------------------------------------+
* 110
*
*** LKBK - Minidisk LINK Block
LKBK Cross Reference
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 000000E0 LKXFB512 003A 02 LKXFCPAC 007C 07 LKXFDEF 007C 03 LKXFDEFQ 007C 08 LKXFDG88 007C 09 LKXFFPO2 007C 05 LKXFFPO3 007C 06 LKXFINFO 007C 04 LKXFLINK 007C 02 LKXFLOG 007C 00 LKXFLOGQ 007C 01 LKXFMTNO 007B LKXFROM 007C LKXGFLGS 0083 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 LKXQMDIS 0083 80 LKXRCNT 0048 LKXRDEVN 0020 LKXRELIN 003F 40 LKXRUSER 0058 LKXR1 007D 0000002A LKXR2 007D 0000002B LKXR3 007D 0000002C LKXR4 007D 0000002D LKXR5 007D 0000002E LKXR6 007D 0000002F 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 00000001 LKX020 007D 00000002 LKX022 007D 00000003 LKX024 007D 00000004 LKX026 007D 00000005 LKX046 007D 00000006 LKX052 007D 00000007 LKX053 007D 00000008 LKX091 007D 00000009 LKX091V2 007D 00000035 LKX092 007D 0000000A LKX100 007D 00000020 LKX101 007D 00000021 LKX102 007D 00000022 LKX103 007D 00000023 LKX104 007D 00000024 LKX105 007D 00000025 LKX106 007D 00000026 LKX107 007D 0000000B LKX108 007D 0000000C LKX109 007D 0000000D LKX109V2 007D 00000034 LKX110 007D 0000000E LKX111 007D 0000001D LKX112 007D 0000001E LKX113 007D 0000001F LKX114 007D 0000000F LKX115 007D 00000010 LKX1150 007D 00000017 LKX1151 007D 00000018 LKX1152 007D 00000019 LKX1153 007D 0000001A LKX1155 007D 0000001B LKX1156 007D 0000001C LKX1157 007D 00000030 LKX1158 007D 00000031 LKX1159 007D 00000033 LKX117 007D 00000011 LKX118 007D 00000012 LKX153 007D 00000013 LKX2880 007D 00000036 LKX298 007D 00000014 LKX6525 007D 00000016 LKX6761 007D 00000032 LKX844 007D 00000015
Copyright IBM Corporation, 1990, 2001