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

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
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
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
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
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'
          0000000*       *              with counts & userids follow
          00000000       *
          00000020       LKX100         X'20' base
          0000000*       *
          00000000       *
          00000021       LKX101         X'21'
          00000022       LKX102         X'22'
          00000023       LKX103         X'23'
          00000024       LKX104         X'24'
          00000025       LKX105         X'25'
          00000026       LKX106         X'26'
          0000000*       *              (responses)
          00000000       *
          0000002A       LKXR1          X'2A'
          0000002B       LKXR2          X'2B'
          0000002C       LKXR3          X'2C'
          0000002D       LKXR4          X'2D'
          0000002E       LKXR5          X'2E'
          0000002F       LKXR6          X'2F'
          0000000*       *              of messages with counts & userids
          00000000       *
          00000030       LKX1157        X'30'
          00000031       LKX1158        X'31'
          00000032       LKX6761        X'32'
          00000033       LKX1159        X'33'
          00000036       LKX2880        X'36'
          000000E0       LKXE23         X'E0'
          00000000       *
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
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
-------------- ---- -----
*              007D 0000000*
*              007D 00000000
*              007D 0000000*
*              007D 00000000
*              007D 0000000*
*              007D 00000000
*              007D 0000000*
*              007D 00000000
*              007D 00000000
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 V3R1.0.
Last updated on 29 Mar 2001 at 16:03:04 EDT.
Copyright IBM Corporation, 1990, 2001