DGFBK - 32-bit CP - V4R4.0

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

#### DGFBK

Prolog

Control Block Contents
DGFBK DSECT

Storage Layout

Cross Reference (Contains links to field and bit definitions)

#### DGFBK Prolog

     Name       : HCPDGFBK
     Description: Directory FCP IPL block
     DSECT      : DGFBK
     Function   : The directory FCP IPL block contains the values
                  processed from the LOADDEV directory statements.
     Located by : On DASD - DVMGFDAD/DVMGFDSP fields of HCPDVMD
     Created by : HCPDIR
     Comments   : This block is used to contain the FCP
                  LOADDEV fields in the object directory

#### DGFBK Control Block Content

#### DGFBK DSECT

    Hex   Dec Type/Val   Lng Label (dup)    Comments
    ---- ---- --------- ---- -------------- --------
    0000    0 Structure      DGFBK          Directory FCP IPL block
    0000    0 Character    8 DGFEYEC        Eye catcher
    0008    8 Signed       4 DGFLEN         Length of HCPDGFBK
    000C   12 Bitstring    1 DGFVER         Version level of HCPDGFBK
              .... ....      DGFVER0        X'00' Version 0
    000D   13 Bitstring    3 *              Reserved
    0010   16 Signed       4 DGFNXTDA       Next DGFBK ptr if multiple sets
                                            CCPV for CKD DASD addresses PPPV
                                            for FBA DASD addresses
    0014   20 Signed       2 DGFNXTDS       Next DGFBK disk displacement from
                                            above
    0016   22 Signed       2 *              Reserved
    0018   24 Signed       4 DGFSEQ         Sequence num for this extra DGFBK
    001C   28 Signed       4 *              Reserved
    0020   32 Dbl-Word     8 DGFPTNM (0)    Port name
    0020   32 Signed       4 DGFPTNM1       Port name 1
    0024   36 Signed       4 DGFPTNM2       Port name 2
    0028   40 Dbl-Word     8 DGFLUN (0)     LUN information
    0028   40 Signed       4 DGFLUNW1       LUN ID word 1
    002C   44 Signed       4 DGFLUNW2       LUN ID word 2
    0030   48 Dbl-Word     8 DGFBRLB (0)    Boot record logical block address
    0030   48 Signed       4 DGFBRLW1       Boot record LBA part 1
    0034   52 Signed       4 DGFBRLW2       Boot record LBA part 2
    0038   56 Signed       4 *              Reserved
    003C   60 Signed       2 *              Reserved
    003E   62 Signed       2 *              Reserved
    0040   64 Signed       4 *              Reserved
    0044   68 Signed       4 *              Reserved
    0048   72 Signed       4 DGFSCPDA       SCPDATA address CCPV for CKD DASD
                                            addresses PPPV for FBA DASD
                                            addresses
    004C   76 Signed       2 DGFSCDSP       SCPDATA disk displacement
    004E   78 Signed       2 *              Reserved
    0050   80 Signed       4 DGFSCPDL       Length of SCPDATA
    0054   84 Signed       4 DGFSCPDU       Length of SCPDATA (UTF8)
    0058   88 Signed       4 DGFBOOT        BOOTprog value
    005C   92 Bitstring    1 DGFPCFLG       LOADDEV statement flags
              1... ....      DGFPNSET       X'80' PORTNAME specified
              ...1 ....      DGFBLSET       X'10' BR_LBA specified
              .... 1...      DGFLNSET       X'08' LUN specified
              .... .1..      DGFBOSET       X'04' BOOTprog specified
              .... ..1.      DGFSCSET       X'02' SCPDATA specified
    005D   93 Bitstring    1 DGFOPTSF       DGFBK keyword types
              .1.. ....      DGFSCPHX       X'40' SCPDATA is in UTF8 hex
                                            chars
    005E   94 Bitstring    2 *              Reserved for future IBM use
    0060   96 Dbl-Word     8 *              Reserved for future IBM use
              0000000D       DGFSIZE        (*-DGFBK+7)/8 DGFBK size in DW's
              00000068       DGFBSIZ        *-DGFBK DGFBK size in bytes

#### DGFBK Storage Layout

    *** DGFBK - Directory FCP IPL block
    *
    *     +-------------------------------------------------------+
    *   0 |                       DGFEYEC                         |
    *     +---------------------------+------+--------------------+
    *   8 |          DGFLEN           |DGFVER|////////////////////|
    *     +---------------------------+------+------+-------------+
    *  10 |         DGFNXTDA          |  DGFNXTDS   |/////////////|
    *     +---------------------------+-------------+-------------+
    *  18 |          DGFSEQ           |///////////////////////////|
    *     +---------------------------+---------------------------+
    *  20 |         DGFPTNM1          |         DGFPTNM2          |
    *     +---------------------------+---------------------------+
    *  28 |         DGFLUNW1          |         DGFLUNW2          |
    *     +---------------------------+---------------------------+
    *  30 |         DGFBRLW1          |         DGFBRLW2          |
    *     +---------------------------+-------------+-------------+
    *  38 |///////////////////////////|/////////////|/////////////|
    *     +---------------------------+-------------+-------------+
    *  40 |///////////////////////////|///////////////////////////|
    *     +---------------------------+-------------+-------------+
    *  48 |         DGFSCPDA          |  DGFSCDSP   |/////////////|
    *     +---------------------------+-------------+-------------+
    *  50 |         DGFSCPDL          |         DGFSCPDU          |
    *     +---------------------------+------+------+-------------+
    *  58 |         DGFBOOT           |:PCFLG|:OPTSF|/////////////|
    *     +---------------------------+------+------+-------------+
    *  60 |///////////////////////////////////////////////////////|
    *     +-------------------------------------------------------+
    *  68
    *
    *** DGFBK - Directory FCP IPL block

#### DGFBK Cross Reference

    Symbol         Dspl Value
    -------------- ---- -----
    DGFBLSET       005C 10
    DGFBOOT        0058
    DGFBOSET       005C 04
    DGFBRLB        0030
    DGFBRLW1       0030
    DGFBRLW2       0034
    DGFBSIZ        0060 00000068
    DGFEYEC        0000
    DGFLEN         0008
    DGFLNSET       005C 08
    DGFLUN         0028
    DGFLUNW1       0028
    DGFLUNW2       002C
    DGFNXTDA       0010
    DGFNXTDS       0014
    DGFOPTSF       005D
    DGFPCFLG       005C
    DGFPNSET       005C 80
    DGFPTNM        0020
    DGFPTNM1       0020
    DGFPTNM2       0024
    DGFSCDSP       004C
    DGFSCPDA       0048
    DGFSCPDL       0050
    DGFSCPDU       0054
    DGFSCPHX       005D 40
    DGFSCSET       005C 02
    DGFSEQ         0018
    DGFSIZE        0060 0000000D
    DGFVER         000C
    DGFVER0        000C 00

This information is based on z/VM V4R4.0. Last updated on 29 Jul 2003 at 15:27:02 EDT.
Copyright IBM Corporation, 1990, 2003