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 - USELOF FUNCTION - Map a Monitor record. LOCATED BY - Through the Monitor Control Area REFERENCED CONTROL BLOCKS - MRRECHDR Monitor Record Header NAME - MRUSELOF DESCRIPTIVE NAME - Monitor Event Record Domain 4 - User Domain Record 2 - User Logoff Data DESCRIPTION - Records a user that has logged off. Generated for the base VMDBK only. NOTE - Alternate VMDBKs of the user that has logged off are recorded in MRUSEDTC (Domain 4, Record 6).
MRUSELOF Control Block ContentsOffsets Dec Hex Type Len Name (Dim) Description 0 0 Structure 328 USELOF Start of monitor record 0 0 Character 0 USELOF_MRHDR record header 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 USELOF_VMDUSER USERID 28 1C Unsigned 2 USELOF_VMDCPUAD Processor ID 30 1E Bitstring 1 USELOF_VMDMODE Guest machine mode. This is as set for internal use by CP. See USELOF_CALMODE for the mode 'calculated' at. 31 1F Bitstring 1 USELOF_CALMODE Architectural mode of the virtual machine 1... .... * .1.. .... USELOF_CALMESA ESA architecture ..1. .... USELOF_CALMXA XA architecture ...1 .... USELOF_CALM370 370 architecture .... 1... USELOF_CALMXC XC architecture .... .1.. USELOF_CALMESAM ESA mode machine has entered z/Arch mode. .... ..1. * .... ...1 * 32 20 Bitstring 1 USELOF_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 USELOF_VMDELIST Class number (0,1,2,or 3) of the scheduling list the user is in 34 22 Bitstring 1 USELOF_CALFLAG1 Flag byte 1... .... * .1.. .... USELOF_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. .... USELOF_CALDIAL This user is a dialed user ...1 .... USELOF_CALSNA This user is connected through System Network Architecture (SNA) .... 1... USELOF_VMDNOINS User is prevented from inserting any tracks into the minidisk cache. (set when SET MDC INS OFF command is issued) .... .1.. USELOF_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 USELOF_VMDSTYPE Storage type this virtual machine resides in. X'00' => V=V. X'80' => Reserved and no longer available. X'40' => V=F. 36 24 Character 8 USELOF_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 USELOF_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 * Reserved for IBM use. Previous field is no longer meaningful. (USELOF_VMDVFVTM) 60 3C Character 8 * Reserved for IBM use. Previous field is no longer meaningful. (USELOF_VMDVFOTM) 68 44 Unsigned 4 USELOF_VMDCTPVR Cardinal count of private resident pages in the virtual machine. This monitor field is actually the sum of VMDCTPVR + VMDCTPVG, which includes pages above and below the 2GB line. To get the count of the resident pages below the 2GB line, subtract USELOF_VMDCTPVG from USELOF_VMDCTPVR. 72 48 Unsigned 4 USELOF_VMDCTPVL Cardinal count of locked pages in private address spaces <2G belonging to this user. See USELOF_VMDCTPVLA for the >2G value. 76 4C Unsigned 4 USELOF_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 USELOF_VMDCTXBK Number of expanded storage blocks allocated to a virtual machine by CP for paging. 84 54 Unsigned 4 USELOF_CALXSTOR Size, in megabytes, of expanded storage attached to the user. If zero, no expanded storage is attached. VMDXSTOR 88 58 Unsigned 4 USELOF_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 * Reserved for IBM use. Previous field is no longer meaningful. (USELOF_VMDCTVFL) 96 60 Unsigned 4 USELOF_VMDFLREO Total number of frame list reorders for this virtual system's private address spaces 100 64 Unsigned 4 USELOF_VMDCTORF Total number of referenced frames resident when reset was done for this virtual system's private address spaces 104 68 Unsigned 4 USELOF_CALCTPGS Cardinal count of non-preferred paging slots for private address spaces belonging to this user. 108 6C Unsigned 4 USELOF_VMDCTPWT Count of outstanding paging and spooling I/O's for this user 112 70 Unsigned 4 USELOF_CALCPPGR Cumulative count of pages read from DASD to main storage for this user's address spaces while they were private. 116 74 Unsigned 4 USELOF_CALCPPGW Cumulative count of pages written from main storage to DASD for this user's address spaces while they were private. 120 78 Unsigned 4 USELOF_VMDCTSPR Number of times I/O was issued for a spool read request 124 7C Unsigned 4 USELOF_VMDCTSPW Number of times I/O was issued for a spool write request 128 80 Unsigned 4 USELOF_VMDPGSPL Number of pages spooled for this user. This includes the pages spooled for the virtual reader, printer, punch, console, dump, and trace files. 132 84 Unsigned 4 USELOF_VMDVCSCT Count of start requests to the virtual machine console 136 88 Unsigned 4 USELOF_VMDVDSCT Cumulative count of virtual I/O requests the virtual machine has issued to DASD devices 140 8C Unsigned 4 USELOF_VMDVUSCT Count of Start requests to virtual Unit Record devices 144 90 Unsigned 4 USELOF_VMDVTSCT Count of Start requests to virtual channel-to-channel adapters 148 94 Unsigned 4 USELOF_VMDVOSCT Count of Start requests to devices other than console, DASDs, CTCAs, and unit records. (see USELOF_VMDVCSCT, USELOF_VMDVDSCT, USELOF_VMDVUSCT, and USELOF_VMDVTSCT) 152 98 Unsigned 4 USELOF_CALCPPST Cumulative count of pages stolen from this user's address spaces while they were private. 156 9C Unsigned 4 USELOF_VMDISEVM Number of times IUCV data was successfully transferred by this virtual machine. (SENDs and REPLYs with RC=0 when this virtual machine is the source). Valid only in base VMDBK. 160 A0 Unsigned 4 USELOF_VMDISTVM Number of times IUCV data was successfully transferred to this virtual machine. (SENDs and REPLYs with RC=0 when this virtual machine is the target). Valid only in base VMDBK. 164 A4 Unsigned 4 USELOF_VMDISUVM Number of times IUCV data was NOT successfully transferred by this virtual machine. (SENDs and REPLYs with RC^=0 when this virtual machine is the source). Valid only in the base VMDBK. 168 A8 Unsigned 4 USELOF_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.) 172 AC Unsigned 4 USELOF_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.) 176 B0 Unsigned 4 USELOF_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.) 180 B4 Unsigned 4 USELOF_VMDX98CT Cumulative number of times Diagnose X'98' was issued by this virtual machine 184 B8 Unsigned 4 USELOF_CALCPMIG Cumulative count of pages migrated by CP from expanded storage to DASD for this user's address spaces while they were private. 188 BC Unsigned 4 USELOF_CALCPXWT Cumulative count of pages written from main storage to expanded storage for this user's address spaces while they were private. 192 C0 Unsigned 4 USELOF_CALCPXRD Cumulative count of pages read from expanded storage to main storage for this user's address spaces while they were private. 196 C4 Unsigned 2 USELOF_VMDASMCT Cardinal number of non-base address spaces owned by this user. 198 C6 Bitstring 1 USELOF_CALSHARF Set Share flags 1... .... USELOF_VMDMXSHA Max share is Absolute if ON, Max share is Relative if OFF. .1.. .... * ..1. .... * ...1 .... * .... 1... * .... .1.. * .... ..1. USELOF_VMDLIMTH Max share is Limithard if ON Max share is Limitsoft if OFF .... ...1 * 199 C7 Bitstring 1 USELOF_CALOSTAT Virtual machine operating status 1... .... USELOF_VMDSYSOP User is primary system operator .1.. .... USELOF_VMDUSRCT User is counted as being logged on ..1. .... * ...1 .... USELOF_VMDFORCE User is to be logged off. This may be requested by CP, a forced logoff, or user's logoff command. .... 1... USELOF_VMDUFORC User is forced to logoff the system .... .1.. USELOF_VMDDISC User is running disconnected .... ..1. USELOF_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 USELOF_VMDXAUTO The original command was XAUTOLOG. Valid for the base VMDBK only (see USEINT_CALBASE). 200 C8 Unsigned 4 USELOF_VMDBLKCT Count of SSCH's issued by BLOCKIO system service (includes both read and write requests) 204 CC Unsigned 4 USELOF_VMDMDCIA Count of SSCH's avoided due to Minidisk Cache read hit 208 D0 Unsigned 4 USELOF_VMDCOPCT Number of times this virtual CPU had to be redispatched due to a crypto operation exception 212 D4 Unsigned 4 USELOF_VMDCTISO Number of times ISOLATE occurred for spaces owned by this virtual system. Valid only in base VMDBK 216 D8 Unsigned 4 USELOF_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. 220 DC Unsigned 4 USELOF_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. 224 E0 Unsigned 4 USELOF_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 USELOF_ASCDEFSZ 228 E4 Unsigned 4 USELOF_VMDMXRVP Number of pages reserved for the user 232 E8 Character 8 USELOF_VMDACTNO User accounting number 240 F0 Character 8 USELOF_VMDGRPN RACF ACI group name 248 F8 Character 8 USELOF_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. 256 100 Unsigned 4 USELOF_VMDVDISK Count of virtual I/Os to a virtual disk in storage. 260 104 Unsigned 4 USELOF_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 USELOF_VMDMXSHA to determine if Max share is absolute or relative. 264 108 Unsigned 4 USELOF_VMDTHRCT Total number of times this user was delayed doing I/O to a throttled device 268 10C Character 8 USELOF_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'). 268 10C Character 4 USELOF_CALDEFHI high four bytes 272 110 Character 4 USELOF_CALDEFLO low four bytes 276 114 Unsigned 4 USELOF_VMDCTPVG Count of private address space resident pages in DPA owned by this virtual machine which are >= 2G. Valid only in base VMDBK. 280 118 Unsigned 4 USELOF_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. 284 11C Unsigned 4 USELOF_VEBALERT Number of alert interruptions Collected only for base VMDBK. 288 120 Unsigned 4 USELOF_VEBTVSCT Number of interceptions for guest TVS instructions Collected only for base VMDBK. 292 124 Unsigned 4 USELOF_VEBSVSCT Number of interceptions for guest SVS instructions Collected only for base VMDBK. 296 128 Unsigned 4 USELOF_VEBTPIAI Number of adapter interruptions delivered via guest TPI Collected only for base VMDBK. 300 12C Unsigned 4 USELOF_VEBVIRAI Number of adapter interruptions stacked for guest by CP Collected only for base VMDBK. 304 130 Unsigned 4 USELOF_VEBHDWAI Number of adapter interruptions delivered to guest inside SIE Collected only for base VMDBK. 308 134 Character 8 USELOF_VMDCTPVLA Cardinal count of locked pages in private address spaces >2G belonging to this user. See USELOF_VMDCTPVL for the <2G value. 316 13C Unsigned 4 USELOF_VMDCTSHL Count of shared address space resident pages <2G. Valid only in the SYSTEM VMDBK. 320 140 Character 8 USELOF_VMDCTSHLA Count of shared address space resident pages >2G. Valid only in the SYSTEM VMDBK. 328 148 Character 0 USELOF_END
MRUSELOF 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 USELOF 0 328 USELOF_ASCDEFSZ 10C 8 USELOF_CALCPMIG B8 4 USELOF_CALCPPGR 70 4 USELOF_CALCPPGW 74 4 USELOF_CALCPPST 98 4 USELOF_CALCPXRD C0 4 USELOF_CALCPXWT BC 4 USELOF_CALCTPGS 68 4 USELOF_CALDEFHI 10C 4 USELOF_CALDEFLO 110 4 USELOF_CALDIAL 22 20 USELOF_CALFLAG1 22 1 USELOF_CALMESA 1F 40 USELOF_CALMESAM 1F 04 USELOF_CALMODE 1F 1 USELOF_CALMXA 1F 20 USELOF_CALMXC 1F 08 USELOF_CALM370 1F 10 USELOF_CALOSTAT C7 1 USELOF_CALSHARF C6 1 USELOF_CALSNA 22 10 USELOF_CALTODON F8 8 USELOF_CALXSTOR 54 4 USELOF_END 148 0 USELOF_MRHDR 0 0 USELOF_VEBALERT 11C 4 USELOF_VEBHDWAI 130 4 USELOF_VEBSVSCT 124 4 USELOF_VEBTPIAI 128 4 USELOF_VEBTVSCT 120 4 USELOF_VEBVIRAI 12C 4 USELOF_VMDABSSH DC 4 USELOF_VMDACTNO E8 8 USELOF_VMDASMCT C4 2 USELOF_VMDAUTOL C7 02 USELOF_VMDBLKCT C8 4 USELOF_VMDCOPCT D0 4 USELOF_VMDCPUAD 1C 2 USELOF_VMDCTFLT 58 4 USELOF_VMDCTISO D4 4 USELOF_VMDCTORF 64 4 USELOF_VMDCTPVG 114 4 USELOF_VMDCTPVL 48 4 USELOF_VMDCTPVLA 134 8 USELOF_VMDCTPVR 44 4 USELOF_VMDCTPWT 6C 4 USELOF_VMDCTSHL 13C 4 USELOF_VMDCTSHLA 140 8 USELOF_VMDCTSPR 78 4 USELOF_VMDCTSPW 7C 4 USELOF_VMDCTXBK 50 4 USELOF_VMDDISC C7 04 USELOF_VMDELIST 21 1 USELOF_VMDFLREO 60 4 USELOF_VMDFORCE C7 10 USELOF_VMDGRPN F0 8 USELOF_VMDISEVM 9C 4 USELOF_VMDISTVM A0 4 USELOF_VMDISUVM A4 4 USELOF_VMDLIMTH C6 02 USELOF_VMDMDCIA CC 4 USELOF_VMDMODE 1E 1 USELOF_VMDMVB2G 118 4 USELOF_VMDMXRVP E4 4 USELOF_VMDMXSHA C6 80 USELOF_VMDMXSHR 104 4 USELOF_VMDNOFSL 22 04 USELOF_VMDNOINS 22 08 USELOF_VMDPGSPL 80 4 USELOF_VMDQDSPU 22 40 USELOF_VMDRELSH D8 4 USELOF_VMDSLIST 20 1 USELOF_VMDSSIZE E0 4 USELOF_VMDSTYPE 23 1 USELOF_VMDSYSOP C7 80 USELOF_VMDTHRCT 108 4 USELOF_VMDTTIME 24 8 USELOF_VMDUFORC C7 08 USELOF_VMDUSER 14 8 USELOF_VMDUSRCT C7 40 USELOF_VMDVCSCT 84 4 USELOF_VMDVDISK 100 4 USELOF_VMDVDSCT 88 4 USELOF_VMDVOSCT 94 4 USELOF_VMDVSEVM A8 4 USELOF_VMDVSTVM AC 4 USELOF_VMDVSUVM B0 4 USELOF_VMDVTIME 2C 8 USELOF_VMDVTSCT 90 4 USELOF_VMDVUSCT 8C 4 USELOF_VMDWSSPR 4C 4 USELOF_VMDXAUTO C7 01 USELOF_VMDX98CT B4 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