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 1 May 2002 at 08:05:49 EDT.
Copyright IBM Corporation, 1990, 2002