CALBK Back to Index page
 
Prolog 
Control Block Contents 
   CALBK DSECT
Storage Layout 
Cross Reference (Contains links to field and bit definitions)
Programming Interface Information:
This information is NOT intended to be
used as Programming Interfaces of z/VM.


  CALBK Prolog Top of page
 
 NAME       : HCPCALBK
 DESCRIPTION: Cluster Allocation List Block
 DSECT      : CALBK
 FUNCTION   : The CALBK describes the allocation information
              for clusters of auxiliary storage.
 LOCATED BY : DSICALBK (embedded within the DSIBK)
 CREATED BY : System generation (static within the DSIBK
              created by HCPDSI's compilation)
 DELETED BY : Never (see above)
 SERIALIZED : The Caller
 RELOCATION CONSIDERATIONS : None
 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 Top of page
 

 CALBK DSECT Top of page
Hex Dec Type/Val Lng Label (dup) Comments ---- ---- --------- ---- -------------- -------- 0000 0 Structure CALBK Cluster Allocation List Block 0000 0 Signed 2 CALNASA Remaining Entries for ASA Info CALNASA is the number of slots without an allocated ASA (eg: contain 0) 0002 2 Signed 2 CALTASA Total Entries for ASA Information CALTASA is the number of slots with an allocated ASA. CALNASA and CALTASA should, at all times, sum to DSIENTCT 0004 4 Bitstring 32 CALCPVOL The Volume Requested list. Each entry in this list is the CPVCODE of a CP owned DASD (this is the volume's index into the CP owned list). The length specified is the maximum number of DASD RDEVs allowed to be specified on SET DUMP. All code keys off the length of CALCPVOL and simply increasing this number increases the number of volumes supported with no other changes required. This number can not be set greater than 256 without significant code rework. 0024 36 Bitstring 1 CALNCPVL Number of entries in the above Volume Requested list 0025 37 Bitstring 3 * Reserved 0028 40 Dbl-Word 8 * (0) Force boundary alignment (if needed) 0028 40 Bitstring 8 CALREASA Re-allocation ASA and number of pages (CALENTRY) 0030 48 Address 4 CALRESLT Re-allocation slot The above two fields are set by HCPDMPDK after it has completed writing a dump to spool. CALREASA contains a replacement CALENTRY that represents the unused portion of the last used slot's allocated space. CALRESLT points to the slot after the last used slot in the array of CALENTRYs. This entry and all entries after it have had NONE of their allocated space used to hold dump data. 0034 52 Bitstring 4 * Reserved 00000007 CALHDRSZ ((*-CALBK)+7)/8 CALBK header size in doublewords 0038 56 Dbl-Word 8 CALENTRY (0) Start of Variable length data Overlay for accessing individual CALENTRYs 0038 56 Signed 4 CALASA (0) First ASA in allocated cluster 0038 56 Bitstring 3 CALPPP (0) If FBA, PPP 0038 56 Bitstring 2 CALCC If CKD or ECKD, CC 003A 58 Bitstring 1 CALP If CKD or ECKD, P 003B 59 Bitstring 1 CALVOL Volume - index into CPVOL list 003C 60 Signed 4 CALNPGS Number of Pages allocated 0040 64 Signed 4 CALNEXT (0) Next ASA entry 00000001 CALENTSZ ((*-CALENTRY)+7)/8 CALENTRY size in dwords 00000008 CALENTLN CALENTSZ*8 CALENTRY length in bytes
 
 
  CALBK Storage Layout Top of page
 
          
*** CALBK - Cluster Allocation List Block
*
*     +-------------+-------------+---------------------------+
*   0 |  CALNASA    |  CALTASA    |                           |
*     +-------------+-------------+                           |
*   8 |                                                       |
*     =                       CALCPVOL                        =
*     |                           +------+--------------------+
*  20 |                           |:NCPVL|////////////////////|
*     +---------------------------+------+--------------------+
*  28 |                       CALREASA                        |
*     +---------------------------+---------------------------+
*  30 |         CALRESLT          |///////////////////////////|
*     +---------------------------+---------------------------+
*
*** CALBK - Cluster Allocation List Block
          
*** Overlay for CALENTRY in CALBK
*
*     +-------------+------+------+---------------------------+
*  38 |   CALCC     |CALP  |CALVOL|         CALNPGS           |
*     +-------------+------+------+---------------------------+
*
*** Overlay for CALENTRY in CALBK
 
 
  CALBK Cross Reference Top of page
 
 
Symbol         Dspl Value
-------------- ---- -----
CALASA         0038
CALCC          0038
CALCPVOL       0004
CALENTLN       0040 00000008
CALENTRY       0038
CALENTSZ       0040 00000001
CALHDRSZ       0034 00000007
CALNASA        0000
CALNCPVL       0024
CALNEXT        0040
CALNPGS        003C
CALP           003A
CALPPP         0038
CALREASA       0028
CALRESLT       0030
CALTASA        0002
CALVOL         003B
 
This information is based on z/VM 7.3.0 Last updated on 22 Jun 2022 at 15:54:53 EDT.
Copyright IBM Corporation, 1990, 2022