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 V7R3.0.

Last updated on 09 September 2022 at 12:33:05.
Copyright IBM Corporation, 1990, 2022