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.2.0 Last updated on 24 Jun 2020 at 09:30:19 EDT.
Copyright IBM Corporation, 1990, 2020