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 - USEATE FUNCTION - Map a Monitor record. LOCATED BY - Through the Monitor Control Area REFERENCED CONTROL BLOCKS - MRRECHDR Monitor Record Header NAME - MRUSEATE DESCRIPTIVE NAME - Monitor Event Record Domain 4 - User Domain Record 9 - User Activity Data at Transaction End DESCRIPTION - Provides information relating to a VMDBK's consumption of system resources for a transaction. A separate record is generated for each VMDBK in a virtual complex that contributed to the transaction.
MRUSEATE Control Block ContentsOffsets Dec Hex Type Len Name (Dim) Description 0 0 Structure 316 USEATE Start of monitor record 0 0 Character 0 USEATE_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 USEATE_VMDUSER Userid 28 1C Unsigned 2 USEATE_VMDCPUAD Processor ID 30 1E Bitstring 1 USEATE_VMDMODE Guest machine mode. This is as set for internal use by CP. See USEATE_CALMODE for the mode 'calculated' at. 31 1F Bitstring 1 USEATE_CALMODE Architectural mode of the virtual machine 1... .... * .1.. .... USEATE_CALMESA ESA architecture ..1. .... USEATE_CALMXA XA architecture ...1 .... USEATE_CALM370 370 architecture .... 1... USEATE_CALMXC XC architecture .... .1.. USEATE_CALMESAM ESA mode machine has entered z/Arch mode .... ..1. * .... ...1 * 32 20 Character 8 USEATE_VMDTTIME Total time which has been expended on this VMDBK. This includes time which the VMDBK spent doing its own work and also time which CP spent doing work on behalf of the VMDBK. It is in CPU timer format. The complement of this field is the elapsed time in TOD clock units. 40 28 Character 8 USEATE_VMDVTIME Total time that this user was running, doing productive work. It does not include any time that CP spends on behalf of that user doing such things as instruction simulation or page translation. This is in CPU timer FORMAT. The complement of this field is the elapsed time in TOD clock units. 48 30 Character 8 * Reserved for IBM use Previous field is no longer meaningful. (USEATE_VMDVFVTM) 56 38 Character 8 * Reserved for IBM use Previous field is no longer meaningful. (USEATE_VMDVFOTM) 64 40 Unsigned 4 USEATE_VMDCTPVR Cardinal count of resident pages in private address spaces belonging to this user. This monitor field is actually the sum of VMDCTPVR + VMDCTPVG. To get the count of resident pages below the 2GB line, subtract USEATE_VMDCTPVG from USEATE_VMDCTPVR. 68 44 Unsigned 4 USEATE_VMDCTPVL Cardinal count of locked pages in private address spaces <2G belonging to this user. See USEATE_VMDCTPVLA for the >2G value. 72 48 Unsigned 4 USEATE_VMDWSSPR This user's projected working set size. This is the scheduler's estimate of the amount of storage this user will require to be resident as it runs during its next stay in the dispatch list. It is based upon the user's past behavior and in some cases, on the behavior of similar types of users. 76 4C Unsigned 4 USEATE_VMDCTXBK The number of expanded storage blocks allocated to a virtual machine by CP for paging 80 50 Unsigned 4 USEATE_VMDCTFLT Count of host segment and page faults on guest pages which occurred while running this virtual CPU. It does not include faults on RCP pages. 84 54 Unsigned 4 * Reserved for IBM use Previous field is no longer meaningful. (USEATE_VMDCTVFL) 88 58 Unsigned 4 USEATE_VMDCTORF Total number of referenced frames resident when reset was done for this virtual system's private address spaces 92 5C Unsigned 4 USEATE_CALCTPGS Cardinal count of non-preferred paging slots for private address spaces belonging to this user. 96 60 Unsigned 4 * Reserved for IBM use 100 64 Unsigned 4 USEATE_VMDCTPWT Count of outstanding paging and spooling I/O's for this user 104 68 Unsigned 4 USEATE_CALCPPGR Cumulative count of pages read from DASD to main storage for this user's address spaces while they were private. 108 6C Unsigned 4 USEATE_CALCPPGW Cumulative count of pages written from main storage to DASD for this user's address spaces while they were private. 112 70 Unsigned 4 USEATE_VMDCTSPR Number of times I/O was issued for a spool read request 116 74 Unsigned 4 USEATE_VMDCTSPW Number of times I/O was issued for a spool write request 120 78 Unsigned 4 USEATE_VMDPGSPL Number of pages spooled for this user. This includes the pages spooled for the virtual reader, printer, punch, console, dump, and trace files. 124 7C Unsigned 4 USEATE_VMDVCSCT Number of start requests to the virtual machine console 128 80 Unsigned 4 USEATE_VMDVDSCT Cumulative count of virtual I/O requests the virtual machine has issued to DASD devices 132 84 Unsigned 4 USEATE_VMDVUSCT Count of Start requests to virtual Unit Record devices 136 88 Unsigned 4 USEATE_VMDVTSCT Count of Start requests to virtual channel-to-channel adapters 140 8C Unsigned 4 USEATE_VMDVOSCT Count of Start requests to devices other than console, DASDs, CTCAs, and unit records. (see USEATE_VMDVCSCT, USEATE_VMDVDSCT, USEATE_VMDVUSCT, and USEATE_VMDVTSCT.) 144 90 Unsigned 4 USEATE_CALCPPST Cumulative count of pages stolen from this user's address spaces while they were private. 148 94 Unsigned 4 USEATE_VMDISEVM Number of times IUCV/APPC data was successfully transferred from this virtual complex. (SENDs and REPLYs with RC=0 when this virtual machine is the source). Not valid in the SYSTEM VMDBK. Valid only in base VMDBK. 152 98 Unsigned 4 USEATE_VMDISTVM Number of times IUCV/APPC data was successfully transferred to this virtual complex. (SENDs and REPLYs with RC=0 when this virtual machine is the target). Not valid in the SYSTEM VMDBK. Valid only in base VMDBK. 156 9C Unsigned 4 USEATE_VMDISUVM Number of times IUCV/APPC data was not successfully transferred from this virtual complex. (SENDs and REPLYs with RC=0 when this virtual machine is the source). Not valid in the SYSTEM VMDBK. Valid only in base VMDBK. 160 A0 Unsigned 4 USEATE_VMDVSEVM Number of times VMCF data was successfully transferred by this virtual machine. (SENDs SENDXs, SEND/RECEIVEs, and REPLYs with RC=0 and this virtual machine is source.) 164 A4 Unsigned 4 USEATE_VMDVSTVM Number of times VMCF data was successfully transferred to this virtual machine. (SENDs SENDXs, SEND/RECEIVEs, and REPLYs with RC=0 and this virtual machine is target.) 168 A8 Unsigned 4 USEATE_VMDVSUVM Number of times VMCF data was not successfully transferred by this virtual machine. (SENDs SENDXs, SEND/RECEIVEs, and REPLYs with RC^=0 and this virtual machine is source.) 172 AC Unsigned 4 USEATE_VMDX98CT Cumulative number of times Diagnose X'98' was issued by this virtual machine 176 B0 Unsigned 4 USEATE_CALCPMIG Cumulative count of pages migrated by CP from expanded storage to DASD for this user's address spaces while they were private. 180 B4 Unsigned 4 USEATE_CALCPXWT Cumulative count of pages written from main storage to expanded storage for this user's address spaces while they were private. 184 B8 Unsigned 4 USEATE_CALCPXRD Cumulative count of pages read from expanded storage to main storage for this user's address spaces while they were private. 188 BC Bitstring 1 USEATE_CALFLAG1 Flag byte 1... .... USEATE_CALBASE If on, this is the base VMDBK. VMDBASE .1.. .... USEATE_VMDQDSPU This user has the QUICKDSP designation, either by default or as set by the SET QUICKDSP command. When the user has work to do, it will be added to the dispatch list immediately without waiting in the eligible list. ..1. .... USEATE_CALDIAL This user is a dialed user ...1 .... USEATE_CALSNA This user is connected through System Network Architecture (SNA) .... 1... USEATE_VMDNOINS User is prevented from inserting any tracks into the minidisk cache. (set when SET MDC INS OFF command is issued) .... .1.. USEATE_VMDNOFSL No MDC fair share limit applies. Set at LOGON if the NOMDCFS option is specified on the OPTIONS statement in the user's directory. .... ..1. * .... ...1 * 189 BD Bitstring 1 USEATE_VMDSTYPE Storage type this virtual machine resides in. X'00' => V=V. X'80' => Reserved and no longer available. X'40' => V=F. 190 BE Bitstring 1 USEATE_CALSHARF Set Share flags 1... .... USEATE_VMDMXSHA Max share is Absolute if ON. Max share is Relative if OFF. .1.. .... * ..1. .... * ...1 .... * .... 1... * .... .1.. * .... ..1. USEATE_VMDLIMTH Max share is Limithard if ON. Max share is Limitsoft if OFF. .... ...1 * 191 BF Unsigned 1 * Reserved and available for IBM use. 192 C0 Unsigned 4 USEATE_VMDBLKCT Count of SSCH's issued by BLOCKIO system service (includes both read and write requests) 196 C4 Unsigned 4 USEATE_VMDMDCIA Count of SSCH's avoided due to Minidisk Cache read hit 200 C8 Unsigned 4 USEATE_VMDCOPCT Number of times this virtual CPU had to be redispatched due to a crypto operation exception 204 CC Unsigned 4 USEATE_VMDCTISO Number of times ISOLATE occurred for spaces owned by this virtual system. Valid only in base VMDBK 208 D0 Unsigned 4 USEATE_VMDRELSH This user's RELATIVE share of the system, as set in the user's directory or via the SET SHARE command. Set to zero if the user is an ABSOLUTE share user, or if this VMDBK has a virtual processor dedicated to it, and the user is a virtual MP user. Set to a negative value if VMDBK has a virtual processor dedicated to it, and the user is a virtual UP user. 212 D4 Unsigned 4 USEATE_VMDABSSH This user's ABSOLUTE share of the system, as set in the user's directory or via the SET SHARE command. Unit of value is a hexadecimal factor scaled 16 bits. For example, X'00010000'=1.00(100%), X'0000C000'=0.75(75%), X'00008000'=0.50(50%), etc. Set to zero if user is a RELATIVE share user. 216 D8 Unsigned 4 USEATE_VMDSSIZE Virtual machine size, in bytes. This field is kept for compatability reasons, but may not be accurate for z/Arch systems where larger virtual machines are valid. The preferred field is USEATE_ASCDEFSZ 220 DC Unsigned 4 USEATE_VMDMXRVP Number of pages reserved for the user 224 E0 Character 8 USEATE_VMDACTNO User accounting number 232 E8 Character 8 USEATE_VMDGRPN RACF ACI group name 240 F0 Character 8 USEATE_CALTODON Time at which the user logged on for this session. In time-of-day (TOD) clock format. To get the user's connect time, subtract this time value from the time stamp in the record header's MRHDRTOD. 248 F8 Unsigned 4 USEATE_VMDVDISK Count of virtual I/Os to a virtual disk in storage. 252 FC Unsigned 4 USEATE_VMDMXSHR The user's Max share of the system, as set in the user's directory or via the SET SHARE command. This value is set to zero if no Max share exists. If the Max share is Absolute, then the unit of the value is a hexadecimal factor scaled 16 bits. For example, X'00010000' = 1.00(100%), X'0000C000' = 0.75(75%), X'00008000' = 0.50(50%), etc. Check USEATE_VMDMXSHA to determine if Max share is absolute or relative. 256 100 Character 8 USEATE_ASCDEFSZ Defined storage size in addressable bytes, minus one. If DEF STOR CONFIG was used to define multiple discontiguous extents of addressable defined storage, this field contains the sum of the sizes in bytes of all of the individual extents (minus one). The minus one notation is used so that a total size of 16 Exabytes may be represented without ambiguity (as x'FFFFFFFF_FFFFFFFF'). 256 100 Character 4 USEATE_CALDEFHI high four bytes 260 104 Character 4 USEATE_CALDEFLO low four bytes 264 108 Unsigned 4 USEATE_VMDCTPVG Count of private address space resident pages in DPA owned by this virtual machine which are >= 2G. Valid only in base VMDBK. 268 10C Unsigned 4 USEATE_VMDMVB2G Number of times page translation moved a page on behalf of this us user from a frame with address >= 2GB to one < 2GB. This field is only valid in the base VMDBK. 272 110 Unsigned 4 USEATE_VEBALERT Number of alert interruptions Collected only for base VMDBK. 276 114 Unsigned 4 USEATE_VEBTVSCT Number of interceptions for guest TVS instructions Collected only for base VMDBK. 280 118 Unsigned 4 USEATE_VEBSVSCT Number of interceptions for guest SVS instructions Collected only for base VMDBK. 284 11C Unsigned 4 USEATE_VEBTPIAI Number of adapter interruptions delivered via guest TPI Collected only for base VMDBK. 288 120 Unsigned 4 USEATE_VEBVIRAI Number of adapter interruptions stacked for guest by CP Collected only for base VMDBK. 292 124 Unsigned 4 USEATE_VEBHDWAI Number of adapter interruptions delivered to guest inside SIE Collected only for base VMDBK. 296 128 Character 8 USEATE_VMDCTPVLA Cardinal count of locked pages in private address spaces >2G belonging to this user. See USEATE_VMDCTPVL for the <2G value. 304 130 Unsigned 4 USEATE_VMDCTSHL Count of shared address space resident pages <2G. Valid only in the SYSTEM VMDBK. 308 134 Character 8 USEATE_VMDCTSHLA Count of shared address space resident pages >2G. Valid only in the SYSTEM VMDBK. 316 13C Character 0 USEATE_END
MRUSEATE 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 USEATE 0 316 USEATE_ASCDEFSZ 100 8 USEATE_CALBASE BC 80 USEATE_CALCPMIG B0 4 USEATE_CALCPPGR 68 4 USEATE_CALCPPGW 6C 4 USEATE_CALCPPST 90 4 USEATE_CALCPXRD B8 4 USEATE_CALCPXWT B4 4 USEATE_CALCTPGS 5C 4 USEATE_CALDEFHI 100 4 USEATE_CALDEFLO 104 4 USEATE_CALDIAL BC 20 USEATE_CALFLAG1 BC 1 USEATE_CALMESA 1F 40 USEATE_CALMESAM 1F 04 USEATE_CALMODE 1F 1 USEATE_CALMXA 1F 20 USEATE_CALMXC 1F 08 USEATE_CALM370 1F 10 USEATE_CALSHARF BE 1 USEATE_CALSNA BC 10 USEATE_CALTODON F0 8 USEATE_END 13C 0 USEATE_MRHDR 0 0 USEATE_VEBALERT 110 4 USEATE_VEBHDWAI 124 4 USEATE_VEBSVSCT 118 4 USEATE_VEBTPIAI 11C 4 USEATE_VEBTVSCT 114 4 USEATE_VEBVIRAI 120 4 USEATE_VMDABSSH D4 4 USEATE_VMDACTNO E0 8 USEATE_VMDBLKCT C0 4 USEATE_VMDCOPCT C8 4 USEATE_VMDCPUAD 1C 2 USEATE_VMDCTFLT 50 4 USEATE_VMDCTISO CC 4 USEATE_VMDCTORF 58 4 USEATE_VMDCTPVG 108 4 USEATE_VMDCTPVL 44 4 USEATE_VMDCTPVLA 128 8 USEATE_VMDCTPVR 40 4 USEATE_VMDCTPWT 64 4 USEATE_VMDCTSHL 130 4 USEATE_VMDCTSHLA 134 8 USEATE_VMDCTSPR 70 4 USEATE_VMDCTSPW 74 4 USEATE_VMDCTXBK 4C 4 USEATE_VMDGRPN E8 8 USEATE_VMDISEVM 94 4 USEATE_VMDISTVM 98 4 USEATE_VMDISUVM 9C 4 USEATE_VMDLIMTH BE 02 USEATE_VMDMDCIA C4 4 USEATE_VMDMODE 1E 1 USEATE_VMDMVB2G 10C 4 USEATE_VMDMXRVP DC 4 USEATE_VMDMXSHA BE 80 USEATE_VMDMXSHR FC 4 USEATE_VMDNOFSL BC 04 USEATE_VMDNOINS BC 08 USEATE_VMDPGSPL 78 4 USEATE_VMDQDSPU BC 40 USEATE_VMDRELSH D0 4 USEATE_VMDSSIZE D8 4 USEATE_VMDSTYPE BD 1 USEATE_VMDTTIME 20 8 USEATE_VMDUSER 14 8 USEATE_VMDVCSCT 7C 4 USEATE_VMDVDISK F8 4 USEATE_VMDVDSCT 80 4 USEATE_VMDVOSCT 8C 4 USEATE_VMDVSEVM A0 4 USEATE_VMDVSTVM A4 4 USEATE_VMDVSUVM A8 4 USEATE_VMDVTIME 28 8 USEATE_VMDVTSCT 88 4 USEATE_VMDVUSCT 84 4 USEATE_VMDWSSPR 48 4 USEATE_VMDX98CT AC 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