Programming Interface Information:
This information is NOT intended to be used as Programming Interfaces of z/VM. |
RLMSG
Control Block Contents
RLMSG DSECT
RLMAS DSECT
RLMBP DSECT
RLMDE DSECT
RLMLG DSECT
Cross Reference (Contains links to field and bit definitions)
RLMSG Control Block Content
RLMSG DSECT
Hex Dec Type/Val Lng Label (dup) Comments ---- ---- --------- ---- -------------- -------- 0000 0 Structure RLMSG LGR Memory Move Message DSECTs For message requests, the high order bit of the 1-byte message type in RLMSCODE will be 0. For message replies, The high order bit of the 1-byte message type in RLMSCODE will be 1. 0000 0 Bitstring 1 RLMSMHDR (0) Message Header 0000 0 Bitstring 1 RLMSCODE Message type 00000000 RLMSMM X'00' RLMSMM Memory Move 00000001 RLMSCMPS X'01' RLMSCMPS Memory Move Complete 00000002 RLMSCLRT X'02' RLMSCLRT Clear throttle 00000003 RLMSETTH X'03' RLMSETTH Set throttle 00000080 RLMSKRDY X'80' RLMSKRDY Socket setup complete 00000081 RLMSCMPD X'81' RLMSCMPD Send/recv counts match/Mem Move complete 00000082 RLMSVCSD X'82' RLMSVCSD Send/recv counts match 00000083 RLMSVCFD X'83' RLMSVCFD Send/recv counts don't match 00000084 RLMSCKOK X'84' RLMSCKOK Eligibility checks successful 00000085 RLMSCKBD X'85' RLMSCKBD Eligibility checks unsuccessful 00000086 RLMSCROK X'86' RLMSCROK Create spaces successful 00000087 RLMSCRBD X'87' RLMSCRBD Create spaces failure 000000FF RLMSVERD X'FF' RLMSVERD Message version incompatible 0001 1 Bitstring 1 RLMSSTAT Copy of RLOSTATUS on the source side at the time of transmission 0002 2 Bitstring 1 RLMSVRSN Version number for request messages (except for RLMSMM whose version is established when socket is created) Also used to hold destination's msg version for response RLMSVERD (msg versions incompatible) 0003 3 Bitstring 1 * Reserved 0004 4 Signed 4 * Reserved for future IBM use 00000001 RLMSSIZE (*-RLMSG+7)/8 Size in doublewords 00000008 RLMSBSZE RLMSSIZE*8 Size in bytes
RLMAS DSECT
Hex Dec Type/Val Lng Label (dup) Comments ---- ---- --------- ---- -------------- -------- 0000 0 Structure RLMAS LGR Memory Move Message DSECTs 0000 0 Bitstring 8 RLMAHEAD Imbed RLMSG header 0008 8 Dbl-Word 8 RLMACNTR Count of sends on the source system 0010 16 Signed 4 RLMAMXRVP Reserved frames on source system (VMDMXRVP) 0014 20 Signed 4 * Reserved for IBM use The amount of standby and reserved storage is sent because the guest can use the DEFINE STORAGE STANDBY command to change the amount of standby storage in element 1 even when a relocation is in progress. Other forms of DEFINE STORAGE, (those that cause a SYSTEM RESET to occur) will terminate a relocation in progress. 0018 24 Signed 2 RLMAEL1st Element 1 standby (ASCEL1st) 001A 26 Signed 2 RLMAEL1rs Element 1 reserved (ASCEL1rs) 001C 28 Bitstring 1 RLMASTAT Current state (ASCSTATE) 001D 29 Bitstring 1 * (3) Reserved for IBM use Cumulative historical counts when address space is private 0020 32 Signed 4 RLMAPPST Count of private address space pages stolen (ASCCPPST) 0024 36 Signed 4 RLMAPPGR Count of private address space pages read from DASD (ASCCPPGR) 0028 40 Signed 4 RLMAPPGW Count of private address space pages written to DASD (ASCCPPGW) 002C 44 Signed 4 RLMAPXRD Count of private address space pages read from XSTORE (ASCCPXRD) 0030 48 Signed 4 RLMAPXWT Count of private address space pages written to XSTORE (ASCCPXWT) 0034 52 Signed 4 RLMAPMIG Count of private address space pages migrated by CP from XSTORE to DASD (ASCCPMIG) 0038 56 Signed 4 * Reserved for IBM use 003C 60 Signed 4 * Reserved for IBM use Cumulative historical counts when address space is shared 0040 64 Signed 4 RLMATRSH Cumulative count of page translations for shared pages (ASCPTRSH) 0044 68 Signed 4 RLMASPST Count of shared address space pages stolen (ASCCSPST) 0048 72 Signed 4 RLMASPGR Count of shared address space pages read from DASD (ASCCSPGR) 004C 76 Signed 4 RLMASPGW Count of shared address space pages written to DASD (ASCCSPGW) 0050 80 Signed 4 RLMASXRD Count of shared address space pages read from XSTORE (ASCCSXRD) 0054 84 Signed 4 RLMASXWT Count of shared address space pages written to XSTORE (ASCCSXWT) 0058 88 Signed 4 RLMASMIG Count of shared address space pages migrated by CP from XSTORE to DASD (ASCCSMIG) 005C 92 Signed 4 * Reserved for IBM use 0060 96 Signed 4 * Reserved for IBM use 0064 100 Signed 4 * Reserved for future IBM use 0000000D RLMASIZE (*-RLMAS+7)/8 Size in doublewords 00000068 RLMABSZE RLMASIZE*8 Size in bytes
RLMBP DSECT
Hex Dec Type/Val Lng Label (dup) Comments ---- ---- --------- ---- -------------- -------- 0000 0 Structure RLMBP LGR Memory Move Message DSECTs 0000 0 Bitstring 8 RLMBEYEC Eyecatcher "RLMBP==>" 0008 8 Bitstring 128 RLMBLbmp Start of bitmap (see ASCELbmp for details) 00000011 RLMBSIZE (*-RLMBP+7)/8 Size in doublewords 00000088 RLMBBSZE RLMBSIZE*8 Size in bytes
RLMDE DSECT
Hex Dec Type/Val Lng Label (dup) Comments ---- ---- --------- ---- -------------- -------- 0000 0 Structure RLMDE LGR Memory Move Message DSECTs 0000 0 Signed 8 RLMDENXT Pointer to next RLMDE on the stack 0008 8 Signed 4 RLMDERCD Error code (message number) if not successful 000C 12 Bitstring 1 RLMDFLGS Byte to hold miscellaneous flags 1... .... RLMDOVRI X'80' RLMDOVRI Indicates that this message can be overridden .1.. .... RLMDSPCR X'40' RLMDSPCR Indicates that this message represents an address-space creation failure ..1. .... RLMDVRER X'20' RLMDVRER Indicates that this message represents an LGR version mismatch 000D 13 Bitstring 1 RLMDCAPA Capacity-checking flag for this error. If this error isn't related to system capacity, then this is set to zero. Otherwise, its a copy of the flag set in RLOCAPCK set for this error. 000E 14 Bitstring 6 * Reserved for IBM use 0014 20 Bitstring 84 RLMDESUB Space for message substitution data 0000000D RLMDEDSZ (*-RLMDE+7)/8 Size in doublewords 00000068 RLMDEBSZ RLMDEDSZ*8 Size in bytes
RLMLG DSECT
Hex Dec Type/Val Lng Label (dup) Comments ---- ---- --------- ---- -------------- -------- 0000 0 Structure RLMLG LGR Memory Move Message DSECTs 0000 0 Bitstring 8 RLMLGHDR Eyecatcher for this block 0008 8 Dbl-Word 8 RLMLNPOH Count of nonpageable CP frames 0010 16 Dbl-Word 8 RLMLPGOH Count of pageable CP frames 0018 24 Dbl-Word 8 RLMLCRES Current number of resident frames in use by this guest 0020 32 Dbl-Word 8 RLMLCRXS Current number of XSTORE slots in use by this guest 0028 40 Dbl-Word 8 RLMLCRAX Current number of AUX pages in use by this guest 0030 48 Dbl-Word 8 * Reserved for IBM use 0038 56 Dbl-Word 8 RLMLCRFT Total current guest footprint 0040 64 Dbl-Word 8 RLMLMXFT Maximum guest footprint 0048 72 Bitstring 1 RLMLSTAT Current source value of RLOSTATS 0049 73 Bitstring 3 * Reserved for IBM use 004C 76 Signed 4 RLMLCRPS Current memory copy pass number 0000000A RLMLGDSZ (*-RLMLG+7)/8 Size in doublewords 00000050 RLMLGBSZ RLMLGDSZ*8 Size in bytes
RLMSG Storage Layout
*** RLMSG - LGR Memory Move Message DSECTs * * +------+------+------+------+---------------------------+ * 0 |:SCODE|:SSTAT|:SVRSN|//////|///////////////////////////| * +------+------+------+------+---------------------------+ * 8 * *** RLMSG - LGR Memory Move Message DSECTs *** RLMAS - LGR Memory Move Message DSECTs * * +-------------------------------------------------------+ * 0 | RLMAHEAD | * +-------------------------------------------------------+ * 8 | RLMACNTR | * +---------------------------+---------------------------+ * 10 | RLMAMXRVP |///////////////////////////| * +-------------+-------------+------+--------------------+ * 18 | RLMAEL1ST | RLMAEL1RS |:ASTAT|////////////////////| * +-------------+-------------+------+--------------------+ * 20 | RLMAPPST | RLMAPPGR | * +---------------------------+---------------------------+ * 28 | RLMAPPGW | RLMAPXRD | * +---------------------------+---------------------------+ * 30 | RLMAPXWT | RLMAPMIG | * +---------------------------+---------------------------+ * 38 |///////////////////////////|///////////////////////////| * +---------------------------+---------------------------+ * 40 | RLMATRSH | RLMASPST | * +---------------------------+---------------------------+ * 48 | RLMASPGR | RLMASPGW | * +---------------------------+---------------------------+ * 50 | RLMASXRD | RLMASXWT | * +---------------------------+---------------------------+ * 58 | RLMASMIG |///////////////////////////| * +---------------------------+---------------------------+ * 60 |///////////////////////////|///////////////////////////| * +---------------------------+---------------------------+ * 68 * *** RLMAS - LGR Memory Move Message DSECTs *** RLMBP - LGR Memory Move Message DSECTs * * +-------------------------------------------------------+ * 0 | RLMBEYEC | * +-------------------------------------------------------+ * 8 | | * = RLMBLBMP = * | | * +-------------------------------------------------------+ * 88 * *** RLMBP - LGR Memory Move Message DSECTs *** RLMDE - LGR Memory Move Message DSECTs * * +-------------------------------------------------------+ * 0 | RLMDENXT | * +---------------------------+------+------+-------------+ * 8 | RLMDERCD |:DFLGS|:DCAPA|/////////////| * +---------------------------+------+------+-------------+ * 10 |///////////////////////////| | * +---------------------------+ | * 18 | | * = RLMDESUB = * | | * +-------------------------------------------------------+ * 68 * *** RLMDE - LGR Memory Move Message DSECTs *** RLMLG - LGR Memory Move Message DSECTs * * +-------------------------------------------------------+ * 0 | RLMLGHDR | * +-------------------------------------------------------+ * 8 | RLMLNPOH | * +-------------------------------------------------------+ * 10 | RLMLPGOH | * +-------------------------------------------------------+ * 18 | RLMLCRES | * +-------------------------------------------------------+ * 20 | RLMLCRXS | * +-------------------------------------------------------+ * 28 | RLMLCRAX | * +-------------------------------------------------------+ * 30 |///////////////////////////////////////////////////////| * +-------------------------------------------------------+ * 38 | RLMLCRFT | * +-------------------------------------------------------+ * 40 | RLMLMXFT | * +------+--------------------+---------------------------+ * 48 |:LSTAT|////////////////////| RLMLCRPS | * +------+--------------------+---------------------------+ * 50 * *** RLMLG - LGR Memory Move Message DSECTs
RLMSG Cross Reference
Symbol Dspl Value -------------- ---- ----- RLMABSZE 0064 00000068 RLMACNTR 0008 RLMAEL1rs 001A RLMAEL1st 0018 RLMAHEAD 0000 RLMAMXRVP 0010 RLMAPMIG 0034 RLMAPPGR 0024 RLMAPPGW 0028 RLMAPPST 0020 RLMAPXRD 002C RLMAPXWT 0030 RLMASIZE 0064 0000000D RLMASMIG 0058 RLMASPGR 0048 RLMASPGW 004C RLMASPST 0044 RLMASTAT 001C RLMASXRD 0050 RLMASXWT 0054 RLMATRSH 0040 RLMBBSZE 0008 00000088 RLMBEYEC 0000 RLMBLbmp 0008 RLMBSIZE 0008 00000011 RLMDCAPA 000D RLMDEBSZ 0014 00000068 RLMDEDSZ 0014 0000000D RLMDENXT 0000 RLMDERCD 0008 RLMDESUB 0014 RLMDFLGS 000C RLMDOVRI 000C 80 RLMDSPCR 000C 40 RLMDVRER 000C 20 RLMLCRAX 0028 RLMLCRES 0018 RLMLCRFT 0038 RLMLCRPS 004C RLMLCRXS 0020 RLMLGBSZ 004C 00000050 RLMLGDSZ 004C 0000000A RLMLGHDR 0000 RLMLMXFT 0040 RLMLNPOH 0008 RLMLPGOH 0010 RLMLSTAT 0048 RLMSBSZE 0004 00000008 RLMSCKBD 0000 00000085 RLMSCKOK 0000 00000084 RLMSCLRT 0000 00000002 RLMSCMPD 0000 00000081 RLMSCMPS 0000 00000001 RLMSCODE 0000 RLMSCRBD 0000 00000087 RLMSCROK 0000 00000086 RLMSETTH 0000 00000003 RLMSKRDY 0000 00000080 RLMSMHDR 0000 RLMSMM 0000 00000000 RLMSSIZE 0004 00000001 RLMSSTAT 0001 RLMSVCFD 0000 00000083 RLMSVCSD 0000 00000082 RLMSVERD 0000 000000FF RLMSVRSN 0002
Copyright IBM Corporation, 1990, 2011