Programming Interface Information:
The Monitor Records are intended Programming Interfaces that allow the customer to write programs to obtain services of z/VM. |
MRSYTPRP
PrologControl Block Contents
Cross Reference
MRSYTPRP Prolog
DSECT NAME - SYTPRP FUNCTION - Map a Monitor record. LOCATED BY - Through the Monitor control area REFERENCED CONTROL BLOCKS - MRRECHDR Monitor Record Header NAME - MRSYTPRP DESCRIPTIVE NAME - Monitor Sample Record Domain 0 - System Domain Record 2 - Processor Data (Per Processor) DESCRIPTION - Real System or CPU operation exception. A separate record is generated for each online processor.
MRSYTPRP Control Block Contents
Offsets Dec Hex Type Len Name (Dim) Description 0 0 Structure 108 SYTPRP Start of monitor record 0 0 Character 0 SYTPRP_MRHDR 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 Unsigned 2 SYTPRP_PFXCPUAD Real processor's CPU address 22 16 Unsigned 2 SYTPRP_PLSCUHAF Count of times a VMDBK was dispatched with 'hard affinity' (i.e., dedicated to this processor) 24 18 Character 8 SYTPRP_PFXPRBTM Total CPU time spent in emulation mode on this processor for all users 32 20 Character 8 SYTPRP_PFXUTIME Total CPU time spent on this processor which was charged to users. It includes both time spent running the guest and time that CP spends on behalf of a user doing such things as instruction simulation or page translation. This is in CPU time, not elapsed (or wall clock) time. 40 28 Character 8 SYTPRP_PFXTMSYS Total CPU time spent on this processor which has been charged to the system instead of the user. In general, this is processing that is inappropriate to charge to any one particular user. Examples include portions of the following functions: scheduling decisions, handling interruptions, monitoring, and page migration. 48 30 Character 8 * Reserved for IBM use. Previous field is no longer meaningful. (SYTPRP_PLSVFVTM) 56 38 Character 8 * Reserved for IBM use. Previous field is no longer meaningful. (SYTPRP_PLSVFOTM) 64 40 Unsigned 4 * Reserved for IBM use. Previous field is no longer meaningful. (SYTPRP_PLSVFLOD) 68 44 Character 8 SYTPRP_PFXTOTWT Total system wait time on this CPU (includes both active wait and enabled CPU wait). It is the time this CPU had no work to do, measured in CPU time. 76 4C Unsigned 4 SYTPRP_PFXRUNCI Count of interceptions from SIE on this processor. It does NOT include interceptions from SIE instructions issued in order to run a 'Vguest', i.e., a guest of a guest, during guest SIE simulation. It does NOT include interceptions handled by the fast-path simulation support code. 80 50 Unsigned 4 SYTPRP_PFXRUNPF Count of host page faults on this processor resulting from guest references to storage paged out by CP. Does not include faults on RCP pages 84 54 Unsigned 4 SYTPRP_PFXRUNCP Count of instructions from SIE on this processor. It does not include instructions issued in order to run a 'Vguest', i.e., a guest of a guest, during guest SIE simulation. It does not include instructions issued following a successful fast-path simulation support code. 88 58 Unsigned 4 SYTPRP_CALFSTPH Count of fast-path instruction simulations. PFXFSTSG + PFXFSTXC + PFXFST44 92 5C Character 8 SYTPRP_PFXSPINT Elapsed time in formal spin locks on this real CPU starting at zero and counting upwards. This is measured in TOD clock units since system IPL. 100 64 Unsigned 4 SYTPRP_PFXSPINC Count of spin lock requests on this real CPU since IPL that were not granted immediately. The lock was obtained only after spinning. 104 68 Unsigned 1 SYTPRP_PFXCPUTY CPU Type. Valid values: X'00' - General Purpose (CP) X'02' - zSeries Application Assist (zAAP) X'03' - Integrated Facility for Linux (IFL) X'05' - zSeries Integrated Information (zIIP) 105 69 Character 3 * Reserved for IBM use 108 6C Character 0 SYTPRP_END
MRSYTPRP 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 SYTPRP 0 108 SYTPRP_CALFSTPH 58 4 SYTPRP_END 6C 0 SYTPRP_MRHDR 0 0 SYTPRP_PFXCPUAD 14 2 SYTPRP_PFXCPUTY 68 1 SYTPRP_PFXPRBTM 18 8 SYTPRP_PFXRUNCI 4C 4 SYTPRP_PFXRUNCP 54 4 SYTPRP_PFXRUNPF 50 4 SYTPRP_PFXSPINC 64 4 SYTPRP_PFXSPINT 5C 8 SYTPRP_PFXTMSYS 28 8 SYTPRP_PFXTOTWT 44 8 SYTPRP_PFXUTIME 20 8 SYTPRP_PLSCUHAF 16 2
This information is based on z/VM V5R3.0.
Last updated on 12 Jun 2007 at 12:35:23.
Copyright IBM Corporation, 1990, 2007