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