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' - 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.
    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' - 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
    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' - R/W request downgraded to
                                            R/O
              .1.. ....      LKXCMDCP       X'40' - MDC prohibited
              ..1. ....      LKXCRECC       X'20' - MDC record cache
                                            requested miscellanea
    0093  147 Bitstring    1 LKXFMTNO       format number (device class)
    0094  148 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
    0095  149 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'
    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' - 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
    0099  153 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
    009A  154 Bitstring    1 LKXINMOD       Input behavior modifier field
              1... ....      LKXNOLKS       X'80' Hold no locks upon exit
    009B  155 Bitstring    1 LKXGFLGS       General link flags
              1... ....      LKXQMDIS       X'80' Diag E4 function called via
                                            Q Mdisk
    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
    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
    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
    LKX844         0095 00000015

This information is based on z/VM V5R2.0. Last updated on 12 Apr 2006 at 17:02:25 EDT.
Copyright IBM Corporation, 1990, 2005