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

MRSCLADL

Prolog
Control Block Contents
Cross Reference

MRSCLADL Prolog

 DSECT NAME - SCLADL
 FUNCTION - Map a Monitor record.
 LOCATED BY -
        Through the Monitor Control Area
 REFERENCED CONTROL BLOCKS -
        MRRECHDR    Monitor Record Header
 NAME - MRSCLADL
 DESCRIPTIVE NAME - Monitor Event Record
                    Domain 2 - Scheduler Domain
                    Record 4 - Add User To Dispatch List
 DESCRIPTION - Indicates conditions after user has been added to
               dispatch list.  A separate record is generated for
               each VMDBK in the virtual machine MP complex.


MRSCLADL Control Block Contents

Offsets
Dec Hex  Type       Len  Name (Dim)             Description
 
  0   0  Structure  196  SCLADL                 Start of monitor record
  0   0  Character    0  SCLADL_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  SCLADL_VMDUSER         Userid
 28  1C  Unsigned     4  SCLADL_SRMTOTST        Memory available to the
                                                scheduler to assign to users as
                                                they enter the dispatch list
 32  20  Unsigned     4  SCLADL_SRMWSSDL        Accumulated count of all
                                                dispatch list users' working
                                                set sizes. This is an
                                                instantaneous (not a smoothed)
                                                value.
 36  24  Unsigned     2  SCLADL_SRMCDISP        Cardinal count of users in
                                                the dispatch list.
 38  26  Unsigned     2  SCLADL_SRMC1DSP        Cardinal count of short,
                                                medium, and long running users
                                                in the dispatch list.
 40  28  Unsigned     2  SCLADL_SRMC2DSP        Cardinal count of medium and
                                                long running users in the
                                                dispatch list. This includes
                                                all Q2 and Q3 users. It
                                                includes no Q1 or Q0 users.
 42  2A  Unsigned     2  SCLADL_SRMC3DSP        Cardinal count of long
                                                running users in the dispatch
                                                list. It includes all Q3 users.
                                                It includes no Q1, Q2, or Q0
                                                users.
 44  2C  Character    8  SCLADL_VMDSVMID        VMDBK name for the last
                                                successful IUCV, VMCF or
                                                APPC/VM Send for this virtual
                                                machine. Valid in base VMDBK
                                                only.
 52  34  Bitstring    1  SCLADL_VMDSVMWT        Service-virtual-machine (SVM)
                                                wait flag - valid in base VMDBK
                                                only.
          1... ....      SCLADL_VMDSVMWF        VMDBK is waiting for a
                                                response from IUCV, VMCF or
                                                APPC.
          .1.. ....      *                      
          ..1. ....      *                      
          ...1 ....      *                      
          .... 1...      *                      
          .... .1..      *                      
          .... ..1.      *                      
          .... ...1      *                      
 53  35  Character    0  SCLADL_VMDSVMW2        back-up byte to the VMDSVMWT
                                                byte. Its contents will persist
                                                longer than they would in
                                                VMDSVMWT. Valid in base VMDBK
                                                only.
 53  35  Bitstring    1  SCLADL_VMDSVMWT        Service-virtual-machine (SVM)
                                                wait flag - valid in base VMDBK
                                                only.
          1... ....      SCLADL_VMDSVMWF        VMDBK is waiting for a
                                                response from IUCV, VMCF or
                                                APPC.
 54  36  Character    0  SCLADL_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.
 54  36  Bitstring    1  SCLADL_VMDSVMWT        Service-virtual-machine (SVM)
                                                wait flag - valid in base VMDBK
                                                only.
          1... ....      SCLADL_VMDSVMWF        VMDBK is waiting for a
                                                response from IUCV, VMCF or
                                                APPC.
 55  37  Bitstring    1  SCLADL_CALFLAG1        Flag byte
          1... ....      SCLADL_CALBASE         If on, this is base VMDBK.
                                                VMDBASE
          .1.. ....      *                      
          ..1. ....      *                      
          ...1 ....      *                      
          .... 1...      *                      
          .... .1..      *                      
          .... ..1.      *                      
          .... ...1      *                      
 56  38  Unsigned     4  SCLADL_VMDWSSPR        This user's projected 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.
 60  3C  Unsigned     4  SCLADL_VMDPGRTE        Number of pages per second
                                                which this user read in during
                                                its last stay in the dispatch
                                                list
 64  40  Bitstring    1  SCLADL_CALQSTAT        Scheduling status of user
          1... ....      SCLADL_VMDHOTRQ        Hot Shot scheduling requested
          .1.. ....      SCLADL_VMDHOTST        Hot Shot user scheduling
                                                granted
          ..1. ....      SCLADL_VMDLOADU        Loading user designation
          ...1 ....      SCLADL_VMDIABIA        Interactive bias is in effect
          .... 1...      SCLADL_VMDPGBIA        Paging bias is in effect
          .... .1..      SCLADL_VMDLKSHT        "Lockshot" scheduling in
                                                effect for this user. Set only
                                                in the base VMDBK.
          .... ..1.      *                      
          .... ...1      SCLADL_VMDNULL         User is logging off
 65  41  Unsigned     1  SCLADL_VMDELIST        This user's dispatch list
                                                class. It can be 0, 1, 2, or 3.
                                                Class 1-3 relate to the time
                                                this (scheduler determined)
                                                transaction has been running.
                                                Class 1 are short-running,
                                                class 2, medium-running and
                                                class 3, long-running.
 66  42  Unsigned     2  SCLADL_VMDCPUAD        Virtual processor address
 68  44  Unsigned     4  SCLADL_VMDRPLIM        Resident page growth limit
 72  48  Unsigned     4  SCLADL_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 SCLADL_VMDCTPVG from
                                                SCLADL_VMDCTPVR.
 76  4C  Character    8  SCLADL_VMDVTIME        Total time that this user was
                                                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 SCLADL_VMDVTIME
                                                is the elapsed time in TOD
                                                clock units.
 84  54  Character    8  SCLADL_VMDTTIME        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 SCLADL_VMDTTIME
                                                is the elapsed time in TOD
                                                clock units.
 92  5C  Character    8  SCLADL_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.
