|
Hex Dec Type/Val Lng Label (dup) Comments
---- ---- --------- ---- -------------- --------
0000 0 Structure $APMBK Relocation mapping for HCPAPMBK
00000001 $APM_VER 1 Mapping version number
0000 0 Signed 2 $APM_HDRL Header length (in bytes)
0002 2 Signed 2 $APM_BITL Length of mapped bits (in bytes)
0004 4 Signed 4 * Reserved for future use
00000008 $APM_HDLN *-$APMBK Length of header (bytes)
Bit map: Contains the APMBK flags that are subject to
relocation. These bits are defined sequentially,
regardless of how they are defined in HCPAPMBK.
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 $APM_BITS (0) Bit map area
0008 8 Bitstring 1 $APM0
1... .... $APM0VNQS X'80' $APM0VNQS APMFL0
.1.. .... $APM0VNQD X'40' $APM0VNQD APMFL0
..1. .... $APM0VDQS X'20' $APM0VDQS APMFL0
...1 .... $APM0VDQD X'10' $APM0VDQD APMFL0
.... 1... $APM0RNQS X'08' $APM0RNQS APMFL0
.... .1.. $APM0RNQD X'04' $APM0RNQD APMFL0
.... ..1. $APM0RDQS X'02' $APM0RDQS APMFL0
.... ...1 $APM0RDQD X'01' $APM0RDQD APMFL0
0009 9 Bitstring 1 $APM1
.... .1.. $APM1INDQ X'04' $APM1INDQ APMFL1
.... ..1. $APM1INNQ X'02' $APM1INNQ APMFL1
.... ...1 $APM1TOSS X'01' $APM1TOSS APMFL1
00000002 $APM_BLEN *-$APM_BITS Length of bit map
area
Data: Contains all HCPAPMBK 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.
000A 10 Bitstring 1 $APM_DATA (0) Start of data map
000A 10 Bitstring 4 $APM_ITEM Slot number in APVARRAY
(1-origin)
000E 14 Bitstring 4 $APM_NEXT ->RDO offset to next $APMBK
APMAPVBK - copy from VMDAPVBK on destination
0012 18 Bitstring 8 $APMPSMID Guest PSMID
001A 26 Bitstring 8 $APMNVT Host TOD of virtual NQAP
0022 34 Bitstring 8 $APMNRT Host TOD of real NQAP
002A 42 Bitstring 4 $APMNQCRS Relative message cursor
002E 46 Bitstring 4 $APMNQDL Total data length of message
0032 50 Bitstring 4 $APMNADLN ->RDO offset to first NQ
APMADLN
0036 54 Bitstring 8 $APMDVT Host TOD of virtual DQAP
003E 62 Bitstring 8 $APMDRT Host TOD of real DQAP
0046 70 Bitstring 4 $APMDQCRS Relative message cursor
004A 74 Bitstring 4 $APMDQRL Residual length for DQAP
004E 78 Bitstring 4 $APMDQDL Total data length of message
0052 82 Bitstring 4 $APMDADLN ->RDO offset to first DQ
APMADLN
00000056 $APM_LEN *-$APMBK Total length, in bytes
0000000B $APM_SZ ($APM_LEN+7)/8 Size in
doublewords
| |