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