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
     COPYRIGHT -
                  THIS MODULE IS "RESTRICTED MATERIALS OF IBM"
                  5739-A03 (C) COPYRIGHT IBM CORP. - 1990, 2001
                  LICENSED MATERIALS - PROPERTY OF IBM
     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

This information is based on z/VM V4R3.0. Last updated on 30 Apr 2002 at 16:49:05 EDT.
Copyright IBM Corporation, 1990, 2002