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
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 V5R2.0.

    Last updated on 11 Dec 2005 at 18:48:12.

    Copyright IBM Corporation, 1990, 2005