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 - USEINT FUNCTION - Map a Monitor record. LOCATED BY - Through the Monitor Control Area REFERENCED CONTROL BLOCKS - MRRECHDR Monitor Record Header NAME - MRUSEINT DESCRIPTIVE NAME - Monitor Sample Record Domain 4 - User Domain Record 4 - User Interaction Data DESCRIPTION - Describes a VMDBK's use of the system. Included are such things as its use of IUCV, APPC and the number of times it occupied various queues. A separate record is generated for each VMDBK defined in the user's virtual complex. NOTES: - Fields labeled by the prefix, 'USEINT_HF', are high-frequency counters. - The following is the order of high-frequency counters in which the user is tested for its wait state. If the user is in more than one state, it is counted only in the first of the list. USEINT_HFIOWT USEINT_HFCFWT USEINT_HFSIMWT USEINT_HFWTPAG USEINT_HFLLIST USEINT_HFCPUWT USEINT_HFCPURN USEINT_HFESVM USEINT_HFLOAD USEINT_HFDORM USEINT_HFDSVM USEINT_HFIOACT USEINT_HFTIDL USEINT_HFTSVM USEINT_HFPGACT USEINT_HFOTHR
MRUSEINT Control Block ContentsOffsets Dec Hex Type Len Name (Dim) Description 0 0 Structure 228 USEINT Start of monitor record 0 0 Character 0 USEINT_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 Character 8 USEINT_VMDUSER User logon identification 28 1C Unsigned 2 USEINT_VMDCPUAD Processor address 30 1E Bitstring 1 USEINT_CALFLAG Flag byte 1... .... USEINT_CALBASE If on, this is the base VMDBK. VMDBASE .1.. .... USEINT_CALTRQFL If on, there is a TRQ block set to either time the user in a sleep state for a limited period of time or to time 15 minutes before logging off a disconnected user following an attempted display I/O (time bomb logoff). ..1. .... * ...1 .... * .... 1... * .... .1.. * .... ..1. * .... ...1 * 31 1F Unsigned 1 * Reserved for IBM use 32 20 Character 4 USEINT_CALINTRN 'YES ' = this VMDBK is currently contributing to a transaction. 'NO ' = this VMDBK is not currently contributing to a transaction. 'UNDE' = this VMDBK is currently idle and may or may not contribute to a transaction. 36 24 Unsigned 4 USEINT_VMDSVMFX Number of times the SVM-wait flag was left on at the end of a transaction and had to be corrected by the scheduler by resetting it. 40 28 Character 8 USEINT_VMDSVMID VMDBK name for the last successful IUCV, VMCF, or APPC/VM Send for this virtual machine. Valid in base VMDBK only. 48 30 Bitstring 1 USEINT_VMDSVMWT Service-virtual-machine (SVM) wait flag byte - valid in base VMDBK only. 1... .... USEINT_VMDSVMWF VMDBK is waiting for a response from IUCV, VMCF, or APPC. .1.. .... * ..1. .... * ...1 .... * .... 1... * .... .1.. * .... ..1. * .... ...1 * 49 31 Character 0 USEINT_VMDSVMW2 Back-up byte to the VMDSVMWT byte. Its contents will persist longer than they would in VMDSVMWT. Valid in base VMDBK only. 49 31 Bitstring 1 USEINT_VMDSVMWT Service-virtual-machine (SVM) wait flag byte - valid in base VMDBK only. 1... .... USEINT_VMDSVMWF VMDBK is waiting for a response from IUCV, VMCF, or APPC. 50 32 Character 0 USEINT_VMDRDYCM Flag byte set by IUCV, VMCF, or APPC whenever IUCV/VMCF/APPC makes an external interrupt. It is sort of a "reference byte" that tells the scheduler that IUCV/VMCF/APPC had been active recently. Valid in base VMDBK only. 50 32 Bitstring 1 USEINT_VMDSVMWT Service-virtual-machine (SVM) wait flag byte - valid in base VMDBK only. 1... .... USEINT_VMDSVMWF VMDBK is waiting for a response from IUCV, VMCF, or APPC. 51 33 Unsigned 1 * Reserved for IBM use 52 34 Unsigned 4 USEINT_HFQUCT Number of times VMDBK was high frequency sampled. 56 38 Unsigned 4 USEINT_HFDISP0 Number of times the VMDBK was in Q0. VMDSLIST = VMDDISPL and VMDELIST = 0. 60 3C Unsigned 4 USEINT_HFDISP1 Number of times the VMDBK was in Q1. VMDSLIST = VMDDISPL and VMDELIST = 1. 64 40 Unsigned 4 USEINT_HFDISP2 Number of times the VMDBK was in Q2. VMDSLIST = VMDDISPL and VMDELIST = 2. 68 44 Unsigned 4 USEINT_HFDISP3 Number of times the VMDBK was in Q3. VMDSLIST = VMDDISPL and VMDELIST = 3. 72 48 Unsigned 4 USEINT_HFELIG0 Number of times the VMDBK was in E0. VMDSLIST = VMDELIG and VMDELIST = 0. 76 4C Unsigned 4 USEINT_HFELIG1 Number of times the VMDBK was in E1. VMDSLIST = VMDELIG and VMDELIST = 1. 80 50 Unsigned 4 USEINT_HFELIG2 Number of times the VMDBK was in E2. VMDSLIST = VMDELIG and VMDELIST = 2. 84 54 Unsigned 4 USEINT_HFELIG3 Number of times the VMDBK was in E3. VMDSLIST = VMDELIG and VMDELIST = 3. 88 58 Unsigned 4 USEINT_HFSTCT Number of times VMDBK was high frequency sampled. This was once distinguishable from USEINT_HFQUCT but is now the same and is retained for migration or compatibility purposes. 92 5C Unsigned 4 USEINT_HFTIDL Count of times user was found in test idle and not in SVM wait 96 60 Unsigned 4 USEINT_HFTSVM Count of times user was found in test idle and in SVM wait 100 64 Unsigned 4 USEINT_HFIOWT Number of times this user was in synchronous I/O wait. This I/O wait indicates that a guest is waiting for I/O completion status and thus is prevented from running. VMDIOWT 104 68 Unsigned 4 USEINT_HFCFWT Number of times this user was found in console-function wait. During such a wait, the virtual cpu is not permitted to run. VMDCFWT 108 6C Unsigned 4 USEINT_HFSIMWT Number of times this user was found in 'simulation wait' in which the CPU is simulating some hardware functions such as instructions, interrupts, or timer updates, and the virtual machine is thus prevented from running to avoid potential conflicts with the simulations. VMDSIMWT 112 70 Unsigned 4 USEINT_HFWTPAG Count of times this user was found in page wait. Page wait is when the current guest instruction refers to a guest page which is not present in host storage and must be brought in from auxiliary storage. Page wait prevents the virtual CPU from running, however it is a "soft wait" condition, and as such can be cleared by a guest PSW swap. VMDWTPAG 116 74 Unsigned 4 USEINT_HFCPUWT Count of times this user was found waiting to run on the real processor. VMDSTATE = VMDREADY 120 78 Unsigned 4 USEINT_HFCPURN Count of times this user was found running on the real processor. VMDSTATE = VMDISPCH 124 7C Unsigned 4 USEINT_HFESVM Count of times this user was found in SVM wait and in the eligible list 128 80 Unsigned 4 USEINT_HFLOAD Count of times this user was considered a loading user. VMDLOADU = on and VMDSLIST ^= VMDDORM 132 84 Unsigned 4 USEINT_HFDORM Count of times this user was found dormant. VMDSLIST = VMDDORM 136 88 Signed 4 USEINT_HFDSVM Count of times this user was found in SVM wait and in the dormant list. Note: this count is also included in USEINT_HFDORM. VMDSVMWF of VMDSVMWT = on and VMDSLIST = VMDDORM 140 8C Unsigned 4 USEINT_HFOTHR Count of times this user was not found in any of the above states 144 90 Unsigned 2 USEINT_VMDCNTID Number of times user was not granted a test idle time when it went idle in the dispatch list 146 92 Unsigned 2 USEINT_VMDCTIDL Number of times this user was granted a test idle time when it went idle in the dispatch list 148 94 Unsigned 4 USEINT_VMDDFRWK Count of 'deferred' work items for the VMDBK. A 'deferred' work item is an asynchronous task that has yet to run. This VMDBK shall be prevented from completing its logoff until this count is zero, i.e., when all such work items have been run. 152 98 Bitstring 1 USEINT_VMDSTATE Scheduler/Dispatcher State. X'63' = Review-suspended. VMDBK is in transition to the suspended state. X'58' = Review-idle. VMDBK is in transition to the idle state. X'4D' = VMDBK has been selected by dispatcher for processing. X'42' = VMDBK is ready for selection by dispatcher once it goes to the dispatch list. X'37' = Test-idle. VMDBK is ready for selection by the dispatcher but should be dropped from the dispatch list when selected the next time. X'08' = VMDBK is suspended, probably waiting for a short-term event to occur. X'00' = VMDBK is idle. No work is available. 153 99 Bitstring 1 USEINT_CALOSTAT Virtual machine operating status 1... .... USEINT_VMDSYSOP User is primary system operator .1.. .... USEINT_VMDUSRCT User is counted as being logged on ..1. .... * ...1 .... USEINT_VMDFORCE User is to be logged off. This may be requested by CP, a forced logoff, or user's logoff command. .... 1... USEINT_VMDUFORC User is forced to logoff the system .... .1.. USEINT_VMDDISC User is running disconnected .... ..1. USEINT_VMDAUTOL AUTOLOG/XAUTOLOG in progress. User has been automatically logged on. This bit is set off when the user's IPL statement is processed, or (if there is no IPL to process) when the user enters a LOGON command from a terminal to RECONNECT. .... ...1 USEINT_VMDXAUTO The original command was XAUTOLOG. Valid for the base VMDBK only (see USEINT_CALBASE). 154 9A Bitstring 1 USEINT_CALRSTAT Reason(s) the dispatched VMDBK is not being run 1... .... * .1.. .... USEINT_VMDCFWT VMDBK is in console function wait. Either a console function is active, or the virtual machine is waiting for the remaining VMDBKs in the configuration to enter console function mode. ..1. .... USEINT_VMDSIMWT CP is simulating some hardware function for the guest such as instructions, interrupts, and timer updates. Virtual machine is prevented from running to avoid potential conflicts with the simulations. ...1 .... USEINT_VMDIOWT Instruction waiting for I/O status for completion. (May be cancelled without loss of system integrity.) .... 1... * .... .1.. * .... ..1. * .... ...1 * 155 9B Bitstring 1 USEINT_CALCWAIT Console Function Wait control flags. 1... .... USEINT_VMDSTOP virtual machine in stop state. .1.. .... USEINT_VMDSLEEP virtual machine is sleeping. ..1. .... USEINT_VMDCKST virtual cpu in check stop state. ...1 .... USEINT_VMDDSCWT virtual machine is in disconnected wait mode. I/O was attempted to the display and the user was disconnected, so a timer is set to log the user off if not reconnected within 15 minutes. .... 1... * .... .1.. * .... ..1. * .... ...1 * 156 9C Unsigned 2 USEINT_VMDCPRMD(4) Number of times this user was was pre-emptied from the dispatch list (Q0, Q1, Q2, Q3) due to a requirement for storage for E1 users 164 A4 Unsigned 2 USEINT_VMDCWSGD(4) Number of times this user was removed from the dispatch list (Q0, Q1, Q2, Q3) because it reached its working set size growth limit, and its new working set size would no longer fit available storage. 172 AC Unsigned 2 USEINT_VMDCETSD(4) Number of times this user was removed from the dispatch list (Q0, Q1, Q2, Q3) because it reached elapsed time slice end. 180 B4 Unsigned 2 USEINT_VMDCIDLD(4) Number of times this user was removed from the dispatch list (Q0, Q1, Q2, Q3) because its test idle time had expired or because it was granted no test idle time 188 BC Character 8 USEINT_VMDDQTOD Time of day clock at the time that the VMDBK was dropped from the dispatch list 196 C4 Character 8 USEINT_VMDSUSCK Time of day clock at the time the VMDBK was last marked suspended 204 CC Character 8 USEINT_VMDMTTOD Time of day clock when the last transaction started. Valid for the base VMDBK only (see USEINT_CALBASE). 212 D4 Unsigned 4 USEINT_HFIOACT High Frequency Count. Cardinal number of times the user had an asynchronous I/O outstanding, causing the user to be left in the dispatch list. VMDIOACT 216 D8 Unsigned 4 USEINT_HFLLIST High Frequency Count. Number of times the user was in dispatch list waiting for CPU but was on the Limit List, prevented from running by max share. 220 DC Unsigned 4 USEINT_HFPGACT High Frequency Count. Number of times the virtual machine had page fault requests active, but was not in page wait (VMDWTPAG was not set). This would occur if asynchronous page fault was being used and there was an outstanding page fault, but the virtual machine loaded a wait state because it had no other work to do. A virtual machine can have page faults handled asynchronously if using the PAGEX feature or the Page-Fault Handshaking CP services via the CP PFAULT MACRO. 224 E0 Signed 2 USEINT_VMDSLCNT Count of minor time slices that have expired since the start of current transaction. 226 E2 Unsigned 2 * Reserved and available for IBM use. 228 E4 Character 0 USEINT_END
MRUSEINT Cross ReferenceHex 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 USEINT 0 228 USEINT_CALBASE 1E 80 USEINT_CALCWAIT 9B 1 USEINT_CALFLAG 1E 1 USEINT_CALINTRN 20 4 USEINT_CALOSTAT 99 1 USEINT_CALRSTAT 9A 1 USEINT_CALTRQFL 1E 40 USEINT_END E4 0 USEINT_HFCFWT 68 4 USEINT_HFCPURN 78 4 USEINT_HFCPUWT 74 4 USEINT_HFDISP0 38 4 USEINT_HFDISP1 3C 4 USEINT_HFDISP2 40 4 USEINT_HFDISP3 44 4 USEINT_HFDORM 84 4 USEINT_HFDSVM 88 4 USEINT_HFELIG0 48 4 USEINT_HFELIG1 4C 4 USEINT_HFELIG2 50 4 USEINT_HFELIG3 54 4 USEINT_HFESVM 7C 4 USEINT_HFIOACT D4 4 USEINT_HFIOWT 64 4 USEINT_HFLLIST D8 4 USEINT_HFLOAD 80 4 USEINT_HFOTHR 8C 4 USEINT_HFPGACT DC 4 USEINT_HFQUCT 34 4 USEINT_HFSIMWT 6C 4 USEINT_HFSTCT 58 4 USEINT_HFTIDL 5C 4 USEINT_HFTSVM 60 4 USEINT_HFWTPAG 70 4 USEINT_MRHDR 0 0 USEINT_VMDAUTOL 99 02 USEINT_VMDCETSD AC 8 USEINT_VMDCFWT 9A 40 USEINT_VMDCIDLD B4 8 USEINT_VMDCKST 9B 20 USEINT_VMDCNTID 90 2 USEINT_VMDCPRMD 9C 8 USEINT_VMDCPUAD 1C 2 USEINT_VMDCTIDL 92 2 USEINT_VMDCWSGD A4 8 USEINT_VMDDFRWK 94 4 USEINT_VMDDISC 99 04 USEINT_VMDDQTOD BC 8 USEINT_VMDDSCWT 9B 10 USEINT_VMDFORCE 99 10 USEINT_VMDIOWT 9A 10 USEINT_VMDMTTOD CC 8 USEINT_VMDRDYCM 32 0 USEINT_VMDSIMWT 9A 20 USEINT_VMDSLCNT E0 2 USEINT_VMDSLEEP 9B 40 USEINT_VMDSTATE 98 1 USEINT_VMDSTOP 9B 80 USEINT_VMDSUSCK C4 8 USEINT_VMDSVMFX 24 4 USEINT_VMDSVMID 28 8 USEINT_VMDSVMWF 30 80 USEINT_VMDSVMWF 31 80 USEINT_VMDSVMWF 32 80 USEINT_VMDSVMWT 30 1 USEINT_VMDSVMWT 31 1 USEINT_VMDSVMWT 32 1 USEINT_VMDSVMW2 31 0 USEINT_VMDSYSOP 99 80 USEINT_VMDUFORC 99 08 USEINT_VMDUSER 14 8 USEINT_VMDUSRCT 99 40 USEINT_VMDXAUTO 99 01
This information is based on z/VM V4R4.0.
Last updated on 22 Jul 2003 at 15:04:23.
Copyright IBM Corporation, 1990, 2003