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

MRSCLAEL

Prolog
Control Block Contents
Storage Layout
Cross Reference

MRSCLAEL Prolog

 DSECT NAME - SCLAEL
 FUNCTION - Map a Monitor record.
 LOCATED BY -
      Through the Monitor Control Area
 REFERENCED CONTROL BLOCKS -
      MRRECHDR    Monitor Record Header
 NAME - MRSCLAEL
 DESCRIPTIVE NAME - Monitor Event Record
                  Domain 2 - Scheduler
                  Record 6 - Add User To Eligible List
 DESCRIPTION - Indicates conditions after this user has been
             added to the eligible list.  A separate
             record is generated for each VMDBK in the
             virtual MP complex.


MRSCLAEL Control Block Contents

Offsets
Dec Hex  Type       Len  Name (Dim)         Description
 
  0   0  Structure  132  SCLAEL              Start of monitor record
  0   0  Character    0  SCLAEL_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  SCLAEL_VMDUSER      Userid
 28  1C  Unsigned     2  SCLAEL_SRMC1ELG     Cardinal count of short, medium
                                             and long-running users in the
                                             eligible list. This includes all
                                             E1, E2 and E3 users. It includes
                                             no E0 users.
 30  1E  Unsigned     2  SCLAEL_SRMC2ELG     Cardinal count of short, medium
                                             and long-running users in the
                                             eligible list. This includes all
                                             E2 and E3 users. It includes no E0
                                             or E1 users.
 32  20  Unsigned     2  SCLAEL_SRMC3ELG     Cardinal count of short, medium
                                             and long-running users in the
                                             eligible list. This includes all
                                             E3 users. It includes no no E0,
                                             E1, or E2 users.
 34  22  Unsigned     2  SCLAEL_VMDCPUAD     Virtual processor address
 36  24  Character    8  SCLAEL_VMDSVMID     VMDBK name for the last
                                             successful IUCV, VMCF or APPC/VM
                                             Send for this virtual machine.
                                             Valid in base VMDBK only.
 44  2C  Bitstring    1  SCLAEL_VMDSVMWT     Service-virtual-machine (SVM)
                                             wait flag byte - valid in base
                                             VMDBK only.
          1... ....      SCLAEL_VMDSVMWF     VMDBK is waiting for a response
                                             from IUCV, VMCF or APPC.
          .1.. ....      *                   
          ..1. ....      *                   
          ...1 ....      *                   
          .... 1...      *                   
          .... .1..      *                   
          .... ..1.      *                   
          .... ...1      *                   
 45  2D  Character    0  SCLAEL_VMDSVMW2     Back-up byte to the VMDSVMWT
                                             byte. Its contents will persist
                                             longer than they would in
                                             VMDSVMWT. Valid in base VMDBK
                                             only.
 45  2D  Bitstring    1  SCLAEL_VMDSVMWT     Service-virtual-machine (SVM)
                                             wait flag byte - valid in base
                                             VMDBK only.
          1... ....      SCLAEL_VMDSVMWF     VMDBK is waiting for a response
                                             from IUCV, VMCF or APPC.
 46  2E  Character    0  SCLAEL_VMDRDYCM     Flag byte set by IUCV, VMCF, or
                                             APPC whenever IUCV/VMCF/APPC makes
                                             an external interrupt. It is sort
                                             of a "reference byte" that tells
                                             the scheduler that IUCV/VMCF/APPC
                                             had been active recently. Valid in
                                             base VMDBK only.
 46  2E  Bitstring    1  SCLAEL_VMDSVMWT     Service-virtual-machine (SVM)
                                             wait flag byte - valid in base
                                             VMDBK only.
          1... ....      SCLAEL_VMDSVMWF     VMDBK is waiting for a response
                                             from IUCV, VMCF or APPC.
 47  2F  Bitstring    1  SCLAEL_CALFLAG1     Flag byte
          1... ....      SCLAEL_CALBASE      If on, this is the base VMDBK.
                                             VMDBASE
          .1.. ....      *                   
          ..1. ....      *                   
          ...1 ....      *                   
          .... 1...      *                   
          .... .1..      *                   
          .... ..1.      *                   
          .... ...1      *                   
 48  30  Unsigned     4  SCLAEL_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.
 52  34  Unsigned     4  SCLAEL_VMDPGRTE     Number of pages per second which
                                             this user read in during its last
                                             stay in the dispatch list
 56  38  Bitstring    1  SCLAEL_CALQSTAT     Scheduling status of user
          1... ....      SCLAEL_VMDHOTRQ     Hot Shot scheduling requested
          .1.. ....      SCLAEL_VMDHOTST     Hot Shot user scheduling granted
          ..1. ....      SCLAEL_VMDLOADU     Loading user designation
          ...1 ....      SCLAEL_VMDIABIA     Interactive bias is in effect
          .... 1...      SCLAEL_VMDPGBIA     Paging bias is in effect
          .... .1..      SCLAEL_VMDLKSHT     "Lockshot" scheduling in effect
                                             for this user. Set only in the
                                             base VMDBK.
          .... ..1.      *                   
          .... ...1      SCLAEL_VMDNULL      User is logging off
 57  39  Unsigned     1  SCLAEL_VMDELIST     This user's eligible list class.
                                             It can be 0, 1, 2, or 3. Classes
                                             1-3 relate to the time this
                                             (scheduler-determined) transaction
                                             has been running. Class 1 is
                                             short-running, class 2,
                                             medium-running and class 3,
                                             long-running.
 58  3A  Bitstring    1  SCLAEL_VMDWRKCS     Type of work which must be done
                                             on the VMDBK
 59  3B  Bitstring    1  SCLAEL_CALOSTAT     Virtual machine operating status
          1... ....      SCLAEL_VMDSYSOP     User is primary system operator
          .1.. ....      SCLAEL_VMDUSRCT     User is counted as being logged
                                             on
          ..1. ....      *                   
          ...1 ....      SCLAEL_VMDFORCE     User is to be logged off. This
                                             may be requested by CP, a forced
                                             logoff, or user's logoff command.
          .... 1...      SCLAEL_VMDUFORC     User is forced to logoff the
                                             system
          .... .1..      SCLAEL_VMDDISC      User is running disconnected
          .... ..1.      SCLAEL_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      SCLAEL_VMDXAUTO     The original command was
                                             XAUTOLOG. Valid for the base VMDBK
                                             only.
 60  3C  Character    8  SCLAEL_VMDEPRTY     Eligible list priority. This
                                             represents the scheduler's
                                             estimate of the latest time this
                                             VMDBK should be selected to go
                                             into the dispatch list from the
                                             eligible list. It is used to order
                                             users in the eligible list.
 68  44  Unsigned     4  SCLAEL_VMDCTPVR     Cardinal count of resident pages
                                             in private address spaces
                                             belonging to this user. This
                                             monitor field is actually the sum
                                             of VMDCTPVR + VMDCTPVG which is
                                             the resident pages above and below
                                             the 2GB line. To get the count of
                                             resident pages below the 2GB line,
                                             subtract SCLAEL_VMDCTPVG from
                                             SCLAEL_VMDCTPVR.
 72  48  Unsigned     4  SCLAEL_VMDCTXBK     Number of Expanded Storage
                                             blocks allocated to a virtual
                                             machine by CP for paging
 76  4C  Unsigned     4  SCLAEL_CALCPPST     Cumulative count of pages stolen
                                             from this user's address spaces
                                             while they were private.
 80  50  Unsigned     4  SCLAEL_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 this 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.
 84  54  Unsigned     4  SCLAEL_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.
 88  58  Signed       4  SCLAEL_VMDURRSP     User's resource requirement for
                                             storage and paging
 92  5C  Signed       4  SCLAEL_SRMABSDE     Cardinal count of total absolute
                                             shares of all VMDBKs in the
                                             dispatch and eligible lists. Unit
                                             of value is same as
                                             SCLAEL_VMDABSSH.
 96  60  Signed       4  SCLAEL_SRMRELDE     Cardinal count of total relative
                                             shares of all VMDBKs in the
                                             dispatch and eligible lists.
