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 Event 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.
     NOTES:
          - To give a fuller picture of time consumed, three
            sets of used processor time are reported in this
            monitor record.  When multithreading is enabled on
            the system, all three are also reported in the Type
            1 and F accounting records. Timer field names
            ending with _MT1 are MT-1 Equivalent times. Timer
            field names ending with _PRO are Prorated Core
            Times.  Timer field names without an _MT1 or _PRO
            suffix contain Raw Time values.
          - Raw Time is tracked for ALL users for their entire
            session.  Raw Time is the CPU time each virtual CPU
            spent dispatched on a thread and is the CPU Timer
            information provided directly by the hardware.
          - MT-1 Equivalent Time is tracked for ALL users for
            their entire session. This calculated CPU time
            approximates the time that would have been spent
            if the workload had been run with multithreading
            disabled, that is, with all core resources available
            to one thread.  When a user is running on a system
            where multithreading is not installed or not
            enabled, MT-1 Equivalent Time consumed will be
            identical to Raw Time.  However, if a guest has
            relocated from an MT-enabled system to an
            MT-disabled system, the cumulative raw and MT-1
            Equivalent times reported in monitor records may
            differ due to the prior execution in the MT
            environment.
          - Prorated Core Time charges for core utilization in
            a way suitable to core-based software licensing.
            Time is charged by dividing the time the core was
            dispatched evenly among the threads dispatched in
            that interval. Since Prorated Core Time is not
            always calculated, additional information
            is reported regarding the Prorated Core Time values:
            * The _VMAPRCAL bit indicates whether the Prorated
              Core Time values in this record are valid.
            When the user is relocated to any other system
            (even a Multithreading aware/enabled system),
            Prorated Core Time is reset. This means:
            * the _VMAPRCAL bit is set based on whether the
              source system will be calculating prorated core
              time or not.
            * all _VMAxxxxx_PRO fields are reset to PFXTMMAX.

