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