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

MRUSECPC

Prolog
Control Block Contents
Cross Reference

MRUSECPC Prolog

 DSECT NAME - USECPC
 FUNCTION - Map a Monitor record.
 LOCATED BY -
           Through the Monitor Control Area
 REFERENCED CONTROL BLOCKS -
        MRRECHDR    Monitor Record Header
 NAME - MRUSECPC
 DESCRIPTIVE NAME - Monitor Event Record
                    Domain 4  - User Domain
                    Record 13 - CPU Pool Change
 DESCRIPTION - Records all changes made to a user's CPU pool
               whether made by a SCHEDULE command, LOGOFF,
               or a user relocation (VMRELOCATE command).
               A user who is assigned to a CPU pool and is
               relocated to another system will generate a
               D4R13 LOGOFF/VMRELOCATE remove record on the
               source system when he leaves that CPU pool
               and will generate a D4R13 SCHEDULE/VMRELOCATE
               ADD record on the destination system when
               he joins that CPU pool.
               Generated only if the user who is the target
               of the command is enabled for user domain
               (not to be confused with the user that issued
               the SCHEDULE or VMRELOCATE command).

MRUSECPC Control Block Contents

Offsets
Dec  Hex  Type        Len  Name (Dim)             Description
 
   0   0  Structure    48  USECPC                 Start of monitor record.
   0   0  Character     0  USECPC_MRHDR           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  USECPC_VMDUSER         Userid.
  28  1C  Bitstring     1  *                      Reserved for IBM use.
  29  1D  Unsigned      1  USECPC_COMMAND         What command/action caused
                                                  the change in CPU Pool? Valid
                                                  values: X'01' - SCHEDULE or
                                                  VMRELOCATE added user to CPU
                                                  pool X'02' - SCHEDULE moved
                                                  user from one CPU to another
                                                  X'03' - SCHEDULE removed user
                                                  from a CPU pool X'04' -
                                                  VMRELOCATE or LOGOFF removed
                                                  user from a CPU pool
  30  1E  Character     2  *                      Reserved for IBM use.
  32  20  Character     8  USECPC_PREVPOOL        Previous CPU pool that the
                                                  user was assigned to. X'00'
                                                  if user was not in a CPU
                                                  pool.
  40  28  Character     8  USECPC_CURRPOOL        Current CPU pool that the
                                                  user is assigned to. X'00' if
                                                  user is no longer in a CPU
                                                  pool.
  48  30  Character     0  USECPC_END

MRUSECPC 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
USECPC                     0     48
USECPC_COMMAND            1D      1
USECPC_CURRPOOL           28      8
USECPC_END                30      0
USECPC_MRHDR               0      0
USECPC_PREVPOOL           20      8
USECPC_VMDUSER            14      8

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

Last updated on 08 August 2020 at 14:42:45.
Copyright IBM Corporation, 1990, 2020