Programming Interface Information:
The Monitor Records are intended Programming Interfaces that
allow the customer to write programs to obtain services of z/VM.
Control Block Contents
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 V6R4.0.
Last updated on 5 Oct 2016 at 13:19:45.
Copyright IBM Corporation, 1990, 2016