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

    Last updated on 11 Dec 2005 at 18:48:12.

    Copyright IBM Corporation, 1990, 2005