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

#### MRSCLDLL

Prolog
Control Block Contents
Cross Reference

#### MRSCLDLL Prolog

####

####

     DSECT NAME - SCLDLL
     FUNCTION - Map a Monitor record.
     LOCATED BY -
            Through the Monitor Control Area
     REFERENCED CONTROL BLOCKS -
            MRRECHDR    Monitor Record Header
     NAME - MRSCLDLL
     DESCRIPTIVE NAME - Monitor Sample Record
            Domain 2  - Scheduler domain
            Record 14 - Drop VMDBK from the limit list
     DESCRIPTION - Indicates conditions after user has been dropped from
                   the limit list.  A separate record is generated for
                   each VMDBK in the virtual machine MP complex.

    MRSCLDLL Control Block Contents

    Offsets
    Dec Hex  Type       Len  Name (Dim)             Description

      0   0  Structure  220  SCLDLL                 Start of monitor record
      0   0  Character    0  SCLDLL_CALMRHDR        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  SCLDLL_VMDUSER         Userid
     28  1C  Unsigned     2  SCLDLL_VMDCPUAD        Virtual proc address
     30  1E  Bitstring    1  SCLDLL_DLLFLAG         Flag byte
              1... ....      SCLDLL_DLLBASE         If on, this is base VMDBK
              .1.. ....      *
              ..1. ....      *
              ...1 ....      *
              .... 1...      *
              .... .1..      *
              .... ..1.      *
              .... ...1      *
     31  1F  Bitstring    1  *                      Reserved for IBM use
     32  20  Bitstring    1  SCLDLL_VMDSCDF1        Scheduler flags
     33  21  Bitstring    1  SCLDLL_VMDSCDF2        Scheduler flags byte 2
     34  22  Bitstring    1  SCLDLL_VMDSCDF3        Scheduler flags byte 3
     35  23  Bitstring    1  SCLDLL_VMDDLCTL        Dispatch list controls
     36  24  Bitstring    1  SCLDLL_VMDDLCTX        Dispatch list ctls extension
     37  25  Bitstring    1  SCLDLL_VMDSTATE        Scheduler/dispatcher state
     38  26  Bitstring    1  SCLDLL_VMDRSTAT        Run blockage status
     39  27  Bitstring    1  SCLDLL_VMDQSTAT        Scheduling status
     40  28  Bitstring    1  SCLDLL_VMDELIST        Eligible list class
     41  29  Bitstring    1  SCLDLL_VMDLMNDX        Eligible list class
     42  2A  Bitstring    1  *                      Reserved for IBM use
     43  2B  Bitstring    1  *                      Reserved for IBM use
     44  2C  Unsigned     4  SCLDLL_VMDRELSH        VMDBK's relative share
     48  30  Unsigned     4  SCLDLL_VMDABSSH        VMDBK's absolute share
     52  34  Unsigned     4  SCLDLL_VMDMXSHR        Maximum share. Identified as
                                                    absolute or relative by
                                                    VMDSCDF3.VMDMXSHA
     56  38  Character    8  SCLDLL_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 SCLDLL_VMDVTIME
                                                    is the elapsed time in TOD
                                                    clock units.
     64  40  Character    8  SCLDLL_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 SCLDLL_VMDTTIME
                                                    is the elapsed time in TOD
                                                    clock units.
     72  48  Character    8  SCLDLL_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.
     80  50  Character    8  SCLDLL_VMDDPRTY        The VMDBK'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.
     88  58  Character    8  SCLDLL_VMDLPRTY        This VMDBK's limit list
                                                    priority. It is used to decide
                                                    when to take the VMDBK off the
                                                    limit list
     96  60  Character    8  SCLDLL_VMDOPRTY        This VMDBK's dispatch
                                                    priority before adjustment
                                                    factors such as interactive
                                                    bias and paging bias
    104  68  Unsigned     4  SCLDLL_VMDRTHRU        This VMDBK's 'required
                                                    throughput' or 'resource
                                                    access' in the dispatch list
    108  6C  Unsigned     4  SCLDLL_VMDEDFAC        This VMDBK's eligible list
                                                    delay factor
    112  70  Character    8  SCLDLL_VMDESLIC        Elapsed time slice for d-list
    120  78  Signed       4  SCLDLL_VMDCTCRT        Count of critical processes
                                                    this VMDBK is responsible for
    124  7C  Unsigned     2  SCLDLL_VMDSLCNT        Count of minor time slices
                                                    completed so far during this
                                                    transaction
    126  7E  Bitstring    1  SCLDLL_VMDCFGEM        Virt configuration indicators
    127  7F  Bitstring    1  SCLDLL_VMDPUST         CPU status flags
    128  80  Character    8  SCLDLL_VMDTTMP         Total virtual and simulation
                                                    time while running on a primary
    136  88  Character    8  SCLDLL_VMDVTMP         Total virtual time while
                                                    running on a primary
    144  90  Character    8  SCLDLL_VMDTTMS         Total virtual and simulation
                                                    time while running on a
                                                    secondary
    152  98  Character    8  SCLDLL_VMDVTMS         Total virtual time while
                                                    running on a secondary
    160  A0  Character    8  *                      Reserved for IBM use
    168  A8  Unsigned     4  SCLDLL_SRMCONLL        Count of VMDBKs on all limit
                                                    lists
    172  AC  Unsigned     4  *                      Reserved for IBM use
    176  B0  Character    8  SCLDLL_SRXATOD         Artificial TOD clock value
    184  B8  Character    8  SCLDLL_SRXATOD2        Second ATOD -- used to decide
                                                    when a VMDBK should come off of
                                                    the limit list
    192  C0  Unsigned     4  SCLDLL_SRXCONLL        Count of VMDBKs on the limit
                                                    list of this VMDBK's CPU type
    196  C4  Character    8  SCLDLL_SRXTOTLS        Share totals
    196  C4  Character    4  SCLDLL_SRXRELDL        The sum of the relative
                                                    shares of all RELATIVE share
                                                    holders (excluding dedicated
                                                    VMDBKs) currently in the
                                                    dispatch list.
    200  C8  Character    4  SCLDLL_SRXABSDL        The sum of the absolute
                                                    shares of all VMDBKs (excluding
                                                    dedicated VMDBKs) currently in
                                                    the dispatch list.
    204  CC  Character    8  SCLDLL_SRXRTHRU        Sums of the VMDRTHRU values
                                                    for all the VMDBKs in the
                                                    dispatch list
    204  CC  Character    4  SCLDLL_SRXRTHRN        Total VMDRTHRU of VMDBKs in
                                                    the dispatch list which are not
                                                    currently hitting their
                                                    max-SHAREs
    208  D0  Character    4  SCLDLL_SRXRTHRL        Total VMDRTHRU of VMDBKs in
                                                    the dispatch list which are
                                                    currently hitting their
                                                    max-SHAREs (LIMITed and hitting
                                                    the limit)
    212  D4  Character    8  SCLDLL_SRXCTHRU        Sums of the VMDRTHRU values
                                                    for all the compute-bound
                                                    VMDBKs in the dispatch list
    212  D4  Character    4  SCLDLL_SRXCTHRN        Total VMDRTHRU of all the
                                                    compute-bound VMDBKs not
                                                    hitting max-SHARE
    216  D8  Character    4  SCLDLL_SRXCTHRL        Total VMDRTHRU of all the
                                                    compute-bound VMDBKs hitting
                                                    max-SHARE
    220  DC  Character    0  SCLDLL_END

    MRSCLDLL 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
    SCLDLL                     0    220
    SCLDLL_CALMRHDR            0      0
    SCLDLL_DLLBASE            1E           80
    SCLDLL_DLLFLAG            1E      1
    SCLDLL_END                DC      0
    SCLDLL_SRMCONLL           A8      4
    SCLDLL_SRXABSDL           C8      4
    SCLDLL_SRXATOD            B0      8
    SCLDLL_SRXATOD2           B8      8
    SCLDLL_SRXCONLL           C0      4
    SCLDLL_SRXCTHRL           D8      4
    SCLDLL_SRXCTHRN           D4      4
    SCLDLL_SRXCTHRU           D4      8
    SCLDLL_SRXRELDL           C4      4
    SCLDLL_SRXRTHRL           D0      4
    SCLDLL_SRXRTHRN           CC      4
    SCLDLL_SRXRTHRU           CC      8
    SCLDLL_SRXTOTLS           C4      8
    SCLDLL_VMDABSSH           30      4
    SCLDLL_VMDCFGEM           7E      1
    SCLDLL_VMDCPUAD           1C      2
    SCLDLL_VMDCTCRT           78      4
    SCLDLL_VMDDLCTL           23      1
    SCLDLL_VMDDLCTX           24      1
    SCLDLL_VMDDPRTY           50      8
    SCLDLL_VMDEDFAC           6C      4
    SCLDLL_VMDELIST           28      1
    SCLDLL_VMDEPRTY           48      8
    SCLDLL_VMDESLIC           70      8
    SCLDLL_VMDLMNDX           29      1
    SCLDLL_VMDLPRTY           58      8
    SCLDLL_VMDMXSHR           34      4
    SCLDLL_VMDOPRTY           60      8
    SCLDLL_VMDPUST            7F      1
    SCLDLL_VMDQSTAT           27      1
    SCLDLL_VMDRELSH           2C      4
    SCLDLL_VMDRSTAT           26      1
    SCLDLL_VMDRTHRU           68      4
    SCLDLL_VMDSCDF1           20      1
    SCLDLL_VMDSCDF2           21      1
    SCLDLL_VMDSCDF3           22      1
    SCLDLL_VMDSLCNT           7C      2
    SCLDLL_VMDSTATE           25      1
    SCLDLL_VMDTTIME           40      8
    SCLDLL_VMDTTMP            80      8
    SCLDLL_VMDTTMS            90      8
    SCLDLL_VMDUSER            14      8
    SCLDLL_VMDVTIME           38      8
    SCLDLL_VMDVTMP            88      8
    SCLDLL_VMDVTMS            98      8

    This information is
    based on z/VM V6R1.0.

    Last updated on 8 Oct 2009 at 21:08:13.

    Copyright IBM Corporation, 1990, 2009