IBM: CALBK

Programming Interface Information: This information is NOT intended to be
used as Programming Interfaces of VM/ESA. It is to be used for diagnosis only.

CALBK

Prolog

Control Block Contents

CALBK DSECT

Storage Layout

Cross Reference (Contains links to field and bit definitions)

CALBK Prolog

 NAME       : HCPCALBK
 DESCRIPTION: Cluster Allocation List Block
 STATUS     : VM/ESA Version 2, Release 4.0
 DSECT      : CALBK
 FUNCTION   : The CALBK describes the allocation information
              for clusters of auxiliary storage.
 LOCATED BY   HCPDMQST - When the SET DUMP command requires
              DASD dump space be allocated for a
              system abend dump.
              HCPPGCAL - When requested to provide clusters
              for DASD dump space, and
              - When the CP extend number of pages
              matches the value in DSIFSFCP.
              HCPPGCRL - When releasing clusters from DASD
 CREATED BY   CPDMQSD - When dump space request is for DASD
 DELETED BY   CPDMQST - When DASD dump space has been released
 SERIALIZED : The Caller
 COMMENTS   : This is a variable length control block.  It
              consists of the header information plus a
              variable number of cluster allocation entries.

CALBK Control Block Content


CALBK DSECT
Hex   Dec Type/Val   Lng Label (dup)    Comments
---- ---- --------- ---- -------------- --------
0000    0 Structure      CALBK          Cluster Allocation List Block
0000    0 Signed       4 CALHDR (0)
0000    0 Signed       4 CALEXT         Offset to next available CALENTRY
0004    4 Signed       2 CALNASA        Remaining Entries for ASA Info
0006    6 Signed       2 CALTASA        Total Entries for ASA Information
0008    8 Bitstring    1 CALFLAG        Processing Flags
          1... ....      CALVAR         X'80' Volume Affinity Requested
          .1.. ....      CALSVR         X'40' Single Volume Request
          ..1. ....      CALMVR         X'20' Multiple Volume Request
          ...1 ....      CALNCNTG       X'10' Non-contiguous Space
                                        Allowed
          .... 1...      CALCPDT        X'08' Volume Requested list
                                        indicator 0=CPVOLs in list,
                                        1=DEVTYPES in list
          .... .1..      CALSRCI        X'04' Request has special
                                        requirements Follow Code Request
0009    9 Bitstring    1 CALCPVOL (8)   The Volume Requested list
0011   17 Bitstring    1 CALNCPVL       Number of meaningful CPVCODEs or
                                        device types on the Volume
                                        Requested list
0012   18 Bitstring    1 CALCODE        Special Request Code Value
          00000001       CALDSAR        X'01' Code for DumpSpace
                                        Allocation
0013   19 Bitstring    5 *              Reserved for IBM Use
          00000003       CALHDRSZ       ((*-CALBK)+7)/8 CALBK header size
                                        in doublewords
0018   24 Dbl-Word     8 CALENTRY (0)   Start of Variable length data
     Overlay for accessing the next ASA for space allocation/information
0018   24 Signed       4 CALASA (0)     ASA specification
0018   24 Bitstring    2 CALCC          If CKD or ECKD, CC
001A   26 Bitstring    1 CALCP          If CKD or ECKD, P
001B   27 Bitstring    1 CALCV          VOLUME
001C   28 Signed       4 CALNPGS        Number of Pages allocated
0020   32 Signed       4 CALNEXT (0)    Next ASA entry
     Overlay for accessing the next CPVOLid for a multiple specification or
     preferred order of device types
0009    9 Bitstring    1 CALCPVID       CPVCODE or device type in the
                                        list
000A   10 Bitstring    1 CALCPNXT (0)   Next CPVCODE or device type
          00000002       CALSIZE        ((*-CALBK)+7)/8 Length of 1
                                        CALENTRY in DWORDS
          00000010       CALENTSZ       CALSIZE*8 Length of 1 CALENTRY in
                                        BYTES

CALBK Storage Layout

*** CALBK - Cluster Allocation List Block
*
*     +---------------------------+-------------+-------------+
*   0 |          CALEXT           |  CALNASA    |  CALTASA    |
*     +------+--------------------+-------------+-------------+
*   8 |:FLAG |                   CALCPVOL-                    |
*     +------+------+------+----------------------------------+
*  10 |-(009)|:NCPVL|:CODE |//////////////////////////////////|
*     +------+------+------+----------------------------------+
*  18 |                                                       |
*     =                       CALENTRY                        =
*     |                                                       |
*     +-------------------------------------------------------+
*
*** CALBK - Cluster Allocation List Block
*** Overlay for CALENTRY in CALBK
*
*     +-------------+------+------+---------------------------+
*  18 |   CALCC     |CALCP |CALCV |         CALNPGS           |
*     +-------------+------+------+---------------------------+
*  20 |                                                       |
*     =                       CALNEXT                         =
*     |                                                       |
*     +-------------------------------------------------------+
*
*** Overlay for CALENTRY in CALBK
*** Overlay for CALCPVOL in CALBK
*
*            +------+-----------------------------------------+
*   8 ..   9 |:CPVID|                                         |
*     +------+------+                                         |
*  10 |                                                       |
*     =                       CALCPNXT                        =
*     |                                                       |
*     +-------------------------------------------------------+
*
*** Overlay for CALCPVOL in CALBK