100  64  Unsigned     4  SCLAEL_VMDCTCRT     Count of CP critical-processes
                                             this VMDBK is responsible for.
                                             VMDBK must not wait in eligible
                                             list while this count is greater
                                             than 0. Valid only in base VMDBK.
104  68  Bitstring    1  SCLAEL_CALSHARF     Set Share flags
          1... ....      SCLAEL_VMDMXSHA     Max share is Absolute if ON. Max
                                             share is Relative if OFF.
          .1.. ....      *                   
          ..1. ....      *                   
          ...1 ....      *                   
          .... 1...      *                   
          .... .1..      *                   
          .... ..1.      SCLAEL_VMDLIMTH     Max Share is Limithard if ON.
                                             Max Share is Limitsoft if OFF.
          .... ...1      *                   
105  69  Unsigned     3  *                   Reserved and available for IBM
                                             use.
108  6C  Unsigned     4  SCLAEL_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 SCLAEL_VMDMXSHA to determine
                                             if Max share is absolute or
                                             relative.
112  70  Character    8  SCLAEL_SRMATOD      Artificial TOD. This TOD only
                                             advances at the rate the system is
                                             running user work.
120  78  Character    8  SCLAEL_SRMATOD2     Artificial TOD2. This TOD only
                                             advances with each CPU's user time
                                             and each CPU's wait time.
