Programming Interface Information:
The Monitor Records are intended Programming Interfaces that allow the customer to write programs to obtain services of z/VM. |
MRMTRUSR
PrologControl Block Contents
Cross Reference
MRMTRUSR Prolog
DSECT NAME - MTRUSR FUNCTION - Map a Monitor record. LOCATED BY - Through the Monitor Control Area REFERENCED CONTROL BLOCKS - MRRECHDR Monitor Record Header NAME - MRMTRUSR DESCRIPTIVE NAME - Monitor Sample Configuration Record Domain 1 - Monitor Domain Record 15 - Logged on User DESCRIPTION - Description of a logged on user at the time the MONITOR SAMPLE START command is issued. A separate record is generated for each logged-on user.
MRMTRUSR Control Block Contents
Offsets Dec Hex Type Len Name (Dim) Description 0 0 Structure 116 MTRUSR Start of monitor record 0 0 Character 0 MTRUSR_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 MTRUSR_VMDUSER User identification 28 1C Unsigned 2 MTRUSR_VMDCPUAD Processor address 30 1E Bitstring 1 MTRUSR_VMDMODE Guest machine mode. This is as set for internal use by CP. See MTRUSR_CALMODE for the mode 'calculated' at. 31 1F Unsigned 1 MTRUSR_VMDCPUCT Number of guest defined CPUs including secondary processors. Note: This number is always one less than the total number of processors defined because the base processor is not guest defined. 32 20 Bitstring 1 MTRUSR_CALSTAT User information 1... .... MTRUSR_VMDSVMST 'OPTION SVMSTAT' has been specified in the user's directory .1.. .... MTRUSR_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. .... MTRUSR_CALDIAL This user is a dialed user ...1 .... MTRUSR_CALSNA This user is connected through System Network Architecture (SNA) .... 1... MTRUSR_VMDNOINS User is prevented from inserting any tracks into the minidisk cache. (set when SET MDC INS OFF command is issued) .... .1.. MTRUSR_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 * 33 21 Bitstring 1 MTRUSR_CALMODE Architectural mode of the virtual machine 1... .... * .1.. .... MTRUSR_CALMESA ESA architecture ..1. .... MTRUSR_CALMXA XA architecture ...1 .... MTRUSR_CALM370 370 architecture .... 1... MTRUSR_CALMXC XC architecture .... .1.. MTRUSR_CALMESAM ESA mode machine has entered z/Arch .... ..1. * .... ...1 * 34 22 Bitstring 1 MTRUSR_VMDSTYPE Storage type this virtual machine resides in. X'00' => V=V. X'80' => Reserved and no longer available. X'40' => V=F. 35 23 Bitstring 1 MTRUSR_CALSHARF Set Share flags 1... .... MTRUSR_VMDMXSHA Max share is Absolute if ON. Max share is Relative if OFF. .1.. .... * ..1. .... * ...1 .... * .... 1... * .... .1.. * .... ..1. MTRUSR_VMDLIMTH Max share is Limithard if ON. Max share is Limitsoft if OFF. .... ...1 * 36 24 Unsigned 4 MTRUSR_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 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. 40 28 Unsigned 4 MTRUSR_VMDABSSH The 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. 44 2C Unsigned 4 MTRUSR_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 MTRUSR_ASCDEFSZ 48 30 Character 8 MTRUSR_VMDACTNO User accounting number 56 38 Character 8 MTRUSR_VMDGRPN External Security Manager group name 64 40 Unsigned 4 MTRUSR_VMDMXRVP Number of pages reserved for the user 68 44 Character 8 MTRUSR_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. Note: This value captures the first 32 bits of the TOD clock which gives approximately one second of granularity. 76 4C Character 8 MTRUSR_VMDBYVAL The BYUSER ID that logged on this virtual machine. If there is no BYUSER, this field is binary zeros. 84 54 Unsigned 4 MTRUSR_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 MTRUSR_VMDMXSHA to determine if Max share is absolute or relative. 88 58 Character 8 MTRUSR_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'). 88 58 Character 4 MTRUSR_CALDEFHI high four bytes 92 5C Character 4 MTRUSR_CALDEFLO low four bytes 96 60 Unsigned 4 MTRUSR_CALCPCT Number of guest defined CP CPUs 100 64 Unsigned 4 MTRUSR_CALZIPCT Number of guest defined zIIP CPUs 104 68 Unsigned 4 MTRUSR_CALZAPCT Number of guest defined zAAP CPUs 108 6C Unsigned 4 MTRUSR_CALIFLCT Number of guest defined IFL CPUs 112 70 Bitstring 1 MTRUSR_VMDCFGEM Virtual configuration indicators. Valid in base VMDBK only 1... .... * .1.. .... MTRUSR_VMDCPUAF User requested CPU Affinity ..1. .... * ...1 .... * .... 1... * .... .1.. * .... ..1. * .... ...1 * 113 71 Bitstring 1 MTRUSR_VMDPUST CPU Status flag 1... .... MTRUSR_VMDAFSUP CPU Affinity suppressed .1.. .... * ..1. .... * ...1 .... * .... 1... * .... .1.. * .... ..1. * .... ...1 * 114 72 Character 2 * Reserved for IBM use 116 74 Character 0 MTRUSR_END
MRMTRUSR Cross Reference
Hex 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 MTRUSR 0 116 MTRUSR_ASCDEFSZ 58 8 MTRUSR_CALCPCT 60 4 MTRUSR_CALDEFHI 58 4 MTRUSR_CALDEFLO 5C 4 MTRUSR_CALDIAL 20 20 MTRUSR_CALIFLCT 6C 4 MTRUSR_CALMESA 21 40 MTRUSR_CALMESAM 21 04 MTRUSR_CALMODE 21 1 MTRUSR_CALMXA 21 20 MTRUSR_CALMXC 21 08 MTRUSR_CALM370 21 10 MTRUSR_CALSHARF 23 1 MTRUSR_CALSNA 20 10 MTRUSR_CALSTAT 20 1 MTRUSR_CALTODON 44 8 MTRUSR_CALZAPCT 68 4 MTRUSR_CALZIPCT 64 4 MTRUSR_END 74 0 MTRUSR_MRHDR 0 0 MTRUSR_VMDABSSH 28 4 MTRUSR_VMDACTNO 30 8 MTRUSR_VMDAFSUP 71 80 MTRUSR_VMDBYVAL 4C 8 MTRUSR_VMDCFGEM 70 1 MTRUSR_VMDCPUAD 1C 2 MTRUSR_VMDCPUAF 70 40 MTRUSR_VMDCPUCT 1F 1 MTRUSR_VMDGRPN 38 8 MTRUSR_VMDLIMTH 23 02 MTRUSR_VMDMODE 1E 1 MTRUSR_VMDMXRVP 40 4 MTRUSR_VMDMXSHA 23 80 MTRUSR_VMDMXSHR 54 4 MTRUSR_VMDNOFSL 20 04 MTRUSR_VMDNOINS 20 08 MTRUSR_VMDPUST 71 1 MTRUSR_VMDQDSPU 20 40 MTRUSR_VMDRELSH 24 4 MTRUSR_VMDSSIZE 2C 4 MTRUSR_VMDSTYPE 22 1 MTRUSR_VMDSVMST 20 80 MTRUSR_VMDUSER 14 8
This information is based on z/VM V5R3.0.
Last updated on 12 Jun 2007 at 12:35:23.
Copyright IBM Corporation, 1990, 2007