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