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 V4R3.0.

    Last updated on 1 May 2002 at 16:20:33.

    Copyright IBM Corporation, 1990, 2002