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   : DSIDPALO and DSIDPAHI are threshold values used
              to communicate to the storage management.  If
              RSADPACP is larger than DSIDPAHI then it is
              time to get more dump space.  If RSADPACP is
              smaller than DSIDPALO then it is time to
              release and reallocate the dump space.

 

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 DSIOLDHI       Previous Hi Threshold.
001C   28 Signed       4 DSITAPGS       Total DASD pages currently
                                        allocated
0020   32 Signed       4 DSIDPAHI       High Threshold value for CP-owned
                                        pages. When the value in this
                                        field is X'FFFFFFFF' no
                                        additional DASD dump space is to
                                        be obtained.
0024   36 Signed       4 DSIRSASV       RSADPACP at time of reallocation
0028   40 Signed       4 DSIDPALO       Low Threshold value for CP-owned
                                        pages. When the value in this
                                        field is X'FFFFFFFF', extra DASD
                                        dump is not released
002C   44 Signed       4 * (0)
002C   44 Bitstring    1 DSIFLAG        Test and set flag which indicates
                                        that a call to allocate
                                        additional DASD dump space has
                                        been stacked.
002D   45 Bitstring    3 *              RESERVED FOR FUTURE IBM USE
0030   48 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.
      The number of entries in the cluster allocation table is
      based on experience.  As the size of the average dump
      increases in subsequent releases, customers may encounter
      message HCP9255I more frequently and the value for
      DSIENTCT may need to be increased.  Consequently, the
      size of the entire DSIBK may need to be increased beyond
      2 pages in order to provide space to build an effective
      channel program.
      Using 495 cause DSICHPGM to be x'FC0' which probably won't
      cause any problems for HCPDMP which builds the channel pgm.
          000001EF       DSIENTCT       495 Number of entries in CALBK
0048   72 Dbl-Word     8 DSIENTRY (495) Space for Cluster Allocation
                                        Table
          00000F78       DSIENTSZ       *-DSIENTRY SIZE OF CLUSTER
                                        ALLOCATION TABLE
0FC0 4032 Dbl-Word     8 * (0)          Force boundary alignment for
                                        CCW's
0FC0 4032 Unknown      8 DSICHPGM (519) Space For Hard Abend Dump Channel
                                        Program
          00001038       DSICHPSZ       *-DSICHPGM SIZE OF CHANNEL
                                        PROGRAM AREA
          000003FF       DSISIZE        (*-DSIBK+7)/8 DSIBK ENTRY SIZE IN
                                        DOUBLEWORDS
          00001FF8       DSIBSIZE       DSISIZE*8 DSIBK ENTRY SIZE IN
                                        BYTES
      OVERLAY FOR ACCESSING THE NEXT ASA FOR Space INFORMATION
0048   72 Signed       4 DSIASA (0)     ASA for start of allocation
0048   72 Bitstring    2 DSICC          If CKD or ECKD, cylinder part
004A   74 Bitstring    1 DSIP           If CKD or ECKD, page part
004B   75 Bitstring    1 DSIV           volume part of DSIASA
004C   76 Signed       4 DSINPGS        NUMBER OF Pages ALLOCATED
0050   80 Signed       4 DSINEXT (0)    Start of the next ASA entry
0FC0 4032 Dbl-Word     8 DSICCW         CCW construction area
0FC8 4040 Dbl-Word     8 DSICCWNX (0)   Start of next CCW

 

DSIBK Storage Layout

          
*** DSIBK - Dump Space Information Area
*
*     +-------------------------------------------------------+
*   0 |                                                       |
*     =                       DSILOCK                         =
*     |                                                       |
*     +---------------------------+---------------------------+
*  18 |         DSIOLDHI          |         DSITAPGS          |
*     +---------------------------+---------------------------+
*  20 |         DSIDPAHI          |         DSIRSASV          |
*     +---------------------------+------+--------------------+
*  28 |         DSIDPALO          |:FLAG |////////////////////|
*     +---------------------------+------+--------------------+
*  30 |                                                       |
*     =                       DSICALBK                        =
*     |                                                       |
*     +-------------------------------------------------------+
*  48 |                                                       |
*     =                       DSIENTRY                        =
*     |                                                       |
*     +-------------------------------------------------------+
* FC0 |                                                       |
*     =                       DSICHPGM                        =
*     |                                                       |
*     +-------------------------------------------------------+
*1FF8
*
*** DSIBK - Dump Space Information Area
          
*** Overlay for DSIENTRY in DSIBK
*
*     +-------------+------+------+---------------------------+
*  48 |   DSICC     |DSIP  |DSIV  |         DSINPGS           |
*     +-------------+------+------+---------------------------+
*
*** Overlay for DSIENTRY in DSIBK
          
*** Overlay for DSICHPGM in DSIBK
*
*     +-------------------------------------------------------+
* FC0 |                        DSICCW                         |
*     +-------------------------------------------------------+
*
*** Overlay for DSICHPGM in DSIBK

 

DSIBK Cross Reference

Symbol         Dspl Value
-------------- ---- -----
DSIASA         0048
DSIBSIZE       0FC0 00001FF8
DSICALBK       0030
DSICC          0048
DSICCW         0FC0
DSICCWNX       0FC8
DSICHPGM       0FC0
DSICHPSZ       0FC0 00001038
DSIDPAHI       0020
DSIDPALO       0028
DSIENTCT       0030 000001EF
DSIENTRY       0048
DSIENTSZ       0048 00000F78
DSIFLAG        002C
DSILOCK        0000
DSINEXT        0050
DSINPGS        004C
DSIOLDHI       0018
DSIP           004A
DSIRSASV       0024
DSISIZE        0FC0 000003FF
DSITAPGS       001C
DSIV           004B

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