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

MRSCLADL

Prolog
Control Block Contents
Storage Layout
Cross Reference

MRSCLADL Prolog

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


MRSCLADL Control Block Contents

Offsets
Dec Hex  Type       Len  Name (Dim)         Description
 
  0   0  Structure  196  SCLADL              Start of monitor record
  0   0  Character    0  SCLADL_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  SCLADL_VMDUSER      Userid
 28  1C  Unsigned     4  SCLADL_SRMTOTST     Memory available to the
                                             scheduler to assign to users as
                                             they enter the dispatch list
 32  20  Unsigned     4  SCLADL_SRMWSSDL     Accumulated count of all
                                             dispatch list users' working set
                                             sizes. This is an instantaneous
                                             (not a smoothed) value.
 36  24  Unsigned     2  SCLADL_SRMCDISP     Cardinal count of users in the
                                             dispatch list.
 38  26  Unsigned     2  SCLADL_SRMC1DSP     Cardinal count of short, medium,
                                             and long running users in the
                                             dispatch list.
 40  28  Unsigned     2  SCLADL_SRMC2DSP     Cardinal count of medium and
                                             long running users in the dispatch
                                             list. This includes all Q2 and Q3
                                             users. It includes no Q1 or Q0
                                             users.
 42  2A  Unsigned     2  SCLADL_SRMC3DSP     Cardinal count of long running
                                             users in the dispatch list. It
                                             includes all Q3 users. It includes
                                             no Q1, Q2, or Q0 users.
 44  2C  Character    8  SCLADL_VMDSVMID     VMDBK name for the last
                                             successful IUCV, VMCF or APPC/VM
                                             Send for this virtual machine.
                                             Valid in base VMDBK only.
 52  34  Bitstring    1  SCLADL_VMDSVMWT     Service-virtual-machine (SVM)
                                             wait flag - valid in base VMDBK
                                             only.
          1... ....      SCLADL_VMDSVMWF     VMDBK is waiting for a response
                                             from IUCV, VMCF or APPC.
          .1.. ....      *                   
          ..1. ....      *                   
          ...1 ....      *                   
          .... 1...      *                   
          .... .1..      *                   
          .... ..1.      *                   
          .... ...1      *                   
 53  35  Character    0  SCLADL_VMDSVMW2     back-up byte to the VMDSVMWT
                                             byte. Its contents will persist
                                             longer than they would in
                                             VMDSVMWT. Valid in base VMDBK
                                             only.
 53  35  Bitstring    1  SCLADL_VMDSVMWT     Service-virtual-machine (SVM)
                                             wait flag - valid in base VMDBK
                                             only.
          1... ....      SCLADL_VMDSVMWF     VMDBK is waiting for a response
                                             from IUCV, VMCF or APPC.
 54  36  Character    0  SCLADL_VMDRDYCM     Flag byte set by IUCV, VMCF, or
                                             APPC whenever IUCV/VMCF/APPC makes
                                             an external interrupt pending in a
                                             virtual machine. It is sort of a
                                             "reference bit" that tells the
                                             scheduler that IUCV/VMCF/APPC has
                                             been active recently. Valid in
                                             base VMDBK only.
 54  36  Bitstring    1  SCLADL_VMDSVMWT     Service-virtual-machine (SVM)
                                             wait flag - valid in base VMDBK
                                             only.
          1... ....      SCLADL_VMDSVMWF     VMDBK is waiting for a response
                                             from IUCV, VMCF or APPC.
 55  37  Bitstring    1  SCLADL_CALFLAG1     Flag byte
          1... ....      SCLADL_CALBASE      If on, this is base VMDBK.
                                             VMDBASE
          .1.. ....      *                   
          ..1. ....      *                   
          ...1 ....      *                   
          .... 1...      *                   
          .... .1..      *                   
          .... ..1.      *                   
          .... ...1      *                   
 56  38  Unsigned     4  SCLADL_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.
 60  3C  Unsigned     4  SCLADL_VMDPGRTE     Number of pages per second which
                                             this user read in during its last
                                             stay in the dispatch list
 64  40  Bitstring    1  SCLADL_CALQSTAT     Scheduling status of user
          1... ....      SCLADL_VMDHOTRQ     Hot Shot scheduling requested
          .1.. ....      SCLADL_VMDHOTST     Hot Shot user scheduling granted
          ..1. ....      SCLADL_VMDLOADU     Loading user designation
          ...1 ....      SCLADL_VMDIABIA     Interactive bias is in effect
          .... 1...      SCLADL_VMDPGBIA     Paging bias is in effect
          .... .1..      SCLADL_VMDLKSHT     "Lockshot" scheduling in effect
                                             for this user. Set only in the
                                             base VMDBK.
          .... ..1.      *                   
          .... ...1      SCLADL_VMDNULL      User is logging off
 65  41  Unsigned     1  SCLADL_VMDELIST     This user's dispatch list class.
                                             It can be 0, 1, 2, or 3. Class 1-3
                                             relate to the time this (scheduler
                                             determined) transaction has been
                                             running. Class 1 are
                                             short-running, class 2,
                                             medium-running and class 3,
                                             long-running.
 66  42  Unsigned     2  SCLADL_VMDCPUAD     Virtual processor address
 68  44  Unsigned     4  SCLADL_VMDRPLIM     Resident page growth limit
 72  48  Unsigned     4  SCLADL_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 SCLADL_VMDCTPVG from
                                             SCLADL_VMDCTPVR.
 76  4C  Character    8  SCLADL_VMDVTIME     Total time that this user was
                                             was running, 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
                                             SCLADL_VMDVTIME is the elapsed
                                             time in TOD clock units.
 84  54  Character    8  SCLADL_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
                                             SCLADL_VMDTTIME is the elapsed
                                             time in TOD clock units.
 92  5C  Character    8  SCLADL_VMDEPRTY     The eligible list priority, in
                                             TOD clock units. This is the 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.