100  64  Character    8  SCLADL_VMDDPRTY        The user'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.
108  6C  Character    8  SCLADL_VMDOPRTY        This user's dispatch priority
                                                before adjustment factors such
                                                as interactive bias and paging
                                                bias
116  74  Unsigned     4  SCLADL_VMDRTHRU        This user's 'required
                                                throughput' or 'resource
                                                access' in the dispatch list
120  78  Unsigned     4  SCLADL_VMDCTXBK        Number of Expanded Storage
                                                blocks allocated to a virtual
                                                machine by CP for paging
124  7C  Unsigned     4  SCLADL_VMDFLREO        Number of frame list reorders
                                                for this virtual system's list
                                                of frames
128  80  Unsigned     4  SCLADL_VMDCTORF        Total number of referenced
                                                frames resident when reset was
                                                done for this virtual system
132  84  Unsigned     4  SCLADL_CALCPPST        Cumulative count of pages
                                                stolen from this user's address
                                                spaces while they were private.
136  88  Bitstring    1  SCLADL_CALOSTAT        Virtual machine operating
                                                status
          1... ....      SCLADL_VMDSYSOP        User is primary system
                                                operator
          .1.. ....      SCLADL_VMDUSRCT        User is counted as being
                                                logged on
          ..1. ....      *                      
          ...1 ....      SCLADL_VMDFORCE        User is to be logged off.
                                                This may be requested by CP, a
                                                forced logoff, or user's logoff
                                                command.
          .... 1...      SCLADL_VMDUFORC        User is forced to logoff the
                                                system
          .... .1..      SCLADL_VMDDISC         User is running disconnected
          .... ..1.      SCLADL_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      SCLADL_VMDXAUTO        The original command was
                                                XAUTOLOG. Valid for the base
                                                VMDBK only.
137  89  Bitstring    1  SCLADL_CALSHARF        Set Share flags
          1... ....      SCLADL_VMDMXSHA        Max share is Absolute if ON.
                                                Max share is Relative if OFF.
          .1.. ....      *                      
          ..1. ....      *                      
          ...1 ....      *                      
          .... 1...      *                      
          .... .1..      *                      
          .... ..1.      SCLADL_VMDLIMTH        Max Share is Limithard if ON.
                                                Max Share is Limitsoft if OFF.
          .... ...1      *                      
138  8A  Signed       2  SCLADL_VMDSLCNT        Count of minor time slices
                                                that have expired since the
                                                start of current transaction.
140  8C  Character    8  SCLADL_VMDESLIC        The elapsed time slice this
                                                user will receive in the
                                                dispatch list before having to
                                                return to the eligible list.
148  94  Unsigned     4  SCLADL_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 this VMDBK has a
                                                virtual processor dedicated to
                                                it and the user is a virtual MP
                                                user. Set to a negative value
                                                if this VMDBK has a virtual
                                                processor dedicated to it, and
                                                this is a virtual UP user.
