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

    Last updated on 22 Jul 2003 at 15:04:23.

    Copyright IBM Corporation, 1990, 2003