NAME       : LGRMSVBK
 DESCRIPTION: Relocation mapping for HCPMSVBK
 DSECT      : $MSVBK
 FUNCTION   : LGRMSVBK describes those fields of the MSVBK 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 HCPMSVBK 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.

 $MSVBK DSECT
Top of page

Hex   Dec Type/Val   Lng Label (dup)    Comments
---- ---- --------- ---- -------------- --------
0000    0 Structure      $MSVBK         Relocation mapping for HCPMSVBK
          00000001       $MSV_VER       1 Mapping version number
0000    0 Signed       2 $MSV_HDRL      Header length (in bytes)
0002    2 Signed       2 $MSV_BITL      Length of mapped bits (in bytes)
0004    4 Signed       4 *              Reserved for future use
          00000008       $MSV_HDLN      *-$MSVBK Length of header (bytes)
      Bit map: Contains the MSVBK flags that are subject to
               relocation. These bits are defined sequentially,
               regardless of how they are defined in HCPMSVBK.
               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.
      SPECIAL NOTES      :
      The three flag bytes MSVCFL, MSVPFL, and MSVAFL, all have
      the same bits defined. Since the bit names here need to be
      unique, they have been slightly renamed, as follows:
       MSVXnnnn becomes $MSXCxxxx for MSVCFL
                becomes $MSVPxxxx for MSVPFL
                becomes $MSVAxxxx for MSVAFL
      This also means these bits will be encoded using the
      extended form of the MAPBIT macro.
0008    8 Signed       2 $MSV_BITS (0)  Bit map area
      NOTES      : MSVBK is somewhat different from other control blocks
            in that it was designed with relocation in mind. Thus
            we do not relocate the flag bits discretely, so there
            are no definitions in this section.
          00000000       $MSV_BLEN      *-$MSV_BITS Length of bit map
                                        area
      Data:    Contains all HCPMSVBK 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.
0008    8 Bitstring    1 $MSV_DATA (0)  Start of data map
0008    8 Bitstring    4 $MSVNEXT       -> RDO offset of chained
                                        $MSVBK
000C   12 Bitstring    2 $MSVDEV#       Device number
000E   14 Bitstring    1 $MSVSTAT       MSVBK status flag
000F   15 Bitstring    1 $MSVMACPR      Current MACProtect setting
0010   16 Bitstring    2 $MSVROWN       SSI Slot ID of owning system
0012   18 Bitstring    6 $MSVCMAC       Current MAC address
0018   24 Bitstring    1 $MSVCFL        CURRENT MAC Services Flag
0019   25 Bitstring    6 $MSVPMAC       Pending MAC address
001F   31 Bitstring    1 $MSVPFL        Pending MAC Services Flag
0020   32 Bitstring    6 $MSVAMAC       Adapter MAC address field
0026   38 Bitstring    1 $MSVAFL        Current MAC Services Flag
0027   39 Bitstring    8 $MSVUSER       8 Byte EBCDIC of Owning User
          0000002F       $MSV_LEN       *-$MSVBK Total length, in bytes
          00000006       $MSV_SZ        ($MSV_LEN+7)/8 Size in
                                        doublewords

          
*** $MSVBK - Relocation mapping for HCPMSVBK
*
*     +-------------+-------------+---------------------------+
*   0 | $MSV_HDRL   | $MSV_BITL   |///////////////////////////|
*     +-------------+-------------+-------------+------+------+
*   8 |         $MSVNEXT          |  $MSVDEV#   |:VSTAT|(00F) |
*     +-------------+-------------+-------------+------+------+
*  10 |  $MSVROWN   |                $MSVCMAC                 |
*     +------+------+----------------------------------+------+
*  18 |:VCFL |                $MSVPMAC                 |:VPFL |
*     +------+----------------------------------+------+------+
*  20 |                $MSVAMAC                 |:VAFL |(027)-|
*     +-----------------------------------------+------+------+
*  28 |                   -$MSVUSER                    | 2F
*     +------------------------------------------------+
*
*** $MSVBK - Relocation mapping for HCPMSVBK

 
Symbol         Dspl Value
-------------- ---- -----
$MSV_BITL      0002
$MSV_BITS      0008
$MSV_BLEN      0008 00000000
$MSV_DATA      0008
$MSV_HDLN      0004 00000008
$MSV_HDRL      0000
$MSV_LEN       0027 0000002F
$MSV_SZ        0027 00000006
$MSV_VER       0000 00000001
$MSVAFL        0026
$MSVAMAC       0020
$MSVCFL        0018
$MSVCMAC       0012
$MSVDEV#       000C
$MSVMACPR      000F
$MSVNEXT       0008
$MSVPFL        001F
$MSVPMAC       0019
$MSVROWN       0010
$MSVSTAT       000E
$MSVUSER       0027