DGFBK Back to Index page
 
Prolog 
Control Block Contents 
   DGFBK DSECT
Storage Layout 
Cross Reference (Contains links to field and bit definitions)
Programming Interface Information:
This information is NOT intended to be
used as Programming Interfaces of z/VM.


  DGFBK Prolog Top of page
  
 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
 RELOCATION CONSIDERATIONS : None
 COMMENTS   : This block is used to contain the FCP
              LOADDEV         fields in the object directory
 
 
  DGFBK Control Block Content Top of page
  




 DGFBK DSECT
Top of page


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' DGFVER0 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 DGFDEV         IPL device number
003E   62 Signed       2 *              Reserved
0040   64 Address      1 DGFALTCT       Number of alternate device
                                        numbers
0041   65 Address      1 *              Next alternate device number
                                        index
0042   66 Bitstring    6 DGFALTDV       Alternate device numbers
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.. ....      DGFBTSET       X'40' BOOTREC specified
          ..1. ....      DGFALSET       X'20' ALTERNATE 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
          .... ...1      DGFSISET       X'01' Secure IPL specified
005D   93 Bitstring    1 DGFOPTSF       DGFBK keyword types
          .1.. ....      DGFSCPHX       X'40' DGFSCPHX SCPDATA is in UTF8
                                        hex chars
005E   94 Bitstring    1 DGFPFLG2       More LOADDEV statement flags
          1... ....      DGFSCSI        X'80' DGFSCSI SCSI device
                                        operands set
          .1.. ....      DGFECKD        X'40' DGFECKD ECKD device
                                        operands set
          ..1. ....      DGFDVSET       X'20' DGFDVSET Device number has
                                        been set
          ...1 ....      DGFBTRLB       X'10' DGFBTRLB BOOTREC=LABEL was
                                        specified
          .... 1...      DGFBPAUT       X'08' DGFBPAUT BOOTPROG set to
                                        AUTOmatic
          .... .1..      DGFNSIST       X'04' DGFNSIST NOSECURE was
                                        specified
005F   95 Bitstring    1 *              Reserved for future IBM use
0060   96 Signed       4 DGFBTCYL       Boot record cylinder
0064  100 Signed       1 DGFBTHD        Boot record head (track)
0065  101 Signed       1 DGFBTREC       Boot record record number
0066  102 Bitstring    2 *              Reserved for future IBM use
      Whenever the DGFBK is extended to add one or more
      fields for a release, compatibility must be maintained
      between old versions of the object DGFBK and the new
      CP DGFBK.  When customers are running with an old
      DIRECTXA, the object DGFBK created may be smaller than
      the new CP DGFBK.  Whenever new fields are created
      that have non-zero default values, the code in HCPUDM
      must be updated to recognize this case and initialize
      the new fields to their non-zero default values.  No
      updates are necessary to HCPUDM for fields that have
      zero default values.
          00000068       DGFOSIZE       *-DGFBK DGFBK original size
0068  104 Bitstring   24 DGFALTPN       Alternate port names
          00000080       DGFSSIZE       *-DGFBK DGFBK size with alternate
                                        paths
          00000010       DGFSIZE        (*-DGFBK+7)/8 DGFBK size in DW's
          00000080       DGFBSIZ        *-DGFBK DGFBK size in bytes
 
 
  DGFBK Storage Layout Top of page
  
          
*** 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 |///////////////////////////|   DGFDEV    |/////////////|
*     +------+------+-------------+-------------+-------------+
*  40 |:ALTCT|//////|                DGFALTDV                 |
*     +------+------+-------------+-------------+-------------+
*  48 |         DGFSCPDA          |  DGFSCDSP   |/////////////|
*     +---------------------------+-------------+-------------+
*  50 |         DGFSCPDL          |         DGFSCPDU          |
*     +---------------------------+------+------+------+------+
*  58 |         DGFBOOT           |:PCFLG|:OPTSF|:PFLG2|//////|
*     +---------------------------+------+------+------+------+
*  60 |         DGFBTCYL          |:BTHD |:BTREC|/////////////|
*     +---------------------------+------+------+-------------+
*  68 |                                                       |
*     =                       DGFALTPN                        =
*     |                                                       |
*     +-------------------------------------------------------+
*  80
*
*** DGFBK - Directory FCP IPL block
 
 
  DGFBK Cross Reference Top of page
  
 
Symbol         Dspl Value
-------------- ---- -----
DGFALSET       005C 20
DGFALTCT       0040
DGFALTDV       0042
DGFALTPN       0068
DGFBLSET       005C 10
DGFBOOT        0058
DGFBOSET       005C 04
DGFBPAUT       005E 08
DGFBRLB        0030
DGFBRLW1       0030
DGFBRLW2       0034
DGFBSIZ        0068 00000080
DGFBTCYL       0060
DGFBTHD        0064
DGFBTREC       0065
DGFBTRLB       005E 10
DGFBTSET       005C 40
DGFDEV         003C
DGFDVSET       005E 20
DGFECKD        005E 40
DGFEYEC        0000
DGFLEN         0008
DGFLNSET       005C 08
DGFLUN         0028
DGFLUNW1       0028
DGFLUNW2       002C
DGFNSIST       005E 04
DGFNXTDA       0010
DGFNXTDS       0014
DGFOPTSF       005D
DGFOSIZE       0066 00000068
DGFPCFLG       005C
DGFPFLG2       005E
DGFPNSET       005C 80
DGFPTNM        0020
DGFPTNM1       0020
DGFPTNM2       0024
DGFSCDSP       004C
DGFSCPDA       0048
DGFSCPDL       0050
DGFSCPDU       0054
DGFSCPHX       005D 40
DGFSCSET       005C 02
DGFSCSI        005E 80
DGFSEQ         0018
DGFSISET       005C 01
DGFSIZE        0068 00000010
DGFSSIZE       0068 00000080
DGFVER         000C
DGFVER0        000C 00
 
This information is based on z/VM 7.4.0 Last updated on 24 Jun 2024 at 11:30:07 EDT.
Copyright IBM Corporation, 1990, 2024