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

#### MRSCLDDL

Prolog
Control Block Contents
Storage Layout
Cross Reference

#### MRSCLDDL Prolog

####

####

     DSECT NAME - SCLDDL
     FUNCTION - Map a Monitor record.
     LOCATED BY -
            Through the Monitor Control Area
     REFERENCED CONTROL BLOCKS -
            MRRECHDR    Monitor Record Header
     NAME - MRSCLDDL
     DESCRIPTIVE NAME - Monitor Event Record
                        Domain 2 - Scheduler Domain
                        Record 5 - Drop User From Dispatch List
     DESCRIPTION - Indicates conditions after this user has been
                   dropped from the dispatch list.  A separate
                   record is generated for each VMDBK in the
                   virtual MP complex.

    MRSCLDDL Control Block Contents

    Offsets
    Dec Hex  Type       Len  Name (Dim)          Description

      0   0  Structure  160  SCLDDL              Start of monitor record
      0   0  Character    0  SCLDDL_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  SCLDDL_VMDUSER      Userid
     28  1C  Character    8  SCLDDL_VMDSVMID     VMDBK name for the last
                                                 successful IUCV, VMCF or APPC/VM
                                                 Send for this virtual machine.
                                                 Valid in base VMDBK only.
     36  24  Bitstring    1  SCLDDL_VMDSVMWT     Service-virtual-machine (SVM)
                                                 wait flag - valid in base VMDBK
                                                 only.
              1... ....      SCLDDL_VMDSVMWF     VMDBK is waiting for a response
                                                 from IUCV, VMCF, or APPC.
              .1.. ....      *
              ..1. ....      *
              ...1 ....      *
              .... 1...      *
              .... .1..      *
              .... ..1.      *
              .... ...1      *
     37  25  Character    0  SCLDDL_VMDSVMW2     back-up byte to the VMDSVMWT
                                                 byte. Copied here so that they
                                                 will persist longer than they
                                                 would in VMDSVMWT. Valid in base
                                                 VMDBK only.
     37  25  Bitstring    1  SCLDDL_VMDSVMWT     Service-virtual-machine (SVM)
                                                 wait flag - valid in base VMDBK
                                                 only.
              1... ....      SCLDDL_VMDSVMWF     VMDBK is waiting for a response
                                                 from IUCV, VMCF, or APPC.
     38  26  Character    0  SCLDDL_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.
     38  26  Bitstring    1  SCLDDL_VMDSVMWT     Service-virtual-machine (SVM)
                                                 wait flag - valid in base VMDBK
                                                 only.
              1... ....      SCLDDL_VMDSVMWF     VMDBK is waiting for a response
                                                 from IUCV, VMCF, or APPC.
     39  27  Bitstring    1  SCLDDL_CALFLAG1     Flag Byte 1
              1... ....      SCLDDL_VMDLRGST     User was preemptied due to its
                                                 large storage requirement
              .1.. ....      SCLDDL_CALBASE      If on, this is the base VMDBK.
                                                 VMDBASE
              ..1. ....      *
              ...1 ....      *
              .... 1...      *
              .... .1..      *
              .... ..1.      *
              .... ...1      *
     40  28  Unsigned     4  SCLDDL_VMDWSSPR     This user's projected working
                                                 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.
     44  2C  Unsigned     4  SCLDDL_VMDPGRTE     Number of pages per second which
                                                 this user read in during its last
                                                 stay in the dispatch list.
     48  30  Unsigned     4  SCLDDL_VMDRPLIM     Resident page growth limit
     52  34  Unsigned     4  SCLDDL_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 SCLDDL_VMDCTPVG from
                                                 SCLDDL_VMDCTPVR.
     56  38  Character    8  SCLDDL_VMDVTIME     The total 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
                                                 SCLDDL_VMDVTIME is the elapsed
                                                 time in TOD clock units.
     64  40  Character    8  SCLDDL_VMDTTIME     The 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
                                                 SCLDDL_VMDTTIME is the elapsed
                                                 time in TOD clock units.
     72  48  Character    8  SCLDDL_VMDDPRTY     The user's dispatch list
                                                 priority. This is based on 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.
     80  50  Character    8  SCLDDL_VMDOPRTY     The user's dispatch priority
                                                 before adjustment for factors such
                                                 as interactive bias and paging
                                                 bias
     88  58  Unsigned     4  SCLDDL_VMDRTHRU     This user's 'required
                                                 throughput' or 'resource access'
                                                 in the dispatch list. This is the
                                                 amount of time while the user is
                                                 in the dispatch list that it
                                                 should be offered access to system
                                                 resources, considering its SHARE
                                                 and the time it spent in the
                                                 eligible list.
     92  5C  Unsigned     4  SCLDDL_VMDCTXBK     Number of Expanded Storage
                                                 blocks allocated to a virtual
                                                 machine by CP for paging
     96  60  Unsigned     4  SCLDDL_VMDFLREO     Number of frame list reorders
                                                 for this virtual system's list of
                                                 frames
    100  64  Unsigned     4  SCLDDL_VMDCTORF     Total number of referenced
                                                 frames resident when reset was
                                                 done for this virtual system or
                                                 shared frame list resident frames.
    104  68  Unsigned     4  SCLDDL_CALCPPST     Cumulative count of pages stolen
                                                 from this user's address spaces
                                                 while they were private.
    108  6C  Bitstring    1  SCLDDL_CALRSTAT     Reason(s) the dispatched VMDBK
                                                 is not being run
              1... ....      *
              .1.. ....      SCLDDL_VMDCFWT      VMDBK is in console function
                                                 wait. Either a console function is
                                                 active, or the virtual machine is
                                                 waiting for the remaining VMDBKs
                                                 in the configuration to enter
                                                 console function mode.
              ..1. ....      SCLDDL_VMDSIMWT     CP is simulating some hardware
                                                 function for the guest such as
                                                 instructions, interrupts, and
                                                 timer updates. Virtual machine is
                                                 prevented from running to avoid
                                                 potential conflicts with the
                                                 simulations.
              ...1 ....      SCLDDL_VMDIOWT      Instruction waiting for I/O
                                                 status for completion. (May be
                                                 cancelled without loss of system
                                                 integrity.)
              .... 1...      *
              .... .1..      *
              .... ..1.      *
              .... ...1      *
    109  6D  Bitstring    1  SCLDDL_VMDSTATE     Scheduler/Dispatcher State.
                                                 X'63' = Review-suspended. VMDBK is
                                                 in transition to the suspended
                                                 state. X'58' = Review-idle. VMDBK
                                                 is in transition to the idle
                                                 state. X'4D' = VMDBK has been
                                                 selected by dispatcher for
                                                 processing. X'42' = VMDBK is ready
                                                 for selection by dispatcher once
                                                 it goes to the dispatch list.
                                                 X'37' = Test-idle. VMDBK is ready
                                                 for selection by the dispatcher
                                                 but should be dropped from the
                                                 dispatch list when selected the
                                                 next time. X'08' = VMDBK is
                                                 suspended, probably waiting for a
                                                 short-term event to occur. X'00' =
                                                 VMDBK is idle. No work is
                                                 available.
    110  6E  Bitstring    1  SCLDDL_CALOSTAT     Virtual machine operating status
              1... ....      SCLDDL_VMDSYSOP     User is primary system operator
              .1.. ....      SCLDDL_VMDUSRCT     User is counted as being logged
                                                 on
              ..1. ....      *
              ...1 ....      SCLDDL_VMDFORCE     User is to be logged off. This
                                                 may be requested by CP, a forced
                                                 logoff, or user's logoff command.
              .... 1...      SCLDDL_VMDUFORC     User is forced to logoff the
                                                 system
              .... .1..      SCLDDL_VMDDISC      User is running disconnected
              .... ..1.      SCLDDL_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      SCLDDL_VMDXAUTO     The original command was
                                                 XAUTOLOG. Valid for the base VMDBK
                                                 only.
    111  6F  Bitstring    1  SCLDDL_VMDSACTL     Dispatch list control bits.
                                                 These are used to signal the
                                                 dispatcher that the currently
                                                 dispatched user requires scheduler
                                                 intervention, either due to having
                                                 reached a resource consumption
                                                 limit or some other reason. At
                                                 dispatch list drop time, these
                                                 bits can indicate why the user was
                                                 dropped.
    112  70  Unsigned     4  SCLDDL_VMDCWSS      This user's core working set
                                                 size.
    116  74  Unsigned     1  SCLDDL_VMDSACTX     An extension byte to VMDSACTL.
                                                 It describes additional reasons
                                                 why the user required scheduler
                                                 intervention, given that the
                                                 'other resources' bit is on in
                                                 VMDSACTL.
    117  75  Bitstring    1  SCLDDL_CALQSTAT     Scheduling status of user
              1... ....      SCLDDL_VMDHOTRQ     Hot Shot scheduling requested
              .1.. ....      SCLDDL_VMDHOTST     Hot Shot user scheduling granted
              ..1. ....      SCLDDL_VMDLOADU     Loading user designation
              ...1 ....      SCLDDL_VMDIABIA     Interactive bias is in effect
              .... 1...      SCLDDL_VMDPGBIA     Paging bias is in effect
              .... .1..      SCLDDL_VMDLKSHT     "Lockshot" scheduling in effect
                                                 for this user. Set only in the
                                                 base VMDBK.
              .... ..1.      *
              .... ...1      SCLDDL_VMDNULL      User is logging off
    118  76  Unsigned     2  SCLDDL_VMDCPUAD     Virtual processor address
    120  78  Unsigned     4  SCLDDL_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.
    124  7C  Unsigned     4  SCLDDL_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 if
                                                 this VMDBK has a virtual processor
                                                 dedicated to it, and the user is a
                                                 virtual MP user. Set to a negative
                                                 value if VMDBK has a virtual
                                                 processor dedicated to it, and the
                                                 user is a virtual UP user.
    128  80  Unsigned     4  SCLDDL_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.
    132  84  Bitstring    1  SCLDDL_CALSHARF     Set Share flags
              1... ....      SCLDDL_VMDMXSHA     Max share is Absolute if ON. Max
                                                 share is Relative if OFF.
              .1.. ....      *
              ..1. ....      *
              ...1 ....      *
              .... 1...      *
              .... .1..      *
              .... ..1.      SCLDDL_VMDLIMTH     Max share is Limithard if ON.
                                                 Max share is Limitsoft if OFF.
              .... ...1      *
    133  85  Unsigned     1  *                   Reserved and available for IBM
                                                 use.
    134  86  Signed       2  SCLDDL_VMDSLCNT     Count of minor time slices that
                                                 have expired since the start of
                                                 current transaction.
    136  88  Unsigned     4  SCLDDL_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 SCLDDL_VMDMXSHA to determine
                                                 if Max share is absolute or
                                                 relative.
    140  8C  Character    8  SCLDDL_SRMATOD      Artificial TOD. This TOD only
                                                 advances at the rate the system is
                                                 running user work.
    148  94  Character    8  SCLDDL_SRMATOD2     Artificial TOD2. This TOD only
                                                 advances with each CPU's user time
                                                 and each CPU's wait time.
    156  9C  Unsigned     4  SCLDDL_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 SCLDDL_VMDCTPVR.
    160  A0  Character    0  SCLDDL_END

    MRSCLDDL 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
    SCLDDL                  0    160
    SCLDDL_CALBASE         27           40
    SCLDDL_CALCPPST        68      4
    SCLDDL_CALFLAG1        27      1
    SCLDDL_CALOSTAT        6E      1
    SCLDDL_CALQSTAT        75      1
    SCLDDL_CALRSTAT        6C      1
    SCLDDL_CALSHARF        84      1
    SCLDDL_END             A0      0
    SCLDDL_MRHDR            0      0
    SCLDDL_SRMATOD         8C      8
    SCLDDL_SRMATOD2        94      8
    SCLDDL_VMDABSSH        80      4
    SCLDDL_VMDAUTOL        6E           02
    SCLDDL_VMDCFWT         6C           40
    SCLDDL_VMDCPUAD        76      2
    SCLDDL_VMDCTCRT        78      4
    SCLDDL_VMDCTORF        64      4
    SCLDDL_VMDCTPVG        9C      4
    SCLDDL_VMDCTPVR        34      4
    SCLDDL_VMDCTXBK        5C      4
    SCLDDL_VMDCWSS         70      4
    SCLDDL_VMDDISC         6E           04
    SCLDDL_VMDDPRTY        48      8
    SCLDDL_VMDFLREO        60      4
    SCLDDL_VMDFORCE        6E           10
    SCLDDL_VMDHOTRQ        75           80
    SCLDDL_VMDHOTST        75           40
    SCLDDL_VMDIABIA        75           10
    SCLDDL_VMDIOWT         6C           10
    SCLDDL_VMDLIMTH        84           02
    SCLDDL_VMDLKSHT        75           04
    SCLDDL_VMDLOADU        75           20
    SCLDDL_VMDLRGST        27           80
    SCLDDL_VMDMXSHA        84           80
    SCLDDL_VMDMXSHR        88      4
    SCLDDL_VMDNULL         75           01
    SCLDDL_VMDOPRTY        50      8
    SCLDDL_VMDPGBIA        75           08
    SCLDDL_VMDPGRTE        2C      4
    SCLDDL_VMDRDYCM        26      0
    SCLDDL_VMDRELSH        7C      4
    SCLDDL_VMDRPLIM        30      4
    SCLDDL_VMDRTHRU        58      4
    SCLDDL_VMDSACTL        6F      1
    SCLDDL_VMDSACTX        74      1
    SCLDDL_VMDSIMWT        6C           20
    SCLDDL_VMDSLCNT        86      2
    SCLDDL_VMDSTATE        6D      1
    SCLDDL_VMDSVMID        1C      8
    SCLDDL_VMDSVMWF        24           80
    SCLDDL_VMDSVMWF        25           80
    SCLDDL_VMDSVMWF        26           80
    SCLDDL_VMDSVMWT        24      1
    SCLDDL_VMDSVMWT        25      1
    SCLDDL_VMDSVMWT        26      1
    SCLDDL_VMDSVMW2        25      0
    SCLDDL_VMDSYSOP        6E           80
    SCLDDL_VMDTTIME        40      8
    SCLDDL_VMDUFORC        6E           08
    SCLDDL_VMDUSER         14      8
    SCLDDL_VMDUSRCT        6E           40
    SCLDDL_VMDVTIME        38      8
    SCLDDL_VMDWSSPR        28      4
    SCLDDL_VMDXAUTO        6E           01

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

    Last updated on 1 May 2002 at 16:20:33.

    Copyright IBM Corporation, 1990, 2002