CPVOL Back to Index page
 
Prolog 
Control Block Contents 
   CPVOL 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.


  CPVOL Prolog Top of page
 
 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 Control Block Content Top of page
 

 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 .... 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 Limit of slots that can be allocated before switching to another volume. 0018 24 Signed 2 CPVDEVLM Limit to allocate 001A 26 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. 001C 28 Signed 2 CPVCTDAL (0) Count of slots deallocated 001C 28 Signed 2 CPVCTPAG Page counts for de-allocation. 001E 30 Signed 2 CPVCTSPL Spool counts for de-allocation. Monitor information. These fields are provided for and maintained and serialized by the Monitor. 0020 32 Address 4 CPVMCPBK Pointer to MCPBK for this volume 0024 36 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. 0028 40 Signed 4 CPVLIST (0) Page and spool lists of CPVOLs. 0028 40 Signed 4 CPVPGNXT Page pointer to the next CPVOL containing pageing slots. 002C 44 Signed 4 CPVSPNXT Spool pointer to the next CPVOL containing spooling slots. Count of times this volume was looked at and used. 0030 48 Signed 4 CPVLOKAT Count of times this volume was looked at while chosing a volume for allocation. 0034 52 Signed 4 CPVALOCD Count of times this volume was chosen for allocation. SSI ownership information 0038 56 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 0039 57 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 003A 58 Bitstring 2 * Reserved for IBM use 003C 60 Character 8 CPVSSIID Name of the SSI which owns this volume. 0044 68 Character 8 CPVSYSID Name of the system which owns this volume. 004C 76 Signed 2 CPVDEVNO Configured RDEV 004E 78 Bitstring 2 * Reserved for IBM use End of CPVOL block. 0050 80 Dbl-Word 8 CPVOLEND (0) End of CPVOL. 0000000A CPVSIZE (*-CPVOL+7)/8 CPVOL entry size in doublewords (for PAGING/SPOOLING system volumes) 00000050 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 Storage Layout Top of page
 
          
*** CPVOL - System Volume List Entry
*
*     +-----------------------------------------+------+------+
*   0 |                CPVOLSER                 |:LSTAT|:CODE |
*     +---------------------------+-------------+------+------+
*   8 |         CPVRDEV           |         CPVVEXBK          |
*     +---------------------------+---------------------------+
*  10 |         CPVNEXT           |         CPVLERCT          |
*     +-------------+-------------+-------------+-------------+
*  18 |  CPVDEVLM   |/////////////|  CPVCTPAG   |  CPVCTSPL   |
*     +-------------+-------------+-------------+-------------+
*  20 |         CPVMCPBK          |         CPVMCPLK          |
*     +---------------------------+---------------------------+
*  28 |         CPVPGNXT          |         CPVSPNXT          |
*     +---------------------------+---------------------------+
*  30 |         CPVLOKAT          |         CPVALOCD          |
*     +------+------+-------------+---------------------------+
*  38 |:POWNR|:FLAGS|/////////////|        CPVSSIID-          |
*     +------+------+-------------+---------------------------+
*  40 |          -(03C)           |        CPVSYSID-          |
*     +---------------------------+-------------+-------------+
*  48 |          -(044)           |  CPVDEVNO   |/////////////|
*     +---------------------------+-------------+-------------+
*
*** CPVOL - System Volume List Entry
          
*** Overlay for CPVOLSER in CPVOL
*
*     +---------------------------+-------------+
*   0 |         CPVOLSR1          |  CPVOLSR5   | 6
*     +---------------------------+-------------+
*
*** Overlay for CPVOLSER in CPVOL
 
 
  CPVOL Cross Reference Top of page
 
 
Symbol         Dspl Value
-------------- ---- -----
CPVALOCD       0034
CPVBSIZE       0050 00000050
CPVCODE        0007
CPVCRDEV       0039 40
CPVCTDAL       001C
CPVCTPAG       001C
CPVCTSPL       001E
CPVDEVLM       0018
CPVDEVNO       004C
CPVFLAGS       0039
CPVLDRCT       0006 40
CPVLDUMP       0006 04
CPVLERCT       0014
CPVLIST        0028
CPVLOKAT       0030
CPVLSHRD       0006 10
CPVLSTAT       0006
CPVMAXER       0014 00000006
CPVMCPBK       0020
CPVMCPLK       0024
CPVMYSSI       0038 80
CPVNEXT        0010
CPVOLEND       0050
CPVOLMSK       0007 FF
CPVOLSER       0000
CPVOLSR1       0000
CPVOLSR5       0004
CPVOTSSI       0038 40
CPVOTSYS       0038 10
CPVPGNXT       0028
CPVPOWNR       0038
CPVRDEV        0008
CPVSIZE        0050 0000000A
CPVSPNXT       002C
CPVSPOOL       0039 80
CPVSSIID       003C
CPVSYSID       0044
CPVSYSOW       0038 20
CPVTEMPL       0006 80
CPVTEMPP       0006 01
CPVTEMPS       0006 02
CPVTEMPT       0006 08
CPVUVOL        0000
CPVVEXBK       000C
 
This information is based on z/VM 6.3.0 Last updated on 22 May 2013 at 13:54:08 EDT.
Copyright IBM Corporation, 1990, 2013