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 - USEACT FUNCTION - Map a Monitor record. LOCATED BY - Through the Monitor Control Area REFERENCED CONTROL BLOCKS - MRRECHDR Monitor Record Header NAME - MRUSEACT DESCRIPTIVE NAME - Monitor Sample Record Domain 4 - User Domain Record 3 - User Activity Data DESCRIPTION - User activity data. Generated for each virtual processor in a virtual configuration.
MRUSEACT Control Block ContentsOffsets Dec Hex Type Len Name (Dim) Description 0 0 Structure 320 USEACT Start of monitor record 0 0 Character 0 USEACT_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 USEACT_VMDUSER Userid 28 1C Unsigned 2 USEACT_VMDCPUAD Processor ID/CPU address of virtual processor 30 1E Bitstring 1 USEACT_VMDMODE Guest machine mode. This is as set for internal use by CP. See USEACT_CALMODE for the mode 'calculated' at. 31 1F Bitstring 1 USEACT_CALMODE Architectural mode of the virtual machine 1... .... * .1.. .... USEACT_CALMESA ESA architecture ..1. .... USEACT_CALMXA XA architecture ...1 .... USEACT_CALM370 370 architecture .... 1... USEACT_CALMXC XC architecture .... .1.. USEACT_CALMESAM ESA mode machine has entered z/Arch mode. .... ..1. * .... ...1 * 32 20 Bitstring 1 USEACT_VMDSLIST Scheduling list that the user is in: X'37' = Dispatch List. X'21' = Eligible List. X'0B' = Dormant List. X'00' = user is not in any list. 33 21 Unsigned 1 USEACT_VMDELIST Class number (0,1,2,or 3) of the scheduling list the user is in 34 22 Bitstring 1 USEACT_CALFLAG1 Flag byte 1... .... USEACT_CALBASE If on, this is the base VMDBK. VMDBASE .1.. .... USEACT_VMDQDSPU This user has the QUICKDSP designation, as set or defaulted 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. .... USEACT_CALDIAL This user is a dialed user ...1 .... USEACT_CALSNA This user is connected through System Network Architecture (SNA) .... 1... USEACT_VMDNOINS User is prevented from inserting any tracks into the minidisk cache. (set when SET MDC INS OFF command is issued) .... .1.. USEACT_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 * 35 23 Bitstring 1 USEACT_VMDSTYPE Storage type this virtual machine resides in. X'00' => V=V. X'80' => V=R. X'40' => V=F. 36 24 Character 8 USEACT_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. 44 2C Character 8 USEACT_VMDVTIME Total time that this user was running and 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. 52 34 Character 8 USEACT_VMDVFVTM Amount of time, in TOD clock units, that is consumed by the guest using vector instructions while in SIE 60 3C Character 8 USEACT_VMDVFOTM Amount of time, in TOD clock units, consumed by the system to support this guest's loading and unloading of its virtual vector facility. 68 44 Unsigned 4 USEACT_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 USEACT_VMDCTPVG from USEACT_VMDCTPVR. 72 48 Unsigned 4 USEACT_VMDCTPVL Cardinal count of locked pages in private address spaces belonging to this user. 76 4C Unsigned 4 USEACT_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. 80 50 Unsigned 4 USEACT_VMDCTXBK Number of expanded storage blocks allocated to a virtual machine by CP for paging. 84 54 Unsigned 4 USEACT_CALXSTOR Size, in megabytes, of expanded storage attached to the user. If zero, no expanded storage is attached. VMDXSTOR 88 58 Unsigned 4 USEACT_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. 92 5C Unsigned 4 USEACT_VMDCTVFL Number of times this virtual system's vector facility was loaded into a real vector facility. If the virtual vector facility is currently loaded, this count would be approximately equal to the number of saves. 96 60 Unsigned 4 USEACT_VMDFLREO Total number of frame list reorders for this virtual system's private address spaces 100 64 Unsigned 4 USEACT_VMDCTORF Total number of referenced frames resident when reset was done for this virtual system's private address spaces 104 68 Unsigned 4 USEACT_CALCTPGS Cardinal count of non-preferred paging slots for private address spaces belonging to this user. 108 6C Unsigned 4 * Reserved for IBM use 112 70 Unsigned 4 USEACT_VMDCTPWT Count of outstanding paging and spooling I/O's for this user 116 74 Unsigned 4 USEACT_CALCPPGR Cumulative count of pages read from DASD to main storage for this user's address spaces while they were private. 120 78 Unsigned 4 USEACT_CALCPPGW Cumulative count of pages written from main storage to DASD for this user's address spaces while they were private. 124 7C Unsigned 4 USEACT_VMDCTSPR Number of times I/O was issued for a spool read request 128 80 Unsigned 4 USEACT_VMDCTSPW Number of times I/O was issued for a spool write request 132 84 Unsigned 4 USEACT_VMDPGSPL Number of pages spooled for this user. This includes the pages spooled for the virtual reader, printer, punch, console, dump, and trace files. 136 88 Unsigned 4 USEACT_VMDVCSCT Count of start requests to the virtual machine console 140 8C Unsigned 4 USEACT_VMDVDSCT Cumulative count of virtual I/O requests the virtual machine has issued to DASD devices 144 90 Unsigned 4 USEACT_VMDVUSCT Count of Start requests to virtual Unit Record devices 148 94 Unsigned 4 USEACT_VMDVTSCT Count of Start requests to virtual channel-to-channel adapters 152 98 Unsigned 4 USEACT_VMDVOSCT Count of Start requests to devices other than console, DASDs, CTCAs, and unit records. (see USEACT_VMDVCSCT, USEACT_VMDVDSCT, USEACT_VMDVUSCT, and USEACT_VMDVTSCT) 156 9C Unsigned 4 USEACT_CALCPPST Cumulative count of pages stolen from this user's address spaces while they were private. 160 A0 Unsigned 4 USEACT_VMDISEVM Number of times IUCV data was successfully transferred by 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. 164 A4 Unsigned 4 USEACT_VMDISTVM Number of times IUCV 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. 168 A8 Unsigned 4 USEACT_VMDISUVM Number of times IUCV data was NOT successfully transferred by 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. 172 AC Unsigned 4 USEACT_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.) 176 B0 Unsigned 4 USEACT_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.) 180 B4 Unsigned 4 USEACT_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.) 184 B8 Signed 4 USEACT_CALIUCVS Cardinal count of messages on the IUCV SEND queue. The SEND queue consists of messages sent to this user either by another user or by a CP System Service. Note: A zero value may mean that the data could not be obtained as well as that there weren't any messages. 188 BC Signed 4 USEACT_CALIUCVR Cardinal count of messages on the IUCV RECEIVE queue which consists of messages this user has received from other users or CP System Services, but has not yet replied to. Note: A zero value may mean that the data could not be obtained as well as that there were not any messages. 192 C0 Signed 4 USEACT_CALIUCVY Cardinal count of messages on the IUCV REPLY queue which consists of replies to messages this user sent either to other users or to CP System Services. Note: A zero value may mean that the data could not be obtained as well as that there were not any messages. 196 C4 Signed 4 USEACT_CALVMCF Cardinal count of messages on the VMCF queue. Note: A zero value may mean that the data could not be obtained as well as that there were not any messages. 200 C8 Unsigned 4 USEACT_VMDX98CT Cumulative number of times Diagnose X'98' was issued by this virtual machine 204 CC Unsigned 4 USEACT_CALCPMIG Cumulative count of pages migrated by CP from expanded storage to DASD for this user's address spaces while they were private. 208 D0 Unsigned 4 USEACT_CALCPXWT Cumulative count of pages written from main storage to expanded storage for this user's address spaces while they were private. 212 D4 Unsigned 4 USEACT_CALCPXRD Cumulative count of pages read from expanded storage to main storage for this user's address spaces while they were private. 216 D8 Unsigned 2 USEACT_VMDASMCT Cardinal number of non-base address spaces owned by this user. 218 DA Bitstring 1 USEACT_CALSHARF Set Share flags 1... .... USEACT_VMDMXSHA Max share is Absolute if ON. Max share is Relative if OFF. .1.. .... * ..1. .... * ...1 .... * .... 1... * .... .1.. * .... ..1. USEACT_VMDLIMTH Max Share is Limithard if ON. Max Share is Limitsoft if OFF. .... ...1 * 219 DB Unsigned 1 * Reserved and available for IBM use. 220 DC Unsigned 4 USEACT_VMDBLKCT Count of SSCH's issued by BLOCKIO system service (includes both read and write requests) 224 E0 Unsigned 4 USEACT_VMDMDCIA Count of SSCH's avoided due to Minidisk Cache read hit 228 E4 Unsigned 4 USEACT_VMDCOPCT Number of times this virtual CPU had to be redispatched due to a crypto operation exception 232 E8 Unsigned 4 USEACT_VMDCTISO Number of times ISOLATE occurred for spaces owned by this virtual system. Valid only in base VMDBK 236 EC Unsigned 4 USEACT_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. 240 F0 Unsigned 4 USEACT_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. 244 F4 Unsigned 4 USEACT_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 USEACT_ASCDEFSZ 248 F8 Unsigned 4 USEACT_VMDMXRVP Number of pages reserved for the user 252 FC Character 8 USEACT_VMDACTNO User accounting number 260 104 Character 8 USEACT_VMDGRPN RACF ACI group name 268 10C Character 8 USEACT_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. 276 114 Unsigned 4 USEACT_VMDVDISK Count of virtual I/Os to a virtual disk in storage. 280 118 Unsigned 4 USEACT_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 USEACT_VMDMXSHA to determine if Max share is absolute or relative. 284 11C Unsigned 4 USEACT_VMDTHRCT Total number of times this user was delayed doing I/O to a throttled device 288 120 Unsigned 2 USEACT_IUCTOTCN Total number of connections for IUCV. Valid only for base VMDKBK 290 122 Unsigned 2 USEACT_IUCMXCN Maximum number of connections from the MAXCONN directory option or the system default. 292 124 Unsigned 4 USEACT_VMDCTPVG Count of private address space resident pages in DPA owned by this virtual machine which are >= 2G. Valid only in base VMDBK. 296 128 Character 8 USEACT_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'). 296 128 Character 4 USEACT_CALDEFHI high four bytes 300 12C Character 4 USEACT_CALDEFLO low four bytes 304 130 Unsigned 4 USEACT_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. 308 134 Bitstring 1 USEACT_IPQF0 I/O priority flag byte. See CP SET IOPRIORITY command for description of absolute and relative ranges. Valid only in base VMDBK. 1... .... USEACT_IPQRELRG Using a relative range. Valid only in base VMDBK. .1.. .... USEACT_IPQABSRG Using an absolute range. Valid only in base VMDBK. ..1. .... USEACT_IPQGSSC Guest requested I/O subsystem details which includes I/O priority facility status. This usually indicates that the guest is I/O priority aware. Valid only in base VMDBK. ...1 .... * .... 1... * .... .1.. * .... ..1. * .... ...1 * 309 135 Unsigned 1 USEACT_IPQRQLO I/O priority requested range low value. See CP SET IOPRIORITY command for description of requested and effective I/O priority values. Valid only in base VMDBK. 310 136 Unsigned 1 USEACT_IPQRQHI I/O priority requested range high value. Valid only in base VMDBK. 311 137 Unsigned 1 USEACT_IPQEFLO I/O priority effective range low value. Valid only in base VMDBK. 312 138 Unsigned 1 USEACT_IPQEFHI I/O priority effective range high value. Valid only in base VMDBK. 313 139 Character 3 * Reserved and available for IBM use. 316 13C Unsigned 4 USEACT_IPQDSKIP Count of times that a DASD I/O request was out-prioritized by another virtual machine's I/O. Valid only in base VMDBK. 320 140 Character 0 USEACT_END
MRUSEACT 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 USEACT 0 320 USEACT_ASCDEFSZ 128 8 USEACT_CALBASE 22 80 USEACT_CALCPMIG CC 4 USEACT_CALCPPGR 74 4 USEACT_CALCPPGW 78 4 USEACT_CALCPPST 9C 4 USEACT_CALCPXRD D4 4 USEACT_CALCPXWT D0 4 USEACT_CALCTPGS 68 4 USEACT_CALDEFHI 128 4 USEACT_CALDEFLO 12C 4 USEACT_CALDIAL 22 20 USEACT_CALFLAG1 22 1 USEACT_CALIUCVR BC 4 USEACT_CALIUCVS B8 4 USEACT_CALIUCVY C0 4 USEACT_CALMESA 1F 40 USEACT_CALMESAM 1F 04 USEACT_CALMODE 1F 1 USEACT_CALMXA 1F 20 USEACT_CALMXC 1F 08 USEACT_CALM370 1F 10 USEACT_CALSHARF DA 1 USEACT_CALSNA 22 10 USEACT_CALTODON 10C 8 USEACT_CALVMCF C4 4 USEACT_CALXSTOR 54 4 USEACT_END 140 0 USEACT_IPQABSRG 134 40 USEACT_IPQDSKIP 13C 4 USEACT_IPQEFHI 138 1 USEACT_IPQEFLO 137 1 USEACT_IPQF0 134 1 USEACT_IPQGSSC 134 20 USEACT_IPQRELRG 134 80 USEACT_IPQRQHI 136 1 USEACT_IPQRQLO 135 1 USEACT_IUCMXCN 122 2 USEACT_IUCTOTCN 120 2 USEACT_MRHDR 0 0 USEACT_VMDABSSH F0 4 USEACT_VMDACTNO FC 8 USEACT_VMDASMCT D8 2 USEACT_VMDBLKCT DC 4 USEACT_VMDCOPCT E4 4 USEACT_VMDCPUAD 1C 2 USEACT_VMDCTFLT 58 4 USEACT_VMDCTISO E8 4 USEACT_VMDCTORF 64 4 USEACT_VMDCTPVG 124 4 USEACT_VMDCTPVL 48 4 USEACT_VMDCTPVR 44 4 USEACT_VMDCTPWT 70 4 USEACT_VMDCTSPR 7C 4 USEACT_VMDCTSPW 80 4 USEACT_VMDCTVFL 5C 4 USEACT_VMDCTXBK 50 4 USEACT_VMDELIST 21 1 USEACT_VMDFLREO 60 4 USEACT_VMDGRPN 104 8 USEACT_VMDISEVM A0 4 USEACT_VMDISTVM A4 4 USEACT_VMDISUVM A8 4 USEACT_VMDLIMTH DA 02 USEACT_VMDMDCIA E0 4 USEACT_VMDMODE 1E 1 USEACT_VMDMVB2G 130 4 USEACT_VMDMXRVP F8 4 USEACT_VMDMXSHA DA 80 USEACT_VMDMXSHR 118 4 USEACT_VMDNOFSL 22 04 USEACT_VMDNOINS 22 08 USEACT_VMDPGSPL 84 4 USEACT_VMDQDSPU 22 40 USEACT_VMDRELSH EC 4 USEACT_VMDSLIST 20 1 USEACT_VMDSSIZE F4 4 USEACT_VMDSTYPE 23 1 USEACT_VMDTHRCT 11C 4 USEACT_VMDTTIME 24 8 USEACT_VMDUSER 14 8 USEACT_VMDVCSCT 88 4 USEACT_VMDVDISK 114 4 USEACT_VMDVDSCT 8C 4 USEACT_VMDVFOTM 3C 8 USEACT_VMDVFVTM 34 8 USEACT_VMDVOSCT 98 4 USEACT_VMDVSEVM AC 4 USEACT_VMDVSTVM B0 4 USEACT_VMDVSUVM B4 4 USEACT_VMDVTIME 2C 8 USEACT_VMDVTSCT 94 4 USEACT_VMDVUSCT 90 4 USEACT_VMDWSSPR 4C 4 USEACT_VMDX98CT C8 4
This information is based on z/VM V4R4.0.
Last updated on 22 Jul 2003 at 15:04:23.
Copyright IBM Corporation, 1990, 2003