Programming Interface Information:
The Monitor Records are intended Programming Interfaces that
allow the customer to write programs to obtain services of z/VM.

MRUSELOF

Prolog
Control Block Contents
Storage Layout
Cross Reference

MRUSELOF Prolog

 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 Contents

Offsets
Dec Hex  Type       Len  Name (Dim)          Description
 
  0   0  Structure  284  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
                                             64-bit 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' => V=R. 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  USELOF_VMDVFVTM     Amount of time, in TOD clock
                                             units, that is consumed by the
                                             guest using vector instructions
                                             while in SIE
 60  3C  Character    8  USELOF_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  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
                                             belonging to this user.
 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  USELOF_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  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 64-bit 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  Character    0  USELOF_END          

MRUSELOF 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
USELOF                  0    284
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            11C      0
USELOF_MRHDR            0      0
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_VMDCTPVR        44      4
USELOF_VMDCTPWT        6C      4
USELOF_VMDCTSPR        78      4
USELOF_VMDCTSPW        7C      4
USELOF_VMDCTVFL        5C      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_VMDVFOTM        3C      8
USELOF_VMDVFVTM        34      8
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 V4R3.0.
Last updated on 1 May 2002 at 16:20:33.
Copyright IBM Corporation, 1990, 2002