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

#### MRSCLSHR

Prolog
Control Block Contents
Cross Reference

#### MRSCLSHR Prolog

####

####

     DSECT NAME - SCLSHR
     FUNCTION - Map a Monitor record.
     LOCATED BY -
               Through the Monitor Control Area
     REFERENCED CONTROL BLOCKS -
            MRRECHDR    Monitor Record Header
     NAME - MRSCLSHR
     DESCRIPTIVE NAME - Monitor Event Record
                        Domain 2 - Scheduler Domain
                        Record 9 - SET SHARE Changes
     DESCRIPTION - Records changes made by a SET SHARE command.
                   Generated only if the user who is the target of the
                   command is enabled for scheduler domain (not to be
                   confused with the user that issued the command).

    MRSCLSHR Control Block Contents

    Offsets
    Dec Hex  Type       Len  Name (Dim)             Description

      0   0  Structure   44  SCLSHR                 Start of monitor record
      0   0  Character    0  SCLSHR_MRHDR           Record header
      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  SCLSHR_VMDUSER         Userid
     28  1C  Unsigned     4  SCLSHR_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 this 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.
     32  20  Unsigned     4  SCLSHR_VMDABSSH        The 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.
     36  24  Bitstring    1  SCLSHR_CALSHARF        Set Share flags
              1... ....      SCLSHR_VMDMXSHA        Max share is Absolute if ON.
                                                    Max share is Relative if OFF.
              .1.. ....      *
              ..1. ....      *
              ...1 ....      *
              .... 1...      *
              .... .1..      *
              .... ..1.      SCLSHR_VMDLIMTH        Max Share is Limithard if ON.
                                                    Max Share is Limitsoft if OFF.
              .... ...1      *
     37  25  Unsigned     3  *                      Reserved and available for
                                                    IBM use.
     40  28  Unsigned     4  SCLSHR_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
                                                    SCLSHR_VMDMXSHA to determine if
                                                    Max share is absolute or
                                                    relative.
     44  2C  Character    0  SCLSHR_END

    MRSCLSHR 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
    SCLSHR                     0     44
    SCLSHR_CALSHARF           24      1
    SCLSHR_END                2C      0
    SCLSHR_MRHDR               0      0
    SCLSHR_VMDABSSH           20      4
    SCLSHR_VMDLIMTH           24           02
    SCLSHR_VMDMXSHA           24           80
    SCLSHR_VMDMXSHR           28      4
    SCLSHR_VMDRELSH           1C      4
    SCLSHR_VMDUSER            14      8

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

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

    Copyright IBM Corporation, 1990, 2005