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

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

 $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 Storage Layout Top of page
*** $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
  $MSVBK Cross Reference Top of page
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
This information is based on z/VM 6.3.0 Last updated on 22 May 2013 at 13:56:37 EDT.
Copyright IBM Corporation, 1990, 2013