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

DIDBK

Prolog  

Control Block Contents  
   DIDBK DSECT
   DIDENTRY DSECT

Storage Layout  

Cross Reference (Contains links to field and bit definitions)  


DIDBK Prolog

 NAME       : HCPDIDBK
 DESCRIPTION: Directory Identity Virtual Machine Block
 DSECT      : DIDBK
 FUNCTION   : The DIDBK maps the IDENTITY userid to the
              SUBCONFIG and system specified on a BUILD
              statement.
 LOCATED BY : DVMDDDAD/DVMDDDSP
 CREATED BY : HCPDIR, HCPUDP, HCPUDR
 DELETED BY : HCPACO, HCPACT, HCPCFX, HCPCSL, HCPCSP,
              HCPDST, HCPFIT, HCPIUJ, HCPLNS, HCPNSW,
              HCPPCL, HCPPXD, HCPPXJ, HCPPXL, HCPPXQ,
              HCPRPE, HCPSCO, HCPSFV, HCPSRM, HCPUDP,
              HCPUDR, HCPVDG, HCPYJT
 SERIALIZED : The directory lock(SYSDRLOK) must be
              obtained in exclusive mode to write/change
              the directory and in shared mode to read the
              directory.
 RELOCATION CONSIDERATIONS : None
 COMPATIBILITY AND MIGRATION CONCERNS : The DIDBK is part of the object directory on dasd.
              When modifying this control block, the displacements of
              existing fields should NEVER change.  Object directory
              compatibility must be maintained when modifying this
              control block.
              The current version of this control block - DHDRCBV0.
              See DCBTABLE in HCPDIR and HCPDHDR COPY for variables
              used to describe this control block to CP and DIRMAINT.
              The contents of DIDTABLE beyond the last in use entry
              as indicated by DIDCOUNT are unpredictable.

 

DIDBK Control Block Content


DIDBK DSECT

Hex   Dec Type/Val   Lng Label (dup)    Comments
---- ---- --------- ---- -------------- --------
0000    0 Structure      DIDBK          Directory Identity Virtual Machine Block
0000    0 Dbl-Word     8 * (0)
0000    0 Bitstring   32 DIDHDR (0)     Fixed Length Header
0000    0 Bitstring   16 DIDLABL        'IDENTITY INDEX '
0010   16 Character    8 DIDUSER        Userid from the IDENTITY stmt
0018   24 Signed       2 DIDCOUNT       Number of entries for this IDENT
001A   26 Signed       2 DIDELEN        DIDTABLE entry length
001C   28 Signed       2 DIDHLEN        Header length (bytes)
001E   30 Signed       2 *              Reserved for IBM use
          00000020       DIDHDRSZ       *-DIDHDR DIDBK header size in
                                        bytes
0020   32 Dbl-Word     8 * (0)
0020   32 Bitstring  512 DIDTABLE       Directory Identity table 32
                                        entries x 16 bytes each
          00000044       DIDDSIZE       (*-DIDBK+7)/8 Size in double
                                        words
          00000220       DIDBSIZE       *-DIDBK Size in bytes

DIDENTRY DSECT

Hex   Dec Type/Val   Lng Label (dup)    Comments
---- ---- --------- ---- -------------- --------
0000    0 Structure      DIDENTRY       Directory Identity Virtual Machine Block
0000    0 Character    8 DIDSUB         ID from the SUBCONFIG stmt
0008    8 Character    8 DIDSYS         System name from the BUILD stmt
          00000010       DIDESIZE       *-DIDENTRY DIDENTRY size in bytes

 

DIDBK Storage Layout

          
*** DIDBK - Directory Identity Virtual Machine Block
*
*     +-------------------------------------------------------+
*   0 |                       DIDLABL                         |
*     |                                                       |
*     +-------------------------------------------------------+
*  10 |                       DIDUSER                         |
*     +-------------+-------------+-------------+-------------+
*  18 |  DIDCOUNT   |  DIDELEN    |  DIDHLEN    |/////////////|
*     +-------------+-------------+-------------+-------------+
*  20 |                                                       |
*     =                       DIDTABLE                        =
*     |                                                       |
*     +-------------------------------------------------------+
* 220
*
*** DIDBK - Directory Identity Virtual Machine Block
          
*** DIDENTRY - Directory Identity Virtual Machine Block
*
*     +-------------------------------------------------------+
*   0 |                        DIDSUB                         |
*     +-------------------------------------------------------+
*   8 |                        DIDSYS                         |
*     +-------------------------------------------------------+
*  10
*
*** DIDENTRY - Directory Identity Virtual Machine Block

 

DIDBK Cross Reference

Symbol         Dspl Value
-------------- ---- -----
DIDBSIZE       0020 00000220
DIDCOUNT       0018
DIDDSIZE       0020 00000044
DIDELEN        001A
DIDESIZE       0008 00000010
DIDHDR         0000
DIDHDRSZ       001E 00000020
DIDHLEN        001C
DIDLABL        0000
DIDSUB         0000
DIDSYS         0008
DIDTABLE       0020
DIDUSER        0010

This information is based on z/VM V6R2.0. Last updated on 21 Nov 2011 at 10:59:21 EDT.
Copyright IBM Corporation, 1990, 2011