NAME       : HCPCPVOL
 DESCRIPTION: System Volume List Entry
 DSECT      : CPVOL
 FUNCTION   : A CPVOL describes a volume that is dedicated
              for use by the system.
 LOCATED BY : CPVNEXT  - Field of HCPCPVOL block used for paging
              reference to indicate the next device
              of the same type.
              RDEVVOL  - Field of HCPRDEV block
              SYSVOLS  - Contains the pointer to the beginning of
              CP-owned volumes that are contiguous in
              storage.  The volume index of the ASA can
              be used to index into the table to
              determine the correct volume for that ASA.
              Multiply the index by the size of a CPVOL.
 CREATED BY : HCPGENER  MACRO after the SYSCPVOL MACRO has been
              executed.
 DELETED BY : The CPVOL is never deleted.
 SERIALIZED :
              - CPLERCT is serialized with Compare and Swap
 RELOCATION CONSIDERATIONS : None

 CPVOL DSECT
Top of page

Hex   Dec Type/Val   Lng Label (dup)    Comments
---- ---- --------- ---- -------------- --------
0000    0 Structure      CPVOL          System Volume List Entry
0000    0 Dbl-Word     8 CPVUVOL (0)    For DW alignment & length calc.
0000    0 Character    6 CPVOLSER       Volume serial identifier
0006    6 Bitstring    1 CPVLSTAT       Volume status flags
          1... ....      CPVTEMPL       X'80' CPVTEMPL Indicates that the
                                        CPVOL is temporarily removed from
                                        the allocation list. The volume
                                        does not have any slots available
                                        for allocation. (removed
                                        logically only) FOR ATTEMPTS TO
                                        LINK
          .1.. ....      CPVLDRCT       X'40' CPVLDRCT Volume contains
                                        directory slots
          ..1. ....      CPVLNDMP       X'20' CPVLNDMP Volume ineligible
                                        for dump use
          ...1 ....      CPVLSHRD       X'10' CPVLSHRD Volume was defined
                                        in SYSCPVOL as "SHR". It is not
                                        owned by this system, it is owned
                                        by another system in the VM/CSE
                                        complex and can only be READ by
                                        this system.
          .... 1...      CPVTEMPT       X'08' CPVTEMPT Indicates that the
                                        CPVOL is temporarily removed from
                                        the allocation list. The volume
                                        does not have any slots available
                                        for allocation. (removed
                                        logically only) FOR TDISK SPACE
          .... .1..      CPVLDUMP       X'04' CPVLDUMP Volume was defined
                                        in SYSCPVOL as a DUMP ONLY volume
          .... ..1.      CPVTEMPS       X'02' CPVTEMPS Indicates that the
                                        CPVOL is temporarily removed from
                                        the allocation list. The volume
                                        does not have any SPOOL slots
                                        available for allocation. SPOOL
                                        space on the volume either is
                                        full or has been DRAINed.
                                        (Removed logically only.) Notes :
                                        CPVTEMPS == PGTSPOOL == PGUSPOOL
                                        == ALOCSPOL:
      Notes      :  If CPVTEMPS is set in CPVLSTAT *before* the device is
             initialized and attached to the system (e.g., CPVRDEV
             and/or CPVVEXBK are zero), it indicates that the
             volume has been DRAINed for SPOOL, and should *NOT
             be started (made available for allocation) when it
             is eventually initialized and attached to the system.
          .... ...1      CPVTEMPP       X'01' Indicates that the CPVOL is
                                        temporarily removed from the
                                        allocation list. The volume does
                                        not have any PAGE slots available
                                        for allocation. PAGE space on the
                                        volume either is full or has been
                                        DRAINed. (Removed logically
                                        only.)
      Notes      :  CPVTEMPP == PGTPAGE == PGUPAGE == ALOCPAGE:
      Notes      :  If CPVTEMPP is set in CPVLSTAT *before* the device is
             initialized and attached to the system (e.g., CPVRDEV
             and/or CPVVEXBK are zero), it indicates that the
             volume has been DRAINed for PAGE, and should *NOT
             be started (made available for allocation) when it
             is eventually initialized and attached to the system.