#### MRSCLALL Control Block Contents

    Offsets
    Dec  Hex  Type        Len  Name (Dim)             Description

       0   0  Structure   332  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
       2   2  Unsigned      2  MRHDRZER
       4   4  Unsigned      1  MRHDRDM
       5   5  Unsigned      1  *
       6   6  Unsigned      2  MRHDRRC
       8   8  Character     8  MRHDRTOD
      16  10  Character     4  *
      20  14  Character     0  MRHDR_END
      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        Index to the element in the
                                                      required throughput table.
      42  2A  Bitstring     1  *                      Reserved for IBM use
      43  2B  Unsigned      1  SCLALL_LIMITHIT        Reason why user is being
                                                      added to the limit list.
                                                      Valid values: X'00' -
                                                      Individual limit hit X'01' -
                                                      CPU pool limit hit
      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 Raw Time that this
                                                      user 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 accumulated time in
                                                      TOD clock units.
      64  40  Character     8  SCLALL_VMDTTIME        Total Raw 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 raw virtual and
                                                      simulation time for the user
                                                      on primary processor.
     136  88  Character     8  SCLALL_VMDVTMP         Total raw virtual time for
                                                      the user on primary
                                                      processor.
     144  90  Character     8  SCLALL_VMDTTMS         Total raw virtual and
                                                      simulation time for the user
                                                      on secondary processor.
     152  98  Character     8  SCLALL_VMDVTMS         Total raw virtual time for
                                                      the user on secondary
                                                      processor.
     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  *                      Reserved for IBM use.
                                                      Formerly SCLALL_SRXCTHRU,
                                                      SCLALL_SRXCTHRN, and
                                                      SCLALL_SRXCTHRL.
     220  DC  Character     8  SCLALL_LIMPOOL         CPU pool name that the user
                                                      is assigned to.
     228  E4  Character     8  SCLALL_VMDTTIME_MT1    Total MT-1 Equivalent 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.
     236  EC  Character     8  SCLALL_VMDVTIME_MT1    Total MT-1 Equivalent time
                                                      that this user was running
                                                      and 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.
     244  F4  Character     8  SCLALL_VMDVTMP_MT1     MT-1 Equivalent virtual
                                                      time for the user on primary
                                                      processor
     252  FC  Character     8  SCLALL_VMDTTMP_MT1     MT-1 Equivalent total
                                                      virtual and simulation time
                                                      for the user on primary
                                                      processor.
     260 104  Character     8  SCLALL_VMDVTMS_MT1     MT-1 Equivalent total
                                                      virtual time for the user on
                                                      secondary processor.
     268 10C  Character     8  SCLALL_VMDTTMS_MT1     MT-1 Equivalent total
                                                      virtual and simulation time
                                                      for the user on secondary
                                                      processor.
     276 114  Character     8  SCLALL_VMATTIME_PRO    Total Prorated Core 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.
                                                      See the notes above.
     284 11C  Character     8  SCLALL_VMAVTIME_PRO    Total Prorated Core Time
                                                      that this user was running
                                                      and 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. See the
                                                      notes above.
     292 124  Character     8  SCLALL_VMAVTMP_PRO     Total Prorated Core virtual
                                                      time for user on primary
                                                      processor. See the notes
                                                      above.
     300 12C  Character     8  SCLALL_VMATTMP_PRO     Total Prorated Core virtual
                                                      and simulation time for the
                                                      user on primary processor.
                                                      See the notes above.
     308 134  Character     8  SCLALL_VMAVTMS_PRO     Total Prorated Core virtual
                                                      time for user on secondary
                                                      processor. See the notes
                                                      above.
     316 13C  Character     8  SCLALL_VMATTMS_PRO     Total Prorated Core virtual
                                                      and simulation time for the
                                                      user on secondary processor.
                                                      See the notes above.
     324 144  Unsigned      4  *                      Reserved for IBM use
     328 148  Bitstring     1  SCLALL_PROBITS         Prorated Core Time bits
                                                      needed to understand those
                                                      fields.
              1... ....        SCLALL_VMAPRCAL         Indicates whether the
                                                      Prorated Core Time values in
                                                      this record are valid (only
                                                      use if valid): 0 = values not
                                                      valid 1 = values are valid
              .1.. ....        SCLALL_INDLMPRO         Indicates basis for
                                                      individual limiting: 0 = raw
                                                      CPU time 1 = prorated core
                                                      time
              ..1. ....        *
              ...1 ....        *
              .... 1...        *
              .... .1..        *
              .... ..1.        *
              .... ...1        *
     329 149  Bitstring     1  *                      Reserved for IBM use
     330 14A  Unsigned      2  *                      Reserved for IBM use
     332 14C  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    332
    SCLALL_ALLBASE            1E           80
    SCLALL_ALLFLAG            1E      1
    SCLALL_CALMRHDR            0      0
    SCLALL_END               14C      0
    SCLALL_INDLMPRO          148           40
    SCLALL_LIMITHIT           2B      1
    SCLALL_LIMPOOL            DC      8
    SCLALL_PROBITS           148      1
    SCLALL_SRMCONLL           A8      4
    SCLALL_SRXABSDL           C8      4
    SCLALL_SRXATOD            B0      8
    SCLALL_SRXATOD2           B8      8
    SCLALL_SRXCONLL           C0      4
    SCLALL_SRXRELDL           C4      4
    SCLALL_SRXRTHRL           D0      4
    SCLALL_SRXRTHRN           CC      4
    SCLALL_SRXRTHRU           CC      8
    SCLALL_SRXTOTLS           C4      8
    SCLALL_VMAPRCAL          148           80
    SCLALL_VMATTIME_PRO      114      8
    SCLALL_VMATTMP_PRO       12C      8
    SCLALL_VMATTMS_PRO       13C      8
    SCLALL_VMAVTIME_PRO      11C      8
    SCLALL_VMAVTMP_PRO       124      8
    SCLALL_VMAVTMS_PRO       134      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_VMDTTIME_MT1       E4      8
    SCLALL_VMDTTMP            80      8
    SCLALL_VMDTTMP_MT1        FC      8
    SCLALL_VMDTTMS            90      8
    SCLALL_VMDTTMS_MT1       10C      8
    SCLALL_VMDUSER            14      8
    SCLALL_VMDVTIME           38      8
    SCLALL_VMDVTIME_MT1       EC      8
    SCLALL_VMDVTMP            88      8
    SCLALL_VMDVTMP_MT1        F4      8
    SCLALL_VMDVTMS            98      8
    SCLALL_VMDVTMS_MT1       104      8

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

    Last updated on 08 August 2020 at 16:09:58.

    Copyright IBM Corporation, 1990, 2020