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


  $SDNX Prolog Top of page
 
 NAME       : LGRSDNX
 DESCRIPTION: Relocation mapping for HCPSDNX
 DSECT      : $SDNX
 FUNCTION   : LGRSDNX describes those fields of the SDNX 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 HCPSDNX 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.
 
 
  $SDNX Control Block Content Top of page
 

 $SDNX DSECT Top of page
Hex Dec Type/Val Lng Label (dup) Comments ---- ---- --------- ---- -------------- -------- 0000 0 Structure $SDNX Relocation mapping for HCPSDNX 00000001 $SDN_VER 1 Mapping version number 0000 0 Signed 2 $SDN_HDRL Header length (in bytes) 0002 2 Signed 2 $SDN_BITL Length of mapped bits (in bytes) 0004 4 Signed 4 * Reserved for future use 00000008 $SDN_HDLN *-$SDNX Length of header (bytes) Bit map: Contains the SDNX flags that are subject to relocation. These bits are defined sequentially, regardless of how they are defined in HCPSDNX. 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 $SDN_BITS (0) Bit map area 00000000 $SDN_BLEN *-$SDN_BITS Length of bit map area Data: Contains all HCPSDNX 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. 0008 8 Bitstring 1 $SDN_DATA (0) Start of data map The following bits indicate the presence or absence of data associated with facilities that maintain state within the SDNX. 0008 8 Bitstring 1 $SDNFTR0 Features byte 0 1... .... $SDNFGSF X'80' $SDNFGSF GSF register data present .1.. .... $SDNFIBM1 X'40' $SDNFIBM1 Already in use by IBM 0009 9 Bitstring 1 $SDNFTR1 Features byte 1 000A 10 Bitstring 1 $SDNFTR2 Features byte 2 000B 11 Bitstring 1 $SDNFTR3 Features byte 3 000C 12 Bitstring 1 $SDNFTR4 Features byte 4 000D 13 Bitstring 1 $SDNFTR5 Features byte 5 000E 14 Bitstring 1 $SDNFTR6 Features byte 6 000F 15 Bitstring 1 $SDNFTR7 Features byte 7 The following areas are for the data associated with facilities that maintain state within the SDNX. 0010 16 Bitstring 32 $SDNXGSCB Guarded-storage control block 0030 48 Bitstring 16 $SDNXIBM1 Already in use by IBM 00000040 $SDN_LEN *-$SDNX Total length, in bytes 00000008 $SDN_SZ ($SDN_LEN+7)/8 Size in doublewords
 
 
  $SDNX Storage Layout Top of page
 
          
*** $SDNX - Relocation mapping for HCPSDNX
*
*     +-------------+-------------+---------------------------+
*   0 | $SDN_HDRL   | $SDN_BITL   |///////////////////////////|
*     +------+------+------+------+------+------+------+------+
*   8 |:NFTR0|:NFTR1|:NFTR2|:NFTR3|:NFTR4|:NFTR5|:NFTR6|:NFTR7|
*     +------+------+------+------+------+------+------+------+
*  10 |                                                       |
*     =                      $SDNXGSCB                        =
*     |                                                       |
*     +-------------------------------------------------------+
*  30 |                      $SDNXIBM1                        |
*     |                                                       |
*     +-------------------------------------------------------+
*  40
*
*** $SDNX - Relocation mapping for HCPSDNX
 
 
  $SDNX Cross Reference Top of page
 
 
Symbol         Dspl Value
-------------- ---- -----
$SDN_BITL      0002
$SDN_BITS      0008
$SDN_BLEN      0008 00000000
$SDN_DATA      0008
$SDN_HDLN      0004 00000008
$SDN_HDRL      0000
$SDN_LEN       0030 00000040
$SDN_SZ        0030 00000008
$SDN_VER       0000 00000001
$SDNFGSF       0008 80
$SDNFIBM1      0008 40
$SDNFTR0       0008
$SDNFTR1       0009
$SDNFTR2       000A
$SDNFTR3       000B
$SDNFTR4       000C
$SDNFTR5       000D
$SDNFTR6       000E
$SDNFTR7       000F
$SDNXGSCB      0010
$SDNXIBM1      0030
 
This information is based on z/VM 7.3.0 Last updated on 22 Jun 2022 at 15:58:59 EDT.
Copyright IBM Corporation, 1990, 2022