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 V5R1.0.
Last updated on 13 Sep 2004 at 11:25:22.
Copyright IBM Corporation, 1990, 2004