128  80  Unsigned     4  SCLAEL_VMDCTPVG     Count of private address space
                                             resident pages in DPA owned by
                                             this virtual machine which are
                                             above the 2GB line. Valid only in
                                             base VMDBK. To get total resident
                                             pages under the 2GB line, subtract
                                             this field from SCLAEL_VMDCTPVR.
132  84  Character    0  SCLAEL_END          

MRSCLAEL 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
SCLAEL                  0    132
SCLAEL_CALBASE         2F           80
SCLAEL_CALCPPST        4C      4
SCLAEL_CALFLAG1        2F      1
SCLAEL_CALOSTAT        3B      1
SCLAEL_CALQSTAT        38      1
SCLAEL_CALSHARF        68      1
SCLAEL_END             84      0
SCLAEL_MRHDR            0      0
SCLAEL_SRMABSDE        5C      4
SCLAEL_SRMATOD         70      8
SCLAEL_SRMATOD2        78      8
SCLAEL_SRMC1ELG        1C      2
SCLAEL_SRMC2ELG        1E      2
SCLAEL_SRMC3ELG        20      2
SCLAEL_SRMRELDE        60      4
SCLAEL_VMDABSSH        54      4
SCLAEL_VMDAUTOL        3B           02
SCLAEL_VMDCPUAD        22      2
SCLAEL_VMDCTCRT        64      4
SCLAEL_VMDCTPVG        80      4
SCLAEL_VMDCTPVR        44      4
SCLAEL_VMDCTXBK        48      4
SCLAEL_VMDDISC         3B           04
SCLAEL_VMDELIST        39      1
SCLAEL_VMDEPRTY        3C      8
SCLAEL_VMDFORCE        3B           10
SCLAEL_VMDHOTRQ        38           80
SCLAEL_VMDHOTST        38           40
SCLAEL_VMDIABIA        38           10
SCLAEL_VMDLIMTH        68           02
SCLAEL_VMDLKSHT        38           04
SCLAEL_VMDLOADU        38           20
SCLAEL_VMDMXSHA        68           80
SCLAEL_VMDMXSHR        6C      4
SCLAEL_VMDNULL         38           01
SCLAEL_VMDPGBIA        38           08
SCLAEL_VMDPGRTE        34      4
SCLAEL_VMDRDYCM        2E      0
SCLAEL_VMDRELSH        50      4
SCLAEL_VMDSVMID        24      8
SCLAEL_VMDSVMWF        2C           80
SCLAEL_VMDSVMWF        2D           80
SCLAEL_VMDSVMWF        2E           80
SCLAEL_VMDSVMWT        2C      1
SCLAEL_VMDSVMWT        2D      1
SCLAEL_VMDSVMWT        2E      1
SCLAEL_VMDSVMW2        2D      0
SCLAEL_VMDSYSOP        3B           80
SCLAEL_VMDUFORC        3B           08
SCLAEL_VMDURRSP        58      4
SCLAEL_VMDUSER         14      8
SCLAEL_VMDUSRCT        3B           40
SCLAEL_VMDWRKCS        3A      1
SCLAEL_VMDWSSPR        30      4
SCLAEL_VMDXAUTO        3B           01

This information is based on z/VM V4R2.0.
Last updated on 15 Oct 2001 at 08:04:23.
Copyright IBM Corporation, 1990, 2001