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

MRUSELON

Prolog
Control 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  176  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.      USELON_VMDMASST        Collaborative Memory
                                                Management assist enabled.
                                                Note: The VMDMAACT bit is not
                                                provided in this record because
                                                a recently logged on user would
                                                not yet be in a CMM-active or
                                                CMM-pending-off state.
          .... ...1      *                      
 32  20  Unsigned     4  USELON_VMDRELSH        This virtual CPU's RELATIVE
                                                share of the system, as set in
                                                the user's directory or via the
                                                SET SHARE command. Set to zero
                                                when this VMDBK has an ABSOLUTE
                                                share value, or has a virtual
                                                processor dedicated to it, or
                                                is in the process of being
                                                logged off.
 36  24  Unsigned     4  USELON_VMDABSSH        This virtual CPU'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 when this VMDBK has
                                                a RELATIVE share value.
 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 for this CPU is
                                                ABSOLUTE if on. Max share for
                                                this CPU is RELATIVE if off.
          .1.. ....      *                      
          ..1. ....      *                      
          ...1 ....      *                      
          .... 1...      *                      
          .... .1..      *                      
          .... ..1.      USELON_VMDLIMTH        Max share for this CPU is
                                                LIMITHARD if on. Max share for
                                                this CPU is LIMITSOFT if 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        This virtual CPU'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  Unsigned     4  USELON_CP_SSHRELSH     This user's RELATIVE share
                                                setting for CPUs of type CP.
100  64  Unsigned     4  USELON_CP_SSHABSSH     This user's ABSOLUTE share
                                                setting for CPUs of type CP.
104  68  Unsigned     4  USELON_CP_SSHMXSHR     This user's Max share setting
                                                for CPUs of type CP.
108  6C  Bitstring    1  USELON_CP_SSHFLG1      This user's share flags for
                                                CPUs of type CP.
          1... ....      *                      
          .1.. ....      USELON_CP_SSHLIMH      Max share for type CP is
                                                LIMITHARD if on. Max share for
                                                type CP is LIMITSOFT if off.
          ..1. ....      USELON_CP_SSHNMSHA     Normal share for type CP is
                                                ABSOLUTE if on. Normal share
                                                for type CP is RELATIVE if off.
          ...1 ....      USELON_CP_SSHMXSHA     Max share for type CP is
                                                ABSOLUTE if on. Max share for
                                                type CP is RELATIVE if off.
          .... 1...      *                      
          .... .1..      *                      
          .... ..1.      *                      
          .... ...1      *                      
109  6D  Bitstring    3  *                      Reserved and available for
                                                IBM use.
112  70  Unsigned     4  USELON_ZAP_SSHRELSH    This user's RELATIVE share
                                                setting for CPUs of type zAAP.
116  74  Unsigned     4  USELON_ZAP_SSHABSSH    This user's ABSOLUTE share
                                                setting for CPUs of type zAAP.
120  78  Unsigned     4  USELON_ZAP_SSHMXSHR    This user's Max share setting
                                                for CPUs of type zAAP.
124  7C  Bitstring    1  USELON_ZAP_SSHFLG1     This user's share flags for
                                                CPUs of type zAAP.
          1... ....      *                      
          .1.. ....      USELON_ZAP_SSHLIMH     Max share for type zAAP is
                                                LIMITHARD if on. Max share for
                                                type zAAP is LIMITSOFT if off.
          ..1. ....      USELON_ZAP_SSHNMSHA    Normal share for type zAAP is
                                                ABSOLUTE if on. Normal share
                                                for type zAAP is RELATIVE if
                                                off.
          ...1 ....      USELON_ZAP_SSHMXSHA    Max share for type zAAP is
                                                ABSOLUTE if on. Max share for
                                                type zAAP is RELATIVE if off.
          .... 1...      *                      
          .... .1..      *                      
          .... ..1.      *                      
          .... ...1      *                      
125  7D  Bitstring    3  *                      Reserved and available for
                                                IBM use.
128  80  Unsigned     4  USELON_IFL_SSHRELSH    This user's RELATIVE share
                                                setting for CPUs of type IFL.
132  84  Unsigned     4  USELON_IFL_SSHABSSH    This user's ABSOLUTE share
                                                setting for CPUs of type IFL.
136  88  Unsigned     4  USELON_IFL_SSHMXSHR    This user's Max share setting
                                                for CPUs of type IFL.
140  8C  Bitstring    1  USELON_IFL_SSHFLG1     This user's share flags for
                                                CPUs of type IFL.
          1... ....      *                      
          .1.. ....      USELON_IFL_SSHLIMH     Max share for type IFL is
                                                LIMITHARD if on. Max share for
                                                type IFL is LIMITSOFT if off.
          ..1. ....      USELON_IFL_SSHNMSHA    Normal share for type IFL is
                                                ABSOLUTE if on. Normal share
                                                for type IFL is RELATIVE if
                                                off.
          ...1 ....      USELON_IFL_SSHMXSHA    Max share for type IFL is
                                                ABSOLUTE if on. Max share for
                                                type IFL is RELATIVE if off.
          .... 1...      *                      
          .... .1..      *                      
          .... ..1.      *                      
          .... ...1      *                      
