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
 COPYRIGHT
              THIS MODULE IS "RESTRICTED MATERIALS OF IBM"
              5654-A17 (C) COPYRIGHT IBM CORP. - 1989, 2001
              LICENSED MATERIALS - PROPERTY OF IBM
 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 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 V4R3.0. Last updated on 30 Apr 2002 at 15:42:29 EDT.
Copyright IBM Corporation, 1990, 2002