152  98  Unsigned     4  SCLADL_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.
156  9C  Unsigned     4  SCLADL_VMDVUSCT        Count of start requests to
                                                virtual unit record devices
160  A0  Signed       4  SCLADL_SRMABSDL        Cardinal count of total
                                                absolute shares of all VMDBKs
                                                in the dispatch list. The unit
                                                of value is the same as
                                                SCLADL_VMDABSSH.
164  A4  Signed       4  SCLADL_SRMRELDL        Cardinal count of total
                                                relative shares of all VMDBKs
                                                in the dispatch list.
168  A8  Unsigned     4  SCLADL_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.
172  AC  Unsigned     4  SCLADL_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
                                                SCLADL_VMDMXSHA to determine if
                                                Max share is absolute or
                                                relative.
176  B0  Character    8  SCLADL_SRMATOD         Artificial TOD. This TOD only
                                                advances at the rate the system
                                                is running user work.
184  B8  Character    8  SCLADL_SRMATOD2        Artificial TOD2. This TOD
                                                only advances with each CPU's
                                                user time and each CPU's wait
                                                time.
192  C0  Unsigned     4  SCLADL_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 SCLADL_VMDCTPVR.
196  C4  Character    0  SCLADL_END             

MRSCLADL 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
SCLADL                     0    196
SCLADL_CALBASE            37           80
SCLADL_CALCPPST           84      4
SCLADL_CALFLAG1           37      1
SCLADL_CALOSTAT           88      1
SCLADL_CALQSTAT           40      1
SCLADL_CALSHARF           89      1
SCLADL_END                C4      0
SCLADL_MRHDR               0      0
SCLADL_SRMABSDL           A0      4
SCLADL_SRMATOD            B0      8
SCLADL_SRMATOD2           B8      8
SCLADL_SRMCDISP           24      2
SCLADL_SRMC1DSP           26      2
SCLADL_SRMC2DSP           28      2
SCLADL_SRMC3DSP           2A      2
SCLADL_SRMRELDL           A4      4
SCLADL_SRMTOTST           1C      4
SCLADL_SRMWSSDL           20      4
SCLADL_VMDABSSH           98      4
SCLADL_VMDAUTOL           88           02
SCLADL_VMDCPUAD           42      2
SCLADL_VMDCTCRT           A8      4
SCLADL_VMDCTORF           80      4
SCLADL_VMDCTPVG           C0      4
SCLADL_VMDCTPVR           48      4
SCLADL_VMDCTXBK           78      4
SCLADL_VMDDISC            88           04
SCLADL_VMDDPRTY           64      8
SCLADL_VMDELIST           41      1
SCLADL_VMDEPRTY           5C      8
SCLADL_VMDESLIC           8C      8
SCLADL_VMDFLREO           7C      4
SCLADL_VMDFORCE           88           10
SCLADL_VMDHOTRQ           40           80
SCLADL_VMDHOTST           40           40
SCLADL_VMDIABIA           40           10
SCLADL_VMDLIMTH           89           02
SCLADL_VMDLKSHT           40           04
SCLADL_VMDLOADU           40           20
SCLADL_VMDMXSHA           89           80
SCLADL_VMDMXSHR           AC      4
SCLADL_VMDNULL            40           01
SCLADL_VMDOPRTY           6C      8
SCLADL_VMDPGBIA           40           08
SCLADL_VMDPGRTE           3C      4
SCLADL_VMDRDYCM           36      0
SCLADL_VMDRELSH           94      4
SCLADL_VMDRPLIM           44      4
SCLADL_VMDRTHRU           74      4
SCLADL_VMDSLCNT           8A      2
SCLADL_VMDSVMID           2C      8
SCLADL_VMDSVMWF           34           80
SCLADL_VMDSVMWF           35           80
SCLADL_VMDSVMWF           36           80
SCLADL_VMDSVMWT           34      1
SCLADL_VMDSVMWT           35      1
SCLADL_VMDSVMWT           36      1
SCLADL_VMDSVMW2           35      0
SCLADL_VMDSYSOP           88           80
SCLADL_VMDTTIME           54      8
SCLADL_VMDUFORC           88           08
SCLADL_VMDUSER            14      8
SCLADL_VMDUSRCT           88           40
SCLADL_VMDVTIME           4C      8
SCLADL_VMDVUSCT           9C      4
SCLADL_VMDWSSPR           38      4
SCLADL_VMDXAUTO           88           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