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


  $CCTBK Prolog Top of page
 
 NAME       : LGRCCTBK
 DESCRIPTION: Relocation mapping for HCPCCTBK
 DSECT      : $CCTBK
 FUNCTION   : LGRCCTBK describes those fields of the CCTBK that
              will be migrated to the destination system during
              guest relocation.
 LOCATED BY : This is a mapping of the RDODATA area within the
              RDOBK during guest relocation.
 RELOCATION CONSIDERATIONS : This control block is used during live guest
              relocation.  It is used to relocate a control block
              defined in a corresponding HCP COPY file.  Any
              fields or bits defined in HCPCCTBK which are
              required on the destination system must be defined
              here, and code must be added to migrate the field
              or bit during a relocation.
 
 
  $CCTBK Control Block Content Top of page
 

 $CCTBK DSECT Top of page
Hex Dec Type/Val Lng Label (dup) Comments ---- ---- --------- ---- -------------- -------- 0000 0 Structure $CCTBK Relocation mapping for HCPCCTBK 00000001 $CCT_VER 1 Mapping version number 0000 0 Signed 2 $CCT_HDRL Header length (in bytes) 0002 2 Signed 2 $CCT_BITL Length of mapped bits (in bytes) 0004 4 Signed 4 * Reserved for future use 00000008 $CCT_HDLN *-$CCTBK Length of header (bytes) Bit map: Contains the CCTBK flags that are subject to relocation. These bits are defined sequentially, regardless of how they are defined in HCPCCTBK. This yields a consistent mapping that ensures compatibility when a guest is relocated between systems at differing service levels. Names in the comments column indicate the control block byte which contains the flag. This name is subject to change if the flag definition changes. ====> NEVER change bits which already exist here. ====> NEVER change the order of bits in this section. ====> ALWAYS add new bits at the end of this section, together with new flag bytes as required. 0008 8 Signed 2 $CCT_BITS (0) Bit map area 0008 8 Bitstring 1 $CCT0 1... .... $CCTPNDSN X'80' $CCTPNDSN CCTFLAG2 .1.. .... $CCTPNDSP X'40' $CCTPNDSP CCTFLAG2 ..1. .... $CCTPNDRN X'20' $CCTPNDRN CCTFLAG2 ...1 .... $CCTPNDRP X'10' $CCTPNDRP CCTFLAG2 .... 1... $CCTPNDCT X'08' $CCTPNDCT CCTFLAG2 .... .1.. $CCTRTVBF X'04' $CCTRTVBF CCTSTAT .... ..1. $CCTSYNC X'02' $CCTSYNC CCTSTAT .... ...1 $CCTCPINT X'01' $CCTCPINT CCTSTAT 0009 9 Bitstring 1 $CCT1 1... .... $CCTSTKED X'80' $CCTSTKED CCTSTAT 00000002 $CCT_BLEN *-$CCT_BITS Length of bit map area Data: Contains all HCPCCTBK data that is subject to relocation, except for flag bits, which are handled separately. All fields are defined as XLnn to avoid alignment warnings and to pack the data efficiently. ====> NEVER change fields which already exist here. ====> NEVER change the order of fields in this section. ====> ALWAYS add new fields at the end of this section. together with new flag bytes as required. 000A 10 Bitstring 1 $CCT_DATA (0) Start of data map 000A 10 Bitstring 2 $CCTMXPID CURRENT MAX PATH ID FOR THIS CCT 000C 12 Bitstring 4 $CCTIUCV POINTER TO THE USER'S IUCVBK 0010 16 Bitstring 4 $CCTSNDHD SEND QUEUE HEAD 0014 20 Bitstring 4 $CCTSNDTL SEND QUEUE TAIL 0018 24 Bitstring 4 $CCTSNDPR SEND PRIORITY QUEUE TAIL 001C 28 Bitstring 4 $CCTRCVHD RECEIVE QUEUE HEAD 0020 32 Bitstring 4 $CCTRCVTL RECEIVE QUEUE TAIL 0024 36 Bitstring 4 $CCTRPYHD REPLY QUEUE HEAD 0028 40 Bitstring 4 $CCTRPYTL REPLY QUEUE TAIL 002C 44 Bitstring 4 $CCTRPYPR REPLY PRIORITY QUEUE TAIL 0030 48 Bitstring 4 $CCTMSGCT TOTAL MSGS SENT ON ALL PATHS 0034 52 Bitstring 1 $CCTCPSYS CP SYSTEM SERVICE CODE 0035 53 Bitstring 4 $CCTDESCT SEND QUEUE MSGS TO BE DESCRIBED 0039 57 Bitstring 4 $CCTPDSEG -> RDO offset to first PDEBK 0000003D $CCT_LEN *-$CCTBK Total length, in bytes 00000008 $CCT_SZ ($CCT_LEN+7)/8 Size in doublewords
 
 
  $CCTBK Storage Layout Top of page
 
          
*** $CCTBK - Relocation mapping for HCPCCTBK
*
*     +-------------+-------------+---------------------------+
*   0 | $CCT_HDRL   | $CCT_BITL   |///////////////////////////|
*     +------+------+-------------+---------------------------+
*   8 |$CCT0 |$CCT1 | $CCTMXPID   |         $CCTIUCV          |
*     +------+------+-------------+---------------------------+
*  10 |        $CCTSNDHD          |        $CCTSNDTL          |
*     +---------------------------+---------------------------+
*  18 |        $CCTSNDPR          |        $CCTRCVHD          |
*     +---------------------------+---------------------------+
*  20 |        $CCTRCVTL          |        $CCTRPYHD          |
*     +---------------------------+---------------------------+
*  28 |        $CCTRPYTL          |        $CCTRPYPR          |
*     +---------------------------+------+--------------------+
*  30 |        $CCTMSGCT          |(034) |    $CCTDESCT-      |
*     +------+--------------------+------+--------------------+
*  38 |-(035)|        $CCTPDSEG          | 3D
*     +------+---------------------------+
*
*** $CCTBK - Relocation mapping for HCPCCTBK
 
 
  $CCTBK Cross Reference Top of page
 
 
Symbol         Dspl Value
-------------- ---- -----
$CCT_BITL      0002
$CCT_BITS      0008
$CCT_BLEN      0009 00000002
$CCT_DATA      000A
$CCT_HDLN      0004 00000008
$CCT_HDRL      0000
$CCT_LEN       0039 0000003D
$CCT_SZ        0039 00000008
$CCT_VER       0000 00000001
$CCTCPINT      0008 01
$CCTCPSYS      0034
$CCTDESCT      0035
$CCTIUCV       000C
$CCTMSGCT      0030
$CCTMXPID      000A
$CCTPDSEG      0039
$CCTPNDCT      0008 08
$CCTPNDRN      0008 20
$CCTPNDRP      0008 10
$CCTPNDSN      0008 80
$CCTPNDSP      0008 40
$CCTRCVHD      001C
$CCTRCVTL      0020
$CCTRPYHD      0024
$CCTRPYPR      002C
$CCTRPYTL      0028
$CCTRTVBF      0008 04
$CCTSNDHD      0010
$CCTSNDPR      0018
$CCTSNDTL      0014
$CCTSTKED      0009 80
$CCTSYNC       0008 02
$CCT0          0008
$CCT1          0009
 
This information is based on z/VM 7.3.0 Last updated on 22 Jun 2022 at 15:58:29 EDT.
Copyright IBM Corporation, 1990, 2022