DALBK

Prolog  

Control Block Contents  
   DALBK DSECT

Storage Layout  

Cross Reference (Contains links to field and bit definitions)  

DALBK Prolog

 NAME       : HCPDALBK
 DESCRIPTION: Dumped Access List Block
 DSECT      : DALBK
 FUNCTION   : Contains Dump information for access lists
 LOCATED BY : DFMDALBK
 CREATED BY : This control block is used to map 4K record(s)
              in dumps.  HCPVMYAL uses this control block
              when putting the access list information into
              the 4K records for VMDUMPs.
              HCPDMP (Hard ABEND dumps and snapdumps dumps),
              HCPABF (Soft Abend dumps) and
              HCPSAD (StandAlone dumps) use this
              control block when building a dummy DALBK.
 DELETED BY : Not applicable
 RELOCATION CONSIDERATIONS : None
 COMMENTS   : DALPAGCT is the number of access list
              entries that a one page DALBK can map.
              If DALVALID is greater than DALPAGCT, then
              when the dump viewing facility has processed
              DALPAGCT entries it must read the next 4K page
              and base the DALBK at that page.  DALENTRY(1)
              on the first DALBK will be the first valid or
              revoked access list entry.  DALENTRY(1) on
              the second DALBK will be the (DALPAGCT+1)th
              valid or revoked access list entry.
              DALENTRY(1) on the third DALBK will be the
              (2*DALPAGCT + 1)th valid or revoked access
              list entry and so on.
              The fields DALVALID and DALINVLD will be set
              in the first and last DALBK.
              VM Dump Tool does not use any information in
              this control block.

DALBK Control Block Content

DALBK DSECT

Hex   Dec Type/Val   Lng Label (dup)    Comments
---- ---- --------- ---- -------------- --------
0000    0 Structure      DALBK          Dumped Access List Block
0000    0 Character    8 DALBKID        Identification string
0008    8 Signed       2 DALVALID       No. of valid/revoked entries
000A   10 Signed       2 DALINVLD       Number of invalid entries
          0000000C       DALMLEN        *-DALBK Length of Main section
      Repeatable section follows - re-used depending upon the
       number of entries.
000C   12 Signed       2 DALENTRY (0)
000C   12 Character    8 DALASIT        eASIT
0014   20 Signed       4 DALALET        ALET
0018   24 Character   33 DALSPCID       Space id in string form
0039   57 Character    2 *              Reserved for IBM use
003B   59 Bitstring    1 DALSTATE       State of access list entry
          1... ....      DALREVKD       X'80' DALREVKD Entry-is-revoked
                                        bit
          .1.. ....      DALREADO       X'40' DALREADO Access is
                                        Read/only. If not on, then access
                                        is Read/Write
          ..1. ....      DALPAGEX       X'20' DALPAGEX Access is pagex
          00000030       DALENTLN       *-DALASIT Length of each entry
          00000008       DALSIZE        (*-DALBK+7)/8 Size in double
                                        words
      DALPAGCT will contain the number of access list entries
       that a one page DALBK can map
          00000055       DALPAGCT       (4096-DALMLEN)/DALENTLN

DALBK Storage Layout

          
*** DALBK - Dumped Access List Block
*
*     +-------------------------------------------------------+
*   0 |                       DALBKID                         |
*     +-------------+-------------+---------------------------+
*   8 |  DALVALID   |  DALINVLD   |         DALASIT-          |
*     +-------------+-------------+---------------------------+
*  10 |          -(00C)           |         DALALET           |
*     +---------------------------+---------------------------+
*  18 |                                                       |
*     =                       DALSPCID                        =
*     |      +-------------+------+---------------------------+
*  38 |      |/////////////|:STATE| 3C
*     +------+-------------+------+
*
*** DALBK - Dumped Access List Block

DALBK Cross Reference

Symbol         Dspl Value
-------------- ---- -----
DALALET        0014
DALASIT        000C
DALBKID        0000
DALENTLN       003B 00000030
DALENTRY       000C
DALINVLD       000A
DALMLEN        000A 0000000C
DALPAGCT       003B 00000055
DALPAGEX       003B 20
DALREADO       003B 40
DALREVKD       003B 80
DALSIZE        003B 00000008
DALSPCID       0018
DALSTATE       003B
DALVALID       0008