0007    7 Bitstring    1 CPVCODE        Index number into CPVOL list
          1111 1111      CPVOLMSK       X'000000FF' CPVOLMSK CPVOL mask
                                        to get Volume number isolated
                                        from CCPV or PPPV.
0008    8 Address      4 CPVRDEV        Address of the RDEV block if
                                        attached otherwise it contains
                                        zeroes
000C   12 Address      4 CPVVEXBK       Address of the VEXBK
0010   16 Address      4 CPVNEXT        Next CPVOL of same device type.
                                        The end pointer is zero.
0014   20 Signed       4 CPVLERCT       # of continuous paging errors
                                        this field must be updated by
                                        COMPARE and SWAP logic
          00000006       CPVMAXER       6 The maximun number of
                                        continuous errors allowed
0018   24 Signed       8 CPVLERTM       Timestamp of the last time a
                                        HCP415E message was issued.
             Limit of slots that can be allocated before switching
      to another volume.
0020   32 Signed       2 CPVDEVLM       Limit to allocate
0022   34 Signed       2 *              Reserved for IBM use.
             Count of slots deallocated for a volume that once
      full.  The volume is keep from being allocated too until it
      has at least the limit allowed for allocation before
      switching volumes.
      CPCTDAL is used to address the fields index by SALOFFST/2.
0024   36 Signed       2 CPVCTDAL (0)   Count of slots deallocated
0024   36 Signed       2 CPVCTPAG       Page counts for de-allocation.
0026   38 Signed       2 CPVCTSPL       Spool counts for de-allocation.
        Monitor information.  These fields are provided for and
        maintained and serialized by the Monitor.
0028   40 Address      4 CPVMCPBK       Pointer to MCPBK for this volume
002C   44 Signed       4 CPVMCPLK       Lockword for MCPBK
             CPVLIST is used to address both the next pointers
      for paging and spooling queues.  SALOFFST is used to
      determine what queue to look at.
      The CPVOLs on these queues are looped to together.  The end
      pointer points to the first in queue.
0030   48 Signed       4 CPVLIST (0)    Page and spool lists of CPVOLs.
0030   48 Signed       4 CPVPGNXT       Page pointer to the next CPVOL
                                        containing pageing slots.
0034   52 Signed       4 CPVSPNXT       Spool pointer to the next CPVOL
                                        containing spooling slots.
             Count of times this volume was looked at and used.
0038   56 Signed       4 CPVLOKAT       Count of times this volume was
                                        looked at while chosing a volume
                                        for allocation.
003C   60 Signed       4 CPVALOCD       Count of times this volume was
                                        chosen for allocation.
        SSI ownership information
0040   64 Bitstring    1 CPVPOWNR       SSI ownership flags
          1... ....      CPVMYSSI       X'80' CPVMYSSI Indicates CPVOL is
                                        owned by this SSI
          .1.. ....      CPVOTSSI       X'40' CPVOTSSI Indicates CPVOL is
                                        owned by some other SSI
          ..1. ....      CPVSYSOW       X'20' CPVSYSOW Indicates CPVOL is
                                        owned by this system
          ...1 ....      CPVOTSYS       X'10' CPVOTSYS Indicates CPVOL is
                                        owned by some other system
0041   65 Bitstring    1 CPVFLAGS       CPVOL status flags
          1... ....      CPVSPOOL       X'80' CPVSPOOL Indicates CPVOL
                                        has SPOL extents
          .1.. ....      CPVCRDEV       X'40' CPVCRDEV Indicates RDEV was
                                        specified in configuration
0042   66 Bitstring    2 *              Reserved for IBM use
0044   68 Character    8 CPVSSIID       Name of the SSI which owns this
                                        volume.
004C   76 Character    8 CPVSYSID       Name of the system which owns
                                        this volume.
