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 V6R1.0. Last updated on 18 Feb 2010 at 08:48:08 EDT.
Copyright IBM Corporation, 1990, 2008