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 - SYTUWT FUNCTION - Map a Monitor record. LOCATED BY - Through the Monitor control area REFERENCED CONTROL BLOCKS - MRRECHDR Monitor Record Header NAME - MRSYTUWT DESCRIPTIVE NAME - Monitor Sample Record Domain 0 - System Domain Record 12 - User wait states DESCRIPTION - User wait state. All VMDBKs in the dispatch list are tested for their wait states. NOTES: - The following list is the order in which the user state is tested in the VMDBK. If the user is in more than one state, it is counted only in the first of the list. SYTUWT_CALTIDL SYTUWT_CALSVMWT SYTUWT_CALIOWT SYTUWT_CALCFWT SYTUWT_CALSIMWT SYTUWT_CALWTPAG SYTUWT_CALCPUWT SYTUWT_CALCPURN SYTUWT_CALIOACT SYTUWT_CALOTHR
MRSYTUWT Control Block ContentsOffsets Dec Hex Type Len Name (Dim) Description 0 0 Structure 80 SYTUWT Start of monitor record 0 0 Character 0 SYTUWT_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 4 SYTUWT_CALTIDL Cardinal count of VMDBKs that were found in test idle, but not in SVM wait. VMDSVMWF of VMDSVMWT=off and VMDSTATE = VMDTIDLE. 24 18 Unsigned 4 SYTUWT_CALTSVM Cardinal count of VMDBKs that were found in both test idle and SVM wait. VMDSVMWF of VMDSVMWT = on and VMDSTATE = VMDTIDLE. 28 1C Signed 4 SYTUWT_CALIOWT Cardinal count of VMDBKs in the dispatch list that were in I/O wait state. A guest is waiting for an I/O completion and is thus prevented from running. VMDIOWT 32 20 Signed 4 SYTUWT_CALWTPAG Cardinal count of VMDBKs in the dispatch list that were in 'page wait,' a state in which 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 36 24 Signed 4 SYTUWT_CALCFWT Cardinal count of VMDBKs in the dispatch list that were in console-function wait. During such a wait, the virtual CPU is not permitted to run. VMDCFWT 40 28 Signed 4 SYTUWT_CALSIMWT Cardinal count of VMDBKs in the dispatch list that were in 'simulation wait.' 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 44 2C Signed 4 SYTUWT_CALCPUWT Cardinal count of VMDBKs in the dispatch list that are waiting for a real processor (i.e. CPU WAIT) 48 30 Signed 4 SYTUWT_CALCPURN Cardinal count of VMDBKs in the dispatch list that are running on a real processor 52 34 Signed 4 SYTUWT_CALOTHR Cardinal count of VMDBKs in the dispatch list that are not in any of the above states 56 38 Signed 4 SYTUWT_CALQDISP Cardinal count of VMDBKs in the dispatch list that are QUICK DISP users. 60 3C Signed 4 SYTUWT_CALELSVM Cardinal count of VMDBKs in the eligible list that are in SVM wait 64 40 Unsigned 2 SYTUWT_SRMCELIG Cardinal count of VMDBKs in the eligible list 66 42 Unsigned 2 * Reserved for IBM use 68 44 Signed 4 SYTUWT_SRMDSVMW Cardinal count of VMDBKs in the dormant list and in SVM wait. 72 48 Unsigned 4 SYTUWT_CALIOACT Cardinal count of VMDBKs that had asynchronous I/O's outstanding, causing them to be left in the dispatch list 76 4C Unsigned 4 SYTUWT_CALLLIST Number of VMDBKs that were in dispatch list waiting for CPU but were also on the Limit List, prevented from running by max share. 80 50 Character 0 SYTUWT_END
MRSYTUWT 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 SYTUWT 0 80 SYTUWT_CALCFWT 24 4 SYTUWT_CALCPURN 30 4 SYTUWT_CALCPUWT 2C 4 SYTUWT_CALELSVM 3C 4 SYTUWT_CALIOACT 48 4 SYTUWT_CALIOWT 1C 4 SYTUWT_CALLLIST 4C 4 SYTUWT_CALOTHR 34 4 SYTUWT_CALQDISP 38 4 SYTUWT_CALSIMWT 28 4 SYTUWT_CALTIDL 14 4 SYTUWT_CALTSVM 18 4 SYTUWT_CALWTPAG 20 4 SYTUWT_END 50 0 SYTUWT_MRHDR 0 0 SYTUWT_SRMCELIG 40 2 SYTUWT_SRMDSVMW 44 4
This information is based on z/VM V5R2.0.
Last updated on 11 Dec 2005 at 18:48:12.
Copyright IBM Corporation, 1990, 2005