| |
Hex Dec Type/Val Lng Label (dup) Comments
---- ---- --------- ---- -------------- --------
0000 0 Structure $MSGBK Relocation mapping for HCPMSGBK
00000001 $MSG_VER 1 Mapping version number
0000 0 Signed 2 $MSG_HDRL Header length (in bytes)
0002 2 Signed 2 $MSG_BITL Length of mapped bits (in bytes)
0004 4 Signed 4 * Reserved for future use
00000008 $MSG_HDLN *-$MSGBK Length of header (bytes)
Bit map: Contains the MSGBK flags that are subject to
relocation. These bits are defined sequentially,
regardless of how they are defined in HCPMSGBK.
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 $MSG_BITS (0) Bit map area
00000000 $MSG_BLEN *-$MSG_BITS Length of bit map
area
Data: Contains all HCPMSGBK 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 $MSG_DATA (0) Start of data map
0008 8 Bitstring 4 $MSGFPNT -> RDO offset to next $MSGBK
000C 12 Bitstring 4 $MSGTGCLS TARGET MESSAGE CLASS
0010 16 Bitstring 4 $MSGSNDAD -> RDO offset to message data
0014 20 Bitstring 4 $MSGSNDLN SEND BUFFER LENGTH
00000018 $MSG_LEN *-$MSGBK Total length, in bytes
00000003 $MSG_SZ ($MSG_LEN+7)/8 Size in
doublewords
| |