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 Event 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.
 NOTE:
      - 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.

MRSCLDLL Control Block Contents

Offsets
Dec  Hex  Type        Len  Name (Dim)             Description
 
   0   0  Structure   356  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
   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  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        Index to the element in the
                                                  required throughput table.
  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 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 SCLDLL_VMDVTIME
                                                  is the accumulated time in
                                                  TOD clock units.
  64  40  Character     8  SCLDLL_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
                                                  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 raw virtual and
                                                  simulation time for the user
                                                  on primary processor.
 136  88  Character     8  SCLDLL_VMDVTMP         Total raw virtual time for
                                                  the user on primary
                                                  processor.
 144  90  Character     8  SCLDLL_VMDTTMS         Total raw virtual and
                                                  simulation time for the user
                                                  on secondary processor.
 152  98  Character     8  SCLDLL_VMDVTMS         Total raw virtual time for
                                                  the user on secondary
                                                  processor.
 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  *                      Reserved for IBM use.
                                                  Formerly SCLDLL_SRXCTHRU,
                                                  SCLDLL_SRXCTHRN, and
                                                  SCLDLL_SRXCTHRL.
 220  DC  Character     8  SCLDLL_LIMPOOL         CPU pool name that the user
                                                  is assigned to.
 228  E4  Character     8  SCLDLL_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  SCLDLL_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  SCLDLL_VMDVTMP_MT1     MT-1 Equivalent virtual
                                                  time for the user on primary
                                                  processor
 252  FC  Character     8  SCLDLL_VMDTTMP_MT1     MT-1 Equivalent total
                                                  virtual and simulation time
                                                  for the user on primary
                                                  processor.
 260 104  Character     8  SCLDLL_VMDVTMS_MT1     MT-1 Equivalent total
                                                  virtual time for the user on
                                                  secondary processor.
 268 10C  Character     8  SCLDLL_VMDTTMS_MT1     MT-1 Equivalent total
                                                  virtual and simulation time
                                                  for the user on secondary
                                                  processor.
 276 114  Character     8  SCLDLL_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  SCLDLL_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  SCLDLL_VMAVTMP_PRO     Total Prorated Core virtual
                                                  time for user on primary
                                                  processor. See the notes
                                                  above.
 300 12C  Character     8  SCLDLL_VMATTMP_PRO     Total Prorated Core virtual
                                                  and simulation time for the
                                                  user on primary processor.
                                                  See the notes above.
 308 134  Character     8  SCLDLL_VMAVTMS_PRO     Total Prorated Core virtual
                                                  time for user on secondary
                                                  processor. See the notes
                                                  above.
 316 13C  Character     8  SCLDLL_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  SCLDLL_PROBITS         Prorated Core Time bits
                                                  needed to understand those
                                                  fields.
          1... ....        SCLDLL_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.. ....        SCLDLL_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  Signed        4  SCLDLL_SRXRELLG        Sum of relative shares for
                                                  all logged on VMDBKs,
                                                  excluding dedicated VMDBKs.
 336 150  Signed        4  SCLDLL_SRXABSLG        Sum of absolute shares for
                                                  all logged on VMDBKs,
                                                  excluding dedicated VMDBKs.
 340 154  Character     8  SCLDLL_VMDTODLM        Limit-list expiration TOD.
                                                  If MT is enabled, this field
                                                  is calculated from prorated
                                                  core time; Otherwise, this
                                                  field is calculated from raw
                                                  CPU time.
 348 15C  Character     8  SCLDLL_VMDTODIL        TOD Individual Limit
                                                  expires. Since VMDTODLM is
                                                  used for the limit list
                                                  expiration time which may not
                                                  be the individual limit,
                                                  VMDTODIL remembers the
                                                  individual limit (if any)
                                                  while LIMTODLM remembers the
                                                  group limit.
 356 164  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    356
SCLDLL_CALMRHDR            0      0
SCLDLL_DLLBASE            1E           80
SCLDLL_DLLFLAG            1E      1
SCLDLL_END               164      0
SCLDLL_INDLMPRO          148           40
SCLDLL_LIMPOOL            DC      8
SCLDLL_PROBITS           148      1
SCLDLL_SRMCONLL           A8      4
SCLDLL_SRXABSDL           C8      4
SCLDLL_SRXABSLG          150      4
SCLDLL_SRXATOD            B0      8
SCLDLL_SRXATOD2           B8      8
SCLDLL_SRXCONLL           C0      4
SCLDLL_SRXRELDL           C4      4
SCLDLL_SRXRELLG          14C      4
SCLDLL_SRXRTHRL           D0      4
SCLDLL_SRXRTHRN           CC      4
SCLDLL_SRXRTHRU           CC      8
SCLDLL_SRXTOTLS           C4      8
SCLDLL_VMAPRCAL          148           80
SCLDLL_VMATTIME_PRO      114      8
SCLDLL_VMATTMP_PRO       12C      8
SCLDLL_VMATTMS_PRO       13C      8
SCLDLL_VMAVTIME_PRO      11C      8
SCLDLL_VMAVTMP_PRO       124      8
SCLDLL_VMAVTMS_PRO       134      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_VMDTODIL          15C      8
SCLDLL_VMDTODLM          154      8
SCLDLL_VMDTTIME           40      8
SCLDLL_VMDTTIME_MT1       E4      8
SCLDLL_VMDTTMP            80      8
SCLDLL_VMDTTMP_MT1        FC      8
SCLDLL_VMDTTMS            90      8
SCLDLL_VMDTTMS_MT1       10C      8
SCLDLL_VMDUSER            14      8
SCLDLL_VMDVTIME           38      8
SCLDLL_VMDVTIME_MT1       EC      8
SCLDLL_VMDVTMP            88      8
SCLDLL_VMDVTMP_MT1        F4      8
SCLDLL_VMDVTMS            98      8
SCLDLL_VMDVTMS_MT1       104      8

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

Last updated on 13 September 2022 at 12:47:05.
Copyright IBM Corporation, 1990, 2022