Programming Interface Information: The Monitor Records are intended Programming Interfaces that allow the customer to write programs to obtain services of z/VM.

#### MRUSERLS

Prolog
Control Block Contents
Cross Reference

#### MRUSERLS Prolog

     DSECT NAME - USERLS
     FUNCTION - Map a Monitor record.
     LOCATED BY -
            Through the Monitor Control Area
     REFERENCED CONTROL BLOCKS -
            MRRECHDR    Monitor Record Header
     COMMENTS -
       If new fields are added to this record, it is possible that
       the relocation code that sends this data to the destination
       system may need to be updated.  This could be in either the
       HCPRLOSR/HCPRLORR and/or the HCPRLURS/HCPRLURD pairs of
       entry points.
     NAME - MRUSERLS
     DESCRIPTIVE NAME - Monitor Event Record
            Domain 4  - User domain
            Record 11 - Guest relocation started
     DESCRIPTION - Indicates the start of a guest relocation and
                   the command options specified to initiate the
                   relocation.

#### MRUSERLS Control Block Contents

    Offsets
    Dec  Hex  Type        Len  Name (Dim)             Description

       0   0  Structure    72  USERLS                 Start of monitor record
       0   0  Character     0  USERLS_CALMRHDR        Record header. See MRRECHDR
                                                      for details.
       0   0  Character    20  MRHDR
       0   0  Unsigned      2  MRHDRLEN
       2   2  Unsigned      2  MRHDRZER
       4   4  Unsigned      1  MRHDRDM
       5   5  Unsigned      1  *
       6   6  Unsigned      2  MRHDRRC
       8   8  Character     8  MRHDRTOD
      16  10  Character     4  *
      20  14  Character     0  MRHDR_END
      20  14  Character     8  USERLS_RLOISSUER       VMRELOCATE cmd issuer
      28  1C  Character     8  USERLS_RLOUSER         Userid of relocation target
      36  24  Character     8  USERLS_RLOSRCSYS       Name of source system
      44  2C  Character     8  USERLS_RLODSTSYS       Name of destination system
      52  34  Character     8  USERLS_RLOSTARTM       Time of start of relocation
                                                      in TOD units
      60  3C  Signed        4  USERLS_RLOMAXT         MAXTOTAL time (seconds)
      64  40  Signed        4  USERLS_RLOMAXQ         MAXQUIESCE time (seconds)
      68  44  Bitstring     1  USERLS_LCLFLAGS        Local relocation info flags
              1... ....        USERLS_RLOMOVSRC        This record was cut on the
                                                      source system
              .1.. ....        *
              ..1. ....        *
              ...1 ....        *
              .... 1...        *
              .... .1..        *
              .... ..1.        *
              .... ...1        *
      69  45  Bitstring     1  USERLS_RLOMVOPT        Flag byte for cmd options
              1... ....        USERLS_RLOMVFA          FORCE ARCH specified
              .1.. ....        USERLS_RLOMVFD          FORCE DOMAIN specified
              ..1. ....        USERLS_RLOMVFS          FORCE STORAGE specified
              ...1 ....        USERLS_RLOMVASN         ASYNCH was requested
              .... 1...        USERLS_RLONLIMT         NOLIMIT requested for
                                                      MAXTOTAL
              .... .1..        USERLS_RLONLIMQ         NOLIMIT requested for
                                                      MAXQUIESCE
              .... ..1.        USERLS_RLOIMMED         IMMEDIATE was specified
              .... ...1        *
      70  46  Bitstring     1  USERLS_VMDSTRLO        SET VMRELOCATE flags (valid
                                                      only in the base VMDBK
              1... ....        USERLS_VMDRLONA         This virtual machine has
                                                      SET VMRELOCATION OFF
              .1.. ....        *
              ..1. ....        *
              ...1 ....        *
              .... 1...        *
              .... .1..        *
              .... ..1.        *
              .... ...1        *
      71  47  Bitstring     1  *                      Reserved for IBM use
      72  48  Character     0  USERLS_END

#### MRUSERLS Cross Reference

                          Hex           Hex
    Name                  Offset Length Value

    MRHDR                      0     20
    MRHDR_END                 14      0
    MRHDRDM                    4      1
    MRHDRLEN                   0      2
    MRHDRRC                    6      2
    MRHDRTOD                   8      8
    MRHDRZER                   2      2
    USERLS                     0     72
    USERLS_CALMRHDR            0      0
    USERLS_END                48      0
    USERLS_LCLFLAGS           44      1
    USERLS_RLODSTSYS          2C      8
    USERLS_RLOIMMED           45           02
    USERLS_RLOISSUER          14      8
    USERLS_RLOMAXQ            40      4
    USERLS_RLOMAXT            3C      4
    USERLS_RLOMOVSRC          44           80
    USERLS_RLOMVASN           45           10
    USERLS_RLOMVFA            45           80
    USERLS_RLOMVFD            45           40
    USERLS_RLOMVFS            45           20
    USERLS_RLOMVOPT           45      1
    USERLS_RLONLIMQ           45           04
    USERLS_RLONLIMT           45           08
    USERLS_RLOSRCSYS          24      8
    USERLS_RLOSTARTM          34      8
    USERLS_RLOUSER            1C      8
    USERLS_VMDRLONA           46           80
    USERLS_VMDSTRLO           46      1

    This information is
    based on z/VM V7R2.0.

    Last updated on 05 August 2020 at 20:48:43.

    Copyright IBM Corporation, 1990, 2020