RLMSG | Back to Index page

| Prolog Control Block Contents RLMSG DSECT RLMAS DSECT RLMBP DSECT RLMDE DSECT RLMLG DSECT Storage Layout Cross Reference (Contains links to field and bit definitions) |
Programming Interface Information: This information is NOT intended to be used as Programming Interfaces of z/VM.

RLMSG Control Block Content | Top of page

     RLMSG DSECT
    Top of page

    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
    Top of page

    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 RLMARLVL       Source VM release level - when
                                            zero, the source release is 6.2
                                            which was first release of LGR
              00000001       RLMAR63        1 Release 6.3 or later
    001E   30 Bitstring    1 RLMASLVL       Reserved for future IBM use -
                                            when zero, no service applied to
                                            RLMAS dsect
    001F   31 Bitstring    1 *              Reserved for IBM use
          Cumulative historical counts when address space is private.
          See additional counts below structured by z/VM release and
          service
    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.
          See additional counts below structured by z/VM release and
          service
    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 IBM use
          Cumulative historical counts when address space is private.
          Added for release 6.3.
    0068  104 Signed       4 RLMAPINT       Count of private instantiated
                                            pages.
    006C  108 Signed       4 RLMAPREL       Count of private pages whose
                                            frames were reclaimed without
                                            preserving the page content
                                            because of the guest page state
                                            (that is, CMM2 state or contents
                                            were released by the guest).
    0070  112 Signed       4 RLMAPINV       Count of private pages made IBR.
    0074  116 Signed       4 RLMAPPFI       Count of private IBR pages that
                                            were revalidated while on the
                                            frame owned list.
    0078  120 Signed       4 RLMAPPFA       Count of private IBR pages that
                                            were revalidated while on the
                                            global aging list.
    007C  124 Signed       4 RLMAPFRY       Count of private IBR pages on the
                                            global aging list that were
                                            already backed on auxiliary
                                            before the frames needed to be
                                            reclaimed.
    0080  128 Signed       4 RLMAPFNR       Count of private IBR pages on the
                                            global aging list that were
                                            written to XSTORE or auxiliary
                                            storage immediately prior to the
                                            frames being reclaimed.
    0084  132 Signed       4 RLMAPXRL       Count of XSTORE blocks released
                                            by migration when the private
                                            page contents was already in
                                            auxiliary storage. Updated by
                                            migration task (on master
                                            processor).
          Cumulative historical counts when address space is shared
          Added for release 6.3
    0088  136 Signed       4 RLMASINT       Count of shared instantiated
                                            pages.
    008C  140 Signed       4 RLMASREL       Count of shared pages whose
                                            frames were reclaimed without
                                            preserving the page content
                                            because of the guest page state
                                            (that is, CMM2 state or contents
                                            were released by the guest).
    0090  144 Signed       4 RLMASINV       Count of shared pages made IBR.
    0094  148 Signed       4 RLMASPFI       Count of shared IBR pages that
                                            were revalidated while on the
                                            frame owned list.
    0098  152 Signed       4 RLMASPFA       Count of shared IBR pages that
                                            were revalidated while on the
                                            global aging list.
    009C  156 Signed       4 RLMASFRY       Count of shared IBR pages on the
                                            global aging list that were
                                            already backed on auxiliary
                                            before the frames needed to be
                                            reclaimed.
    00A0  160 Signed       4 RLMASFNR       Count of shared IBR pages on the
                                            global aging list that were
                                            written to XSTORE or auxiliary
                                            storage immediately prior to the
                                            frames being reclaimed.
    00A4  164 Signed       4 RLMASXRL       Count of XSTORE blocks released
                                            by migration when the shared page
                                            contents was already in auxiliary
                                            storage.
              00000015       RLMASIZE       (*-RLMAS+7)/8 Size in doublewords
              000000A8       RLMABSZE       RLMASIZE*8 Size in bytes

     RLMBP DSECT
    Top of page

    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
    Top of page

    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
    Top of page

    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 | Top of page

    *** 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|:ARLVL|:ASLVL|//////|
    *     +-------------+-------------+------+------+------+------+
    *  20 |         RLMAPPST          |         RLMAPPGR          |
    *     +---------------------------+---------------------------+
    *  28 |         RLMAPPGW          |         RLMAPXRD          |
    *     +---------------------------+---------------------------+
    *  30 |         RLMAPXWT          |         RLMAPMIG          |
    *     +---------------------------+---------------------------+
    *  38 |///////////////////////////|///////////////////////////|
    *     +---------------------------+---------------------------+
    *  40 |         RLMATRSH          |         RLMASPST          |
    *     +---------------------------+---------------------------+
    *  48 |         RLMASPGR          |         RLMASPGW          |
    *     +---------------------------+---------------------------+
    *  50 |         RLMASXRD          |         RLMASXWT          |
    *     +---------------------------+---------------------------+
    *  58 |         RLMASMIG          |///////////////////////////|
    *     +---------------------------+---------------------------+
    *  60 |///////////////////////////|///////////////////////////|
    *     +---------------------------+---------------------------+
    *  68 |         RLMAPINT          |         RLMAPREL          |
    *     +---------------------------+---------------------------+
    *  70 |         RLMAPINV          |         RLMAPPFI          |
    *     +---------------------------+---------------------------+
    *  78 |         RLMAPPFA          |         RLMAPFRY          |
    *     +---------------------------+---------------------------+
    *  80 |         RLMAPFNR          |         RLMAPXRL          |
    *     +---------------------------+---------------------------+
    *  88 |         RLMASINT          |         RLMASREL          |
    *     +---------------------------+---------------------------+
    *  90 |         RLMASINV          |         RLMASPFI          |
    *     +---------------------------+---------------------------+
    *  98 |         RLMASPFA          |         RLMASFRY          |
    *     +---------------------------+---------------------------+
    *  A0 |         RLMASFNR          |         RLMASXRL          |
    *     +---------------------------+---------------------------+
    *  A8
    *
    *** 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 | Top of page

    Symbol         Dspl Value
    -------------- ---- -----
    RLMABSZE       00A4 000000A8
    RLMACNTR       0008
    RLMAEL1rs      001A
    RLMAEL1st      0018
    RLMAHEAD       0000
    RLMAMXRVP      0010
    RLMAPFNR       0080
    RLMAPFRY       007C
    RLMAPINT       0068
    RLMAPINV       0070
    RLMAPMIG       0034
    RLMAPPFA       0078
    RLMAPPFI       0074
    RLMAPPGR       0024
    RLMAPPGW       0028
    RLMAPPST       0020
    RLMAPREL       006C
    RLMAPXRD       002C
    RLMAPXRL       0084
    RLMAPXWT       0030
    RLMARLVL       001D
    RLMAR63        001D 00000001
    RLMASFNR       00A0
    RLMASFRY       009C
    RLMASINT       0088
    RLMASINV       0090
    RLMASIZE       00A4 00000015
    RLMASLVL       001E
    RLMASMIG       0058
    RLMASPFA       0098
    RLMASPFI       0094
    RLMASPGR       0048
    RLMASPGW       004C
    RLMASPST       0044
    RLMASREL       008C
    RLMASTAT       001C
    RLMASXRD       0050
    RLMASXRL       00A4
    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

This information is based on z/VM 7.2.0 Last updated on 24 Jun 2020 at 09:31:41 EDT.
Copyright IBM Corporation, 1990, 2020