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

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.  HCPVMXCD uses this control block when
              putting the access list information into the 4K
              records for VMDUMPs.  HCPDMP uses this control block
              when putting the access list information into the 4K
              records for Hard ABEND dumps and Non-Destructive
              dumps, and HCPSAD uses this block for S/A Dumps.
 DELETED BY : Not applicable
 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.

 

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' Entry-is-revoked bit
          .1.. ....      DALREADO       X'40' Access is Read/only. If not
                                        on, then access is Read/Write
          ..1. ....      DALPAGEX       X'20' 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

This information is based on z/VM V4R1.0.
Last updated on 5 Jun 2001 at 13:13:54 EDT.
Copyright IBM Corporation, 1990, 2001