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

#### DGSBK

Prolog

Control Block Contents
DGSBK DSECT

Storage Layout

Cross Reference (Contains links to field and bit definitions)

#### DGSBK Prolog

     Name       : HCPDGSBK
     Description: Directory generic string block
     DSECT      : DGSBK
     Function   : The directory generic string block contains a
                  character string created by a directory
                  statement processed by HCPDIR.
     Located by : On DASD - DVMDWDAD/DVMDWDSP fields of HCPDVMD
                  DVMDUDAD/DVMDUDSP fields of HCPDVMD
                  DVMDRDAD/DVMDRDSP fields of HCPDVMD
                  In storage - DVMDWDAD field of HCPDVMD
                  DVMDUDAD field of HCPDVMD
                  DVMDRDAD field of HCPDVMD
     Created by : HCPDIR
                  HCPUDPRD
     Deleted by : HCPLGBFR
                  HCPLGNUS
                  HCPPXIQD
                  HCPUDPRD
     Comments   : This block is used to contain various
                  string (text) fields in the object directory.
                  The DGSLABEL field identifies which string a
                  specific instance of this block contains.
                  An "in-storage" copy of this block may contain
                  data from the online directory or an ESM.

#### DGSBK Control Block Content

#### DGSBK DSECT

    Hex   Dec Type/Val   Lng Label (dup)    Comments
    ---- ---- --------- ---- -------------- --------
    0000    0 Structure      DGSBK          Directory generic string block
    0000    0 Signed       4 DGSBKLEN       DGSBK block size in bytes
    0004    4 Character    3 DGSLABEL       Label to validate this block. It
                                            is also used to identify the
                                            variable-length string starting
                                            at DGSTRING
    0007    7 Bitstring    1 DGSVERS        Version code for this block
              00000000       DGSVERS0       X'00' DGSVERS0 Initial version
              00000008       DGSHDRBS       (*-DGSBK) Size of fixed-length
                                            portion of the DGSBK, in bytes
    0008    8 Character    1 DGSTRING (0)   Start of variable-length string.
                                            It will contain a 1- to
                                            DGSMSIWD/DGSMSIUP/DGSMSFSR/
                                            DGSMSCOM-byte character string
                 The following two fields are relevant only for
                 COMMAND GSDBKs
    0008    8 Address      1 DGSTRLEN       Command string length
    0009    9 Character  220 DGSTRCMD (0)   Command string
              000003FF       DGSMSIWD       1023 Maximum allowed length of
                                            IWDIR
              000003FF       DGSMSIUP       1023 Maximum allowed length of
                                            IUPGM
              000003FF       DGSMSFSR       1023 Maximum allowed length of
                                            FSROOT
              00000BFF       DGSMSCOM       3071 Maximum COMMAND DGSBK length
              00000407       DGSMBIWD       (DGSHDRBS+DGSMSIWD) Maximum IWDIR
                                            DGSBK block size, in bytes
              00000407       DGSMBIUP       (DGSHDRBS+DGSMSIUP) Maximum IUPGM
                                            DGSBK block size, in bytes
              00000407       DGSMBFSR       (DGSHDRBS+DGSMSFSR) Maximum
                                            FSROOT DGSBK block size, in bytes
              00000C07       DGSMBCOM       (DGSHDRBS+DGSMSCOM) Maximum
                                            COMMAND DGSBK length
         **** THE VALUE OF FSMAXB FOR DATAMAP IS 4072
              00000FE8       DGSMB          FSMAXB Maximum DGSBK block size,
                                            in bytes
              00000FE0       DGSMS          (DGSMB-DGSHDRBS) Maximum length
                                            of DGSTRING

#### DGSBK Storage Layout

    *** DGSBK - Directory generic string block
    *
    *     +---------------------------+--------------------+------+
    *   0 |         DGSBKLEN          |     DGSLABEL       |:VERS |
    *     +------+--------------------+--------------------+------+
    *   8 |:TRLEN|
    *     +------+
    *
    *** DGSBK - Directory generic string block

#### DGSBK Cross Reference

    Symbol         Dspl Value
    -------------- ---- -----
    DGSBKLEN       0000
    DGSHDRBS       0007 00000008
    DGSLABEL       0004
    DGSMB          0009 00000FE8
    DGSMBCOM       0009 00000C07
    DGSMBFSR       0009 00000407
    DGSMBIUP       0009 00000407
    DGSMBIWD       0009 00000407
    DGSMS          0009 00000FE0
    DGSMSCOM       0009 00000BFF
    DGSMSFSR       0009 000003FF
    DGSMSIUP       0009 000003FF
    DGSMSIWD       0009 000003FF
    DGSTRCMD       0009
    DGSTRING       0008
    DGSTRLEN       0008
    DGSVERS        0007
    DGSVERS0       0007 00000000

This information is based on z/VM V6R1.0. Last updated on 18 Feb 2010 at 08:35:17 EDT.
Copyright IBM Corporation, 1990, 2008