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

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
 DSECT      : CALBK
 FUNCTION   : The CALBK describes the allocation information
              for clusters of auxiliary storage.
  OCATED BY  DSICALBK in DSIBK
  REATED BY  HCPDMQSD - When dump space request is for DASD
  ELETED BY  HCPDMQST - When DASD dump space has been released
 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


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' CALVAR Volume Affinity
                                        Requested
          .1.. ....      CALSVR         X'40' CALSVR Single Volume
                                        Request
          ..1. ....      CALMVR         X'20' CALMVR Multiple Volume
                                        Request
          ...1 ....      CALNCNTG       X'10' CALNCNTG Non-contiguous
                                        Space Allowed
          .... 1...      CALCPDT        X'08' CALCPDT Volume Requested
                                        list indicator 0=CPVOLs in list,
                                        1=DEVTYPES in list
          .... .1..      CALSRCI        X'04' CALSRCI 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' CALDSAR 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 individual CALENTRYs
0018   24 Signed       4 CALASA (0)     First ASA in allocated cluster
0018   24 Bitstring    3 CALPPP (0)     If FBA, PPP
0018   24 Bitstring    2 CALCC          If CKD or ECKD, CC
001A   26 Bitstring    1 CALP           If CKD or ECKD, P
001B   27 Bitstring    1 CALVOL         Volume - index into CPVOL list
001C   28 Signed       4 CALNPGS        Number of Pages allocated
0020   32 Signed       4 CALNEXT (0)    Next ASA entry
          00000001       CALENTSZ       ((*-CALENTRY)+7)/8 CALENTRY size
                                        in dwords
          00000008       CALENTLN       CALENTSZ*8 CALENTRY length in
                                        bytes
      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

 

CALBK Storage Layout

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

 

CALBK Cross Reference

Symbol         Dspl Value
-------------- ---- -----
CALASA         0018
CALCC          0018
CALCODE        0012
CALCPDT        0008 08
CALCPNXT       000A
CALCPVID       0009
CALCPVOL       0009
CALDSAR        0012 00000001
CALENTLN       0020 00000008
CALENTRY       0018
CALENTSZ       0020 00000001
CALEXT         0000
CALFLAG        0008
CALHDR         0000
CALHDRSZ       0013 00000003
CALMVR         0008 20
CALNASA        0004
CALNCNTG       0008 10
CALNCPVL       0011
CALNEXT        0020
CALNPGS        001C
CALP           001A
CALPPP         0018
CALSRCI        0008 04
CALSVR         0008 40
CALTASA        0006
CALVAR         0008 80
CALVOL         001B

This information is based on z/VM V6R2.0. Last updated on 21 Nov 2011 at 10:54:27 EDT.
Copyright IBM Corporation, 1990, 2011