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
 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               record length in bytes
   2   2  Unsigned      2  MRHDRZER               field of zeros
   4   4  Unsigned      1  MRHDRDM                domain identifier
   5   5  Unsigned      1  *                      
   6   6  Unsigned      2  MRHDRRC                record identifier
   8   8  Character     8  MRHDRTOD               Time at which this record
                                                  was built. In time-of-day
                                                  (TOD) clock format. See IBM
                                                  System 370 XA Principle of
                                                  Operation for explanation of
                                                  format.
  16  10  Character     4  *                      
  20  14  Character     0  MRHDR_END              End of header
  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 V6R2.0.
Last updated on 23 Nov 2011 at 15:33:04.
Copyright IBM Corporation, 1990, 2011