| |
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
| |