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

#### MRSCLALL

Prolog
Control Block Contents
Cross Reference

#### MRSCLALL Prolog

####

####

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

    MRSCLALL Control Block Contents

    Offsets
    Dec Hex  Type       Len  Name (Dim)             Description

      0   0  Structure  220  SCLALL                 Start of monitor record
      0   0  Character    0  SCLALL_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  SCLALL_VMDUSER         Userid
     28  1C  Unsigned     2  SCLALL_VMDCPUAD        Virtual proc address
     30  1E  Bitstring    1  SCLALL_ALLFLAG         Flag byte
              1... ....      SCLALL_ALLBASE         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  SCLALL_VMDSCDF1        Scheduler flags
     33  21  Bitstring    1  SCLALL_VMDSCDF2        Scheduler flags byte 2
     34  22  Bitstring    1  SCLALL_VMDSCDF3        Scheduler flags byte 3
     35  23  Bitstring    1  SCLALL_VMDDLCTL        Dispatch list controls
     36  24  Bitstring    1  SCLALL_VMDDLCTX        Dispatch list ctls extension
     37  25  Bitstring    1  SCLALL_VMDSTATE        Scheduler/dispatcher state
     38  26  Bitstring    1  SCLALL_VMDRSTAT        Run blockage status
     39  27  Bitstring    1  SCLALL_VMDQSTAT        Scheduling status
     40  28  Bitstring    1  SCLALL_VMDELIST        Eligible list class
     41  29  Bitstring    1  SCLALL_VMDLMNDX        Eligible list class
     42  2A  Bitstring    1  *                      Reserved for IBM use
     43  2B  Bitstring    1  *                      Reserved for IBM use
     44  2C  Unsigned     4  SCLALL_VMDRELSH        VMDBK's relative share
     48  30  Unsigned     4  SCLALL_VMDABSSH        VMDBK's absolute share
     52  34  Unsigned     4  SCLALL_VMDMXSHR        Maximum share. Identified as
                                                    absolute or relative by
                                                    VMDSCDF3.VMDMXSHA
     56  38  Character    8  SCLALL_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 SCLALL_VMDVTIME
                                                    is the elapsed time in TOD
                                                    clock units.
     64  40  Character    8  SCLALL_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 SCLALL_VMDTTIME
                                                    is the elapsed time in TOD
                                                    clock units.
     72  48  Character    8  SCLALL_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  SCLALL_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  SCLALL_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  SCLALL_VMDOPRTY        This VMDBK's dispatch
                                                    priority before adjustment
                                                    factors such as interactive
                                                    bias and paging bias
    104  68  Unsigned     4  SCLALL_VMDRTHRU        This VMDBK's 'required
                                                    throughput' or 'resource
                                                    access' in the dispatch list
    108  6C  Unsigned     4  SCLALL_VMDEDFAC        This VMDBK's eligible list
                                                    delay factor
    112  70  Character    8  SCLALL_VMDESLIC        Elapsed time slice for d-list
    120  78  Signed       4  SCLALL_VMDCTCRT        Count of critical processes
                                                    this VMDBK is responsible for
    124  7C  Unsigned     2  SCLALL_VMDSLCNT        Count of minor time slices
                                                    completed so far during this
                                                    transaction
    126  7E  Bitstring    1  SCLALL_VMDCFGEM        Virt configuration indicators
    127  7F  Bitstring    1  SCLALL_VMDPUST         CPU status flags
    128  80  Character    8  SCLALL_VMDTTMP         Total virtual and simulation
                                                    time while running on a primary
    136  88  Character    8  SCLALL_VMDVTMP         Total virtual time while
                                                    running on a primary
    144  90  Character    8  SCLALL_VMDTTMS         Total virtual and simulation
                                                    time while running on a
                                                    secondary
    152  98  Character    8  SCLALL_VMDVTMS         Total virtual time while
                                                    running on a secondary
    160  A0  Character    8  *                      Reserved for IBM use
    168  A8  Unsigned     4  SCLALL_SRMCONLL        Count of VMDBKs on all limit
                                                    lists
    172  AC  Unsigned     4  *                      Reserved for IBM use
    176  B0  Character    8  SCLALL_SRXATOD         Artificial TOD clock value
    184  B8  Character    8  SCLALL_SRXATOD2        Second ATOD -- used to decide
                                                    when a VMDBK should come off of
                                                    the limit list
    192  C0  Unsigned     4  SCLALL_SRXCONLL        Count of VMDBKs on the limit
                                                    list of this VMDBK's CPU type
    196  C4  Character    8  SCLALL_SRXTOTLS        Share totals
    196  C4  Character    4  SCLALL_SRXRELDL        The sum of the relative
                                                    shares of all RELATIVE share
                                                    holders (excluding dedicated
                                                    VMDBKs) currently in the
                                                    dispatch list.
    200  C8  Character    4  SCLALL_SRXABSDL        The sum of the absolute
                                                    shares of all VMDBKs (excluding
                                                    dedicated VMDBKs) currently in
                                                    the dispatch list.
    204  CC  Character    8  SCLALL_SRXRTHRU        Sums of the VMDRTHRU values
                                                    for all the VMDBKs in the
                                                    dispatch list
    204  CC  Character    4  SCLALL_SRXRTHRN        Total VMDRTHRU of VMDBKs in
                                                    the dispatch list which are not
                                                    currently hitting their
                                                    max-SHAREs
    208  D0  Character    4  SCLALL_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  SCLALL_SRXCTHRU        Sums of the VMDRTHRU values
                                                    for all the compute-bound
                                                    VMDBKs in the dispatch list
    212  D4  Character    4  SCLALL_SRXCTHRN        Total VMDRTHRU of all the
                                                    compute-bound VMDBKs not
                                                    hitting max-SHARE
    216  D8  Character    4  SCLALL_SRXCTHRL        Total VMDRTHRU of all the
                                                    compute-bound VMDBKs hitting
                                                    max-SHARE
    220  DC  Character    0  SCLALL_END

    MRSCLALL 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
    SCLALL                     0    220
    SCLALL_ALLBASE            1E           80
    SCLALL_ALLFLAG            1E      1
    SCLALL_CALMRHDR            0      0
    SCLALL_END                DC      0
    SCLALL_SRMCONLL           A8      4
    SCLALL_SRXABSDL           C8      4
    SCLALL_SRXATOD            B0      8
    SCLALL_SRXATOD2           B8      8
    SCLALL_SRXCONLL           C0      4
    SCLALL_SRXCTHRL           D8      4
    SCLALL_SRXCTHRN           D4      4
    SCLALL_SRXCTHRU           D4      8
    SCLALL_SRXRELDL           C4      4
    SCLALL_SRXRTHRL           D0      4
    SCLALL_SRXRTHRN           CC      4
    SCLALL_SRXRTHRU           CC      8
    SCLALL_SRXTOTLS           C4      8
    SCLALL_VMDABSSH           30      4
    SCLALL_VMDCFGEM           7E      1
    SCLALL_VMDCPUAD           1C      2
    SCLALL_VMDCTCRT           78      4
    SCLALL_VMDDLCTL           23      1
    SCLALL_VMDDLCTX           24      1
    SCLALL_VMDDPRTY           50      8
    SCLALL_VMDEDFAC           6C      4
    SCLALL_VMDELIST           28      1
    SCLALL_VMDEPRTY           48      8
    SCLALL_VMDESLIC           70      8
    SCLALL_VMDLMNDX           29      1
    SCLALL_VMDLPRTY           58      8
    SCLALL_VMDMXSHR           34      4
    SCLALL_VMDOPRTY           60      8
    SCLALL_VMDPUST            7F      1
    SCLALL_VMDQSTAT           27      1
    SCLALL_VMDRELSH           2C      4
    SCLALL_VMDRSTAT           26      1
    SCLALL_VMDRTHRU           68      4
    SCLALL_VMDSCDF1           20      1
    SCLALL_VMDSCDF2           21      1
    SCLALL_VMDSCDF3           22      1
    SCLALL_VMDSLCNT           7C      2
    SCLALL_VMDSTATE           25      1
    SCLALL_VMDTTIME           40      8
    SCLALL_VMDTTMP            80      8
    SCLALL_VMDTTMS            90      8
    SCLALL_VMDUSER            14      8
    SCLALL_VMDVTIME           38      8
    SCLALL_VMDVTMP            88      8
    SCLALL_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