141  8D  Bitstring    3  *                      Reserved and available for
                                                IBM use.
144  90  Unsigned     4  USELON_ICF_SSHRELSH    This user's RELATIVE share
                                                setting for CPUs of type ICF.
148  94  Unsigned     4  USELON_ICF_SSHABSSH    This user's ABSOLUTE share
                                                setting for CPUs of type ICF.
152  98  Unsigned     4  USELON_ICF_SSHMXSHR    This user's Max share setting
                                                for CPUs of type ICF.
156  9C  Bitstring    1  USELON_ICF_SSHFLG1     This user's share flags for
                                                CPUs of type ICF.
          1... ....      *                      
          .1.. ....      USELON_ICF_SSHLIMH     Max share for type ICF is
                                                LIMITHARD if on. Max share for
                                                type ICF is LIMITSOFT if off.
          ..1. ....      USELON_ICF_SSHNMSHA    Normal share for type ICF is
                                                ABSOLUTE if on. Normal share
                                                for type ICF is RELATIVE if
                                                off.
          ...1 ....      USELON_ICF_SSHMXSHA    Max share for type ICF is
                                                ABSOLUTE if on. Max share for
                                                type ICF is RELATIVE if off.
          .... 1...      *                      
          .... .1..      *                      
          .... ..1.      *                      
          .... ...1      *                      
157  9D  Bitstring    3  *                      Reserved and available for
                                                IBM use.
160  A0  Unsigned     4  USELON_ZIP_SSHRELSH    This user's RELATIVE share
                                                setting for CPUs of type zIIP.
164  A4  Unsigned     4  USELON_ZIP_SSHABSSH    This user's ABSOLUTE share
                                                setting for CPUs of type zIIP.
168  A8  Unsigned     4  USELON_ZIP_SSHMXSHR    This user's Max share setting
                                                for CPUs of type zIIP.
172  AC  Bitstring    1  USELON_ZIP_SSHFLG1     This user's share flags for
                                                CPUs of type zIIP.
          1... ....      *                      
          .1.. ....      USELON_ZIP_SSHLIMH     Max share for type zIIP is
                                                LIMITHARD if on. Max share for
                                                type zIIP is LIMITSOFT if off.
          ..1. ....      USELON_ZIP_SSHNMSHA    Normal share for type zIIP is
                                                ABSOLUTE if on. Normal share
                                                for type zIIP is RELATIVE if
                                                off.
          ...1 ....      USELON_ZIP_SSHMXSHA    Max share for type zIIP is
                                                ABSOLUTE if on. Max share for
                                                type zIIP is RELATIVE if off.
          .... 1...      *                      
          .... .1..      *                      
          .... ..1.      *                      
          .... ...1      *                      
173  AD  Bitstring    3  *                      Reserved and available for
                                                IBM use.
176  B0  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    176
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_CP_SSHABSSH        64      4
USELON_CP_SSHFLG1         6C      1
USELON_CP_SSHLIMH         6C           40
USELON_CP_SSHMXSHA        6C           10
USELON_CP_SSHMXSHR        68      4
USELON_CP_SSHNMSHA        6C           20
USELON_CP_SSHRELSH        60      4
USELON_END                B0      0
USELON_ICF_SSHABSSH       94      4
USELON_ICF_SSHFLG1        9C      1
USELON_ICF_SSHLIMH        9C           40
USELON_ICF_SSHMXSHA       9C           10
USELON_ICF_SSHMXSHR       98      4
USELON_ICF_SSHNMSHA       9C           20
USELON_ICF_SSHRELSH       90      4
USELON_IFL_SSHABSSH       84      4
USELON_IFL_SSHFLG1        8C      1
USELON_IFL_SSHLIMH        8C           40
USELON_IFL_SSHMXSHA       8C           10
USELON_IFL_SSHMXSHR       88      4
USELON_IFL_SSHNMSHA       8C           20
USELON_IFL_SSHRELSH       80      4
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_VMDMASST           1F           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
USELON_ZAP_SSHABSSH       74      4
USELON_ZAP_SSHFLG1        7C      1
USELON_ZAP_SSHLIMH        7C           40
USELON_ZAP_SSHMXSHA       7C           10
USELON_ZAP_SSHMXSHR       78      4
USELON_ZAP_SSHNMSHA       7C           20
USELON_ZAP_SSHRELSH       70      4
USELON_ZIP_SSHABSSH       A4      4
USELON_ZIP_SSHFLG1        AC      1
USELON_ZIP_SSHLIMH        AC           40
USELON_ZIP_SSHMXSHA       AC           10
USELON_ZIP_SSHMXSHR       A8      4
USELON_ZIP_SSHNMSHA       AC           20
USELON_ZIP_SSHRELSH       A0      4

This information is based on z/VM V5R4.0.
Last updated on 5 Sep 2008 at 09:11:41.
Copyright IBM Corporation, 1990, 2008