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

#### DSIBK

Prolog

Control Block Contents
DSIBK DSECT

Storage Layout

Cross Reference (Contains links to field and bit definitions)

#### DSIBK Prolog

     NAME       : HCPDSIBK
     DESCRIPTION: Dump Space Information Area
     DSECT      : DSIBK
     FUNCTION   : The DSIBK resides in host permanent storage and is
                  used to contain the dump space allocation CALBK,
                  size information and the channel program construction
                  area for CP system abend dump processing
     LOCATED BY : SYSDSIBK IN HCPSYSCM
     CREATED BY : SYSTEM DEFINITION
     DELETED BY : NOT DELETED
     SERIALIZED : The Dump Space Allocation Lock contained
                  within this data area.
     COMMENTS   : DSIDPACP is the threshold value used to
                  communicate to the storage management subroutine
                  the number of CP-owned pages in the Dynamic Paging
                  Area plus 12.5 percent of the amount calculated
                  for a CP-only system abend dump or a V=R system
                  abend dump.

#### DSIBK Control Block Content

#### DSIBK DSECT

    Hex   Dec Type/Val   Lng Label (dup)    Comments
    ---- ---- --------- ---- -------------- --------
    0000    0 Structure      DSIBK          Dump Space Information Area
    0000    0 Dbl-Word     8 DSILOCK (3)    Dump Space Allocation Lock
         The following fields are for additional cluster allocation, when
         needed.
    0018   24 Signed       4 DSIDPACP       Threshold value for CP-owned
                                            pages in the Dynamic Paging Area.
                                            NOTE: When the value in this
                                            field is X'FFFFFFFF' no
                                            additional DASD dump space is to
                                            be obtained.
    001C   28 Signed       4 DSITRPGS       Total real storage pages (number
                                            for
    0020   32 Signed       4 DSITAPGS       Total DASD pages currently
                                            allocated
    0024   36 Signed       4 * (0)
    0024   36 Bitstring    1 DSIFLAG        Test and set flag which indicates
                                            that a call to allocate
                                            additional DASD dump space has
                                            been stacked.
    0025   37 Bitstring    3 *              RESERVED FOR FUTURE IBM USE
    0028   40 Bitstring   24 DSICALBK       CALBK header entry size
         This area contains the CALBK for the dump space allocation function. It
         is required when managing clusters of DASD dump space and is needed as
         input to HCPPGCAL and HCPPGCRL, the cluster allocation and release
         entry points, respectively.
    0040   64 Dbl-Word     8 DSIENTRY (50)  SPACE FOR Cluster ALLOCATION
                                            INFORMATION
              00000190       DSIENTSZ       *-DSIENTRY SIZE OF CLUSTER
                                            ALLOCATION TABLE
    01D0  464 Dbl-Word     8 * (0)          Force boundary alignment for
                                            CCW's
    01D0  464 Dbl-Word     8 DSICHPGM (968) Space For System ABEND DUMP
                                            Channel Program
              00001E40       DSICHPSZ       *-DSICHPGM SIZE OF CHANNEL
                                            PROGRAM AREA
              00000402       DSISIZE        (*-DSIBK+7)/8 DSIBK ENTRY SIZE IN
                                            DOUBLEWORDS
              00002010       DSIBSIZE       DSISIZE*8 DSIBK ENTRY SIZE IN
                                            BYTES
         OVERLAY FOR ACCESSING THE NEXT ASA FOR Space INFORMATION
    0040   64 Signed       4 DSIASA (0)     ASA for start of allocation
    0040   64 Bitstring    2 DSICC          If CKD or ECKD, cylinder part
    0042   66 Bitstring    1 DSIP           If CKD or ECKD, page part
    0043   67 Bitstring    1 DSIV           volume part of DSIASA
    0044   68 Signed       4 DSINPGS        NUMBER OF Pages ALLOCATED
    0048   72 Signed       4 DSINEXT (0)    Start of the next ASA entry
    01D0  464 Dbl-Word     8 DSICCW         CCW construction area
    01D8  472 Signed       4 DSICCWNX (0)   Start of next CCW

#### DSIBK Storage Layout

    *** DSIBK - Dump Space Information Area
    *
    *     +-------------------------------------------------------+
    *   0 |                                                       |
    *     =                       DSILOCK                         =
    *     |                                                       |
    *     +---------------------------+---------------------------+
    *  18 |         DSIDPACP          |         DSITRPGS          |
    *     +---------------------------+------+--------------------+
    *  20 |         DSITAPGS          |:FLAG |////////////////////|
    *     +---------------------------+------+--------------------+
    *  28 |                                                       |
    *     =                       DSICALBK                        =
    *     |                                                       |
    *     +-------------------------------------------------------+
    *  40 |                                                       |
    *     =                       DSIENTRY                        =
    *     |                                                       |
    *     +-------------------------------------------------------+
    * 1D0 |                                                       |
    *     =                       DSICHPGM                        =
    *     |                                                       |
    *     +-------------------------------------------------------+
    *2010
    *
    *** DSIBK - Dump Space Information Area

    *** Overlay for DSIENTRY in DSIBK
    *
    *     +-------------+------+------+---------------------------+
    *  40 |   DSICC     |DSIP  |DSIV  |         DSINPGS           |
    *     +-------------+------+------+---------------------------+
    *
    *** Overlay for DSIENTRY in DSIBK

    *** Overlay for DSICHPGM in DSIBK
    *
    *     +-------------------------------------------------------+
    * 1D0 |                        DSICCW                         |
    *     +-------------------------------------------------------+
    *
    *** Overlay for DSICHPGM in DSIBK

#### DSIBK Cross Reference

    Symbol         Dspl Value
    -------------- ---- -----
    DSIASA         0040
    DSIBSIZE       01D0 00002010
    DSICALBK       0028
    DSICC          0040
    DSICCW         01D0
    DSICCWNX       01D8
    DSICHPGM       01D0
    DSICHPSZ       01D0 00001E40
    DSIDPACP       0018
    DSIENTRY       0040
    DSIENTSZ       0040 00000190
    DSIFLAG        0024
    DSILOCK        0000
    DSINEXT        0048
    DSINPGS        0044
    DSIP           0042
    DSISIZE        01D0 00000402
    DSITAPGS       0020
    DSITRPGS       001C
    DSIV           0043

This information is based on z/VM V4R3.0. Last updated on 30 Apr 2002 at 16:15:12 EDT.
Copyright IBM Corporation, 1990, 2002