100  64  Character    8  SCLADL_VMDDPRTY     The user's dispatch list
                                             priority. This is based upon the
                                             user's SHARE, its time spent in
                                             the eligible list and SHARES of
                                             all other dispatch list users. It
                                             is then adjusted by such factors
                                             as interactive bias, paging bias
                                             and limits on how large or small
                                             this priority is allowed to be. It
                                             represents the relative order in
                                             which this user will be selected
                                             to be dispatched.
108  6C  Character    8  SCLADL_VMDOPRTY     This user's dispatch priority
                                             before adjustment factors such as
                                             interactive bias and paging bias
116  74  Unsigned     4  SCLADL_VMDRTHRU     This user's 'required
                                             throughput' or 'resource access'
                                             in the dispatch list
120  78  Unsigned     4  SCLADL_VMDCTXBK     Number of Expanded Storage
                                             blocks allocated to a virtual
                                             machine by CP for paging
124  7C  Unsigned     4  SCLADL_VMDFLREO     Number of frame list reorders
                                             for this virtual system's list of
                                             frames
128  80  Unsigned     4  SCLADL_VMDCTORF     Total number of referenced
                                             frames resident when reset was
                                             done for this virtual system
132  84  Unsigned     4  SCLADL_CALCPPST     Cumulative count of pages stolen
                                             from this user's address spaces
                                             while they were private.
136  88  Bitstring    1  SCLADL_CALOSTAT     Virtual machine operating status
          1... ....      SCLADL_VMDSYSOP     User is primary system operator
          .1.. ....      SCLADL_VMDUSRCT     User is counted as being logged
                                             on
          ..1. ....      *                   
          ...1 ....      SCLADL_VMDFORCE     User is to be logged off. This
                                             may be requested by CP, a forced
                                             logoff, or user's logoff command.
          .... 1...      SCLADL_VMDUFORC     User is forced to logoff the
                                             system
          .... .1..      SCLADL_VMDDISC      User is running disconnected
          .... ..1.      SCLADL_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      SCLADL_VMDXAUTO     The original command was
                                             XAUTOLOG. Valid for the base VMDBK
                                             only.
137  89  Bitstring    1  SCLADL_CALSHARF     Set Share flags
          1... ....      SCLADL_VMDMXSHA     Max share is Absolute if ON. Max
                                             share is Relative if OFF.
          .1.. ....      *                   
          ..1. ....      *                   
          ...1 ....      *                   
          .... 1...      *                   
          .... .1..      *                   
          .... ..1.      SCLADL_VMDLIMTH     Max Share is Limithard if ON.
                                             Max Share is Limitsoft if OFF.
          .... ...1      *                   
138  8A  Signed       2  SCLADL_VMDSLCNT     Count of minor time slices that
                                             have expired since the start of
                                             current transaction.
140  8C  Character    8  SCLADL_VMDESLIC     The elapsed time slice this user
                                             will receive in the dispatch list
                                             before having to return to the
                                             eligible list.
