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.  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
     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

This information is based on z/VM V6R1.0. Last updated on 18 Feb 2010 at 08:31:47 EDT.
Copyright IBM Corporation, 1990, 2008