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 V4R2.0. Last updated on 17 Oct 2001 at 15:09:30 EDT.
Copyright IBM Corporation, 1990, 2001