0054   84 Signed       2 CPVDEVNO       Configured RDEV
0056   86 Bitstring    2 *              Reserved for IBM use
             End of CPVOL block.
0058   88 Dbl-Word     8 CPVOLEND (0)   End of CPVOL.
          0000000B       CPVSIZE        (*-CPVOL+7)/8 CPVOL entry size in
                                        doublewords (for PAGING/SPOOLING
                                        system volumes)
          00000058       CPVBSIZE       CPVSIZE*8 CPVOL entry size in
                                        bytes
0000    0 Character    4 CPVOLSR1       Bytes 1-4 of CPVOLSER
0004    4 Character    2 CPVOLSR5       Bytes 5 & 6 of CPVOLSER

          
*** CPVOL - System Volume List Entry
*
*     +-----------------------------------------+------+------+
*   0 |                CPVOLSER                 |:LSTAT|:CODE |
*     +---------------------------+-------------+------+------+
*   8 |         CPVRDEV           |         CPVVEXBK          |
*     +---------------------------+---------------------------+
*  10 |         CPVNEXT           |         CPVLERCT          |
*     +---------------------------+---------------------------+
*  18 |                       CPVLERTM                        |
*     +-------------+-------------+-------------+-------------+
*  20 |  CPVDEVLM   |/////////////|  CPVCTPAG   |  CPVCTSPL   |
*     +-------------+-------------+-------------+-------------+
*  28 |         CPVMCPBK          |         CPVMCPLK          |
*     +---------------------------+---------------------------+
*  30 |         CPVPGNXT          |         CPVSPNXT          |
*     +---------------------------+---------------------------+
*  38 |         CPVLOKAT          |         CPVALOCD          |
*     +------+------+-------------+---------------------------+
*  40 |:POWNR|:FLAGS|/////////////|        CPVSSIID-          |
*     +------+------+-------------+---------------------------+
*  48 |          -(044)           |        CPVSYSID-          |
*     +---------------------------+-------------+-------------+
*  50 |          -(04C)           |  CPVDEVNO   |/////////////|
*     +---------------------------+-------------+-------------+
*
*** CPVOL - System Volume List Entry
          
*** Overlay for CPVOLSER in CPVOL
*
*     +---------------------------+-------------+
*   0 |         CPVOLSR1          |  CPVOLSR5   | 6
*     +---------------------------+-------------+
*
*** Overlay for CPVOLSER in CPVOL

 
Symbol         Dspl Value
-------------- ---- -----
CPVALOCD       003C
CPVBSIZE       0058 00000058
CPVCODE        0007
CPVCRDEV       0041 40
CPVCTDAL       0024
CPVCTPAG       0024
CPVCTSPL       0026
CPVDEVLM       0020
CPVDEVNO       0054
CPVFLAGS       0041
CPVLDRCT       0006 40
CPVLDUMP       0006 04
CPVLERCT       0014
CPVLERTM       0018
CPVLIST        0030
CPVLNDMP       0006 20
CPVLOKAT       0038
CPVLSHRD       0006 10
CPVLSTAT       0006
CPVMAXER       0014 00000006
CPVMCPBK       0028
CPVMCPLK       002C
CPVMYSSI       0040 80
CPVNEXT        0010
CPVOLEND       0058
CPVOLMSK       0007 FF
CPVOLSER       0000
CPVOLSR1       0000
CPVOLSR5       0004
CPVOTSSI       0040 40
CPVOTSYS       0040 10
CPVPGNXT       0030
CPVPOWNR       0040
CPVRDEV        0008
CPVSIZE        0058 0000000B
CPVSPNXT       0034
CPVSPOOL       0041 80
CPVSSIID       0044
CPVSYSID       004C
CPVSYSOW       0040 20
CPVTEMPL       0006 80
CPVTEMPP       0006 01
CPVTEMPS       0006 02
CPVTEMPT       0006 08
CPVUVOL        0000
CPVVEXBK       000C