Programming Interface Information:
This information is NOT intended to be
used as Programming Interfaces of z/VM.

LKBK

Prolog  

Control Block Contents  
   LKBK DSECT

Storage Layout  

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' 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 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
                                        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 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
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
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
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
LKXPAVAL       009B 40
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
LKX6867        0095 00000037
LKX6867H       0095 00000038
LKX844         0095 00000015

This information is based on z/VM V5R4.0. Last updated on 18 Feb 2010 at 03:50:07 EDT.
Copyright IBM Corporation, 1990, 2009