Programming Interface Information:
This information is NOT intended to be used as Programming Interfaces of z/VM. |
$IPRML
Control Block Contents
$IPRML DSECT
Cross Reference (Contains links to field and bit definitions)
$IPRML Prolog
NAME : LGRIPRML DESCRIPTION: Relocation mapping for IPARML DSECT : $IPRML FUNCTION : LGRIPRML describes those fields of the IPRML 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 IPARML COPY 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.
$IPRML Control Block Content
$IPRML DSECT
Hex Dec Type/Val Lng Label (dup) Comments ---- ---- --------- ---- -------------- -------- 0000 0 Structure $IPRML Relocation mapping for IPARML 00000001 $PRM_VER 1 Mapping version number 0000 0 Signed 2 $PRM_HDRL Header length (in bytes) 0002 2 Signed 2 $PRM_BITL Length of mapped bits (in bytes) 0004 4 Signed 4 * Reserved for future use 00000008 $PRM_HDLN *-$IPRML Length of header (bytes) Bit map: Contains the IPRML flags that are subject to relocation. These bits are defined sequentially, regardless of how they are defined in IPARML. 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 $PRM_BITS (0) Bit map area 00000000 $PRM_BLEN *-$PRM_BITS Length of bit map area Data: Contains all IPARML 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 $PRM_DATA (0) Start of data map 0008 8 Bitstring 2 $IPPATHID Path ID 000A 10 Bitstring 1 $IPFLAGS1 Flags 000B 11 Bitstring 1 $IPCPSYS CP system service identifier 000C 12 Bitstring 2 $IPMSGLIM Message limit 000E 14 Bitstring 4 $IPNEXT -> RDO offset to next $IPRML 00000012 $PRM_LEN *-$IPRML Total length, in bytes 00000003 $PRM_SZ ($PRM_LEN+7)/8 Size in doublewords
$IPRML Storage Layout
*** $IPRML - Relocation mapping for IPARML * * +-------------+-------------+---------------------------+ * 0 | $PRM_HDRL | $PRM_BITL |///////////////////////////| * +-------------+------+------+-------------+-------------+ * 8 | $IPPATHID |(00A) |:CPSYS| $IPMSGLIM | $IPNEXT- | * +-------------+------+------+-------------+-------------+ * 10 | -(00E) | 12 * +-------------+ * *** $IPRML - Relocation mapping for IPARML
$IPRML Cross Reference
Symbol Dspl Value -------------- ---- ----- $IPCPSYS 000B $IPFLAGS1 000A $IPMSGLIM 000C $IPNEXT 000E $IPPATHID 0008 $PRM_BITL 0002 $PRM_BITS 0008 $PRM_BLEN 0008 00000000 $PRM_DATA 0008 $PRM_HDLN 0004 00000008 $PRM_HDRL 0000 $PRM_LEN 000E 00000012 $PRM_SZ 000E 00000003 $PRM_VER 0000 00000001
Copyright IBM Corporation, 1990, 2011