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
Storage Layout
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 V4R3.0.
Last updated on 1 May 2002 at 16:20:33.
Copyright IBM Corporation, 1990, 2002