148  94  Unsigned     4  SCLADL_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 this VMDBK has a virtual
                                             processor dedicated to it, and
                                             this is a virtual UP user.
152  98  Unsigned     4  SCLADL_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.
156  9C  Unsigned     4  SCLADL_VMDVUSCT     Count of start requests to
                                             virtual unit record devices
160  A0  Signed       4  SCLADL_SRMABSDL     Cardinal count of total absolute
                                             shares of all VMDBKs in the
                                             dispatch list. The unit of value
                                             is the same as SCLADL_VMDABSSH.
164  A4  Signed       4  SCLADL_SRMRELDL     Cardinal count of total relative
                                             shares of all VMDBKs in the
                                             dispatch list.
168  A8  Unsigned     4  SCLADL_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.
172  AC  Unsigned     4  SCLADL_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 SCLADL_VMDMXSHA to determine
                                             if Max share is absolute or
                                             relative.
176  B0  Character    8  SCLADL_SRMATOD      Artificial TOD. This TOD only
                                             advances at the rate the system is
                                             running user work.
184  B8  Character    8  SCLADL_SRMATOD2     Artificial TOD2. This TOD only
                                             advances with each CPU's user time
                                             and each CPU's wait time.
192  C0  Unsigned     4  SCLADL_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 SCLADL_VMDCTPVR.
196  C4  Character    0  SCLADL_END          

MRSCLADL 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
SCLADL                  0    196
SCLADL_CALBASE         37           80
SCLADL_CALCPPST        84      4
SCLADL_CALFLAG1        37      1
SCLADL_CALOSTAT        88      1
SCLADL_CALQSTAT        40      1
SCLADL_CALSHARF        89      1
SCLADL_END             C4      0
SCLADL_MRHDR            0      0
SCLADL_SRMABSDL        A0      4
SCLADL_SRMATOD         B0      8
SCLADL_SRMATOD2        B8      8
SCLADL_SRMCDISP        24      2
SCLADL_SRMC1DSP        26      2
SCLADL_SRMC2DSP        28      2
SCLADL_SRMC3DSP        2A      2
SCLADL_SRMRELDL        A4      4
SCLADL_SRMTOTST        1C      4
SCLADL_SRMWSSDL        20      4
SCLADL_VMDABSSH        98      4
SCLADL_VMDAUTOL        88           02
SCLADL_VMDCPUAD        42      2
SCLADL_VMDCTCRT        A8      4
SCLADL_VMDCTORF        80      4
SCLADL_VMDCTPVG        C0      4
SCLADL_VMDCTPVR        48      4
SCLADL_VMDCTXBK        78      4
SCLADL_VMDDISC         88           04
SCLADL_VMDDPRTY        64      8
SCLADL_VMDELIST        41      1
SCLADL_VMDEPRTY        5C      8
SCLADL_VMDESLIC        8C      8
SCLADL_VMDFLREO        7C      4
SCLADL_VMDFORCE        88           10
SCLADL_VMDHOTRQ        40           80
SCLADL_VMDHOTST        40           40
SCLADL_VMDIABIA        40           10
SCLADL_VMDLIMTH        89           02
SCLADL_VMDLKSHT        40           04
SCLADL_VMDLOADU        40           20
SCLADL_VMDMXSHA        89           80
SCLADL_VMDMXSHR        AC      4
SCLADL_VMDNULL         40           01
SCLADL_VMDOPRTY        6C      8
SCLADL_VMDPGBIA        40           08
SCLADL_VMDPGRTE        3C      4
SCLADL_VMDRDYCM        36      0
SCLADL_VMDRELSH        94      4
SCLADL_VMDRPLIM        44      4
SCLADL_VMDRTHRU        74      4
SCLADL_VMDSLCNT        8A      2
SCLADL_VMDSVMID        2C      8
SCLADL_VMDSVMWF        34           80
SCLADL_VMDSVMWF        35           80
SCLADL_VMDSVMWF        36           80
SCLADL_VMDSVMWT        34      1
SCLADL_VMDSVMWT        35      1
SCLADL_VMDSVMWT        36      1
SCLADL_VMDSVMW2        35      0
SCLADL_VMDSYSOP        88           80
SCLADL_VMDTTIME        54      8
SCLADL_VMDUFORC        88           08
SCLADL_VMDUSER         14      8
SCLADL_VMDUSRCT        88           40
SCLADL_VMDVTIME        4C      8
SCLADL_VMDVUSCT        9C      4
SCLADL_VMDWSSPR        38      4
SCLADL_VMDXAUTO        88           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