Programming Interface Information:
The Monitor Records are intended Programming Interfaces that allow the customer to write programs to obtain services of z/VM. |
MRUSELON
PrologControl Block Contents
Cross Reference
MRUSELON Prolog
DSECT NAME - USELON FUNCTION - Map a Monitor record. LOCATED BY - Through the Monitor Control Area REFERENCED CONTROL BLOCKS - MRRECHDR Monitor Record Header NAME - MRUSELON DESCRIPTIVE NAME - Monitor Event Record Domain 4 - User Domain Record 1 - User Logon DESCRIPTION - Records a user that has logged on. Generated for the base VMDBK only.
MRUSELON Control Block Contents
Offsets Dec Hex Type Len Name (Dim) Description 0 0 Structure 96 USELON Start of monitor record 0 0 Character 0 USELON_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 USELON_VMDUSER User logon identification 28 1C Unsigned 2 USELON_VMDCPUAD Processor address 30 1E Bitstring 1 USELON_VMDMODE Guest machine mode. This is as set for internal use by CP. See USELON_CALMODE for mode 'calculated' at. 31 1F Bitstring 1 USELON_CALSTAT User information 1... .... USELON_VMDSVMST 'OPTION SVMSTAT' has been specified in the user's directory .1.. .... USELON_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. .... USELON_CALDIAL This user is a dialed user ...1 .... USELON_CALSNA This user is connected through System Network Architecture (SNA) .... 1... USELON_VMDNOINS User is prevented from inserting any tracks into the minidisk cache. (set when SET MDC INS OFF command is issued) .... .1.. USELON_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 * 32 20 Unsigned 4 USELON_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. 36 24 Unsigned 4 USELON_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. 40 28 Bitstring 1 USELON_CALMODE Architectural mode of the virtual machine 1... .... * .1.. .... USELON_CALMESA ESA architecture ..1. .... USELON_CALMXA XA architecture ...1 .... USELON_CALM370 370 architecture .... 1... USELON_CALMXC XC architecture .... .1.. USELON_CALMESAM ESA mode user has entered z/Arch mode. Note that at this time it is impossible for a guest to show up as having entered z/Arch at logon time because guest has not had an opportunity to issue SIGP in order to enter z/Arch mode. .... ..1. * .... ...1 * 41 29 Bitstring 1 USELON_VMDSTYPE Storage type this virtual machine resides in. X'00' => V=V. X'80' => Reserved and no longer available. X'40' => V=F. 42 2A Bitstring 1 USELON_CALSHARF Set Share flags 1... .... USELON_VMDMXSHA Max share is Absolute if ON. Max share is Relative if OFF. .1.. .... * ..1. .... * ...1 .... * .... 1... * .... .1.. * .... ..1. USELON_VMDLIMTH Max share is Limithard is ON. Max share is Limitsoft is OFF. .... ...1 * 43 2B Unsigned 1 * Reserved and available for IBM use. 44 2C Unsigned 4 USELON_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 USELON_ASCDEFSZ 48 30 Unsigned 4 USELON_VMDMXRVP Number of pages reserved for the user 52 34 Character 8 USELON_VMDACTNO User accounting number 60 3C Character 8 USELON_VMDGRPN RACF ACI group name 68 44 Character 8 USELON_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. 76 4C Character 8 USELON_VMDBYVAL The BYUSER ID that logged on this virtual machine. If there is no BYUSER, this field is binary zeros. 84 54 Unsigned 4 USELON_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 USELON_VMDMXSHA to determine if Max share is absolute or relative. 88 58 Character 8 USELON_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 USELON_CALDEFHI high four bytes 92 5C Character 4 USELON_CALDEFLO low four bytes 96 60 Character 0 USELON_END
MRUSELON 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 USELON 0 96 USELON_ASCDEFSZ 58 8 USELON_CALDEFHI 58 4 USELON_CALDEFLO 5C 4 USELON_CALDIAL 1F 20 USELON_CALMESA 28 40 USELON_CALMESAM 28 04 USELON_CALMODE 28 1 USELON_CALMXA 28 20 USELON_CALMXC 28 08 USELON_CALM370 28 10 USELON_CALSHARF 2A 1 USELON_CALSNA 1F 10 USELON_CALSTAT 1F 1 USELON_CALTODON 44 8 USELON_END 60 0 USELON_MRHDR 0 0 USELON_VMDABSSH 24 4 USELON_VMDACTNO 34 8 USELON_VMDBYVAL 4C 8 USELON_VMDCPUAD 1C 2 USELON_VMDGRPN 3C 8 USELON_VMDLIMTH 2A 02 USELON_VMDMODE 1E 1 USELON_VMDMXRVP 30 4 USELON_VMDMXSHA 2A 80 USELON_VMDMXSHR 54 4 USELON_VMDNOFSL 1F 04 USELON_VMDNOINS 1F 08 USELON_VMDQDSPU 1F 40 USELON_VMDRELSH 20 4 USELON_VMDSSIZE 2C 4 USELON_VMDSTYPE 29 1 USELON_VMDSVMST 1F 80 USELON_VMDUSER 14 8
This information is based on z/VM V5R2.0.
Last updated on 11 Dec 2005 at 18:48:12.
Copyright IBM Corporation, 1990, 2005