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  128  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 virtual CPU's RELATIVE
                                                share of the system, as set in
                                                the user's directory or via the
                                                SET SHARE command. Set to zero
                                                when this VMDBK has an ABSOLUTE
                                                share value, or has a virtual
                                                processor dedicated to it, or
                                                is in the process of being
                                                logged off.
 32  20  Unsigned     4  SCLSHR_VMDABSSH        This virtual CPU'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 when this VMDBK has
                                                a RELATIVE share value.
 36  24  Bitstring    1  SCLSHR_CALSHARF        Set Share flags
          1... ....      SCLSHR_VMDMXSHA        Max share for this CPU is
                                                ABSOLUTE if on. Max share for
                                                this CPU is RELATIVE if off.
          .1.. ....      *                      
          ..1. ....      *                      
          ...1 ....      *                      
          .... 1...      *                      
          .... .1..      *                      
          .... ..1.      SCLSHR_VMDLIMTH        Max share for this CPU is
                                                LIMITHARD if on. Max share for
                                                this CPU is LIMITSOFT if off.
          .... ...1      *                      
 37  25  Unsigned     3  *                      Reserved and available for
                                                IBM use.
 40  28  Unsigned     4  SCLSHR_VMDMXSHR        This virtual CPU'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  Bitstring    1  SCLSHR_VMDCFGEM        Virtual configuration
                                                indicators. Valid in base VMDBK
                                                only
          1... ....      *                      
          .1.. ....      SCLSHR_VMDCPUAF        User requested CPU Affinity
          ..1. ....      *                      
          ...1 ....      *                      
          .... 1...      *                      
          .... .1..      *                      
          .... ..1.      *                      
          .... ...1      *                      
 45  2D  Bitstring    1  SCLSHR_VMDPUST         CPU Status flag
          1... ....      SCLSHR_VMDAFSUP        CPU Affinity suppressed
          .1.. ....      *                      
          ..1. ....      *                      
          ...1 ....      *                      
          .... 1...      *                      
          .... .1..      *                      
          .... ..1.      *                      
          .... ...1      *                      
 46  2E  Character    2  *                      Reserved for IBM use
 48  30  Unsigned     4  SCLSHR_CP_SSHRELSH     This user's RELATIVE share
                                                setting for CPUs of type CP.
 52  34  Unsigned     4  SCLSHR_CP_SSHABSSH     This user's ABSOLUTE share
                                                setting for CPUs of type CP.
 56  38  Unsigned     4  SCLSHR_CP_SSHMXSHR     This user's Max share setting
                                                for CPUs of type CP.
 60  3C  Bitstring    1  SCLSHR_CP_SSHFLG1      This user's share flags for
                                                CPUs of type CP.
          1... ....      *                      
          .1.. ....      SCLSHR_CP_SSHLIMH      Max share for type CP is
                                                LIMITHARD if on. Max share for
                                                type CP is LIMITSOFT if off.
          ..1. ....      SCLSHR_CP_SSHNMSHA     Normal share for type CP is
                                                ABSOLUTE if on. Normal share
                                                for type CP is RELATIVE if off.
          ...1 ....      SCLSHR_CP_SSHMXSHA     Max share for type CP is
                                                ABSOLUTE if on. Max share for
                                                type CP is RELATIVE if off.
          .... 1...      *                      
          .... .1..      *                      
          .... ..1.      *                      
          .... ...1      *                      
 61  3D  Bitstring    3  *                      Reserved and available for
                                                IBM use.
 64  40  Unsigned     4  SCLSHR_ZAP_SSHRELSH    This user's RELATIVE share
                                                setting for CPUs of type zAAP.
 68  44  Unsigned     4  SCLSHR_ZAP_SSHABSSH    This user's ABSOLUTE share
                                                setting for CPUs of type zAAP.
 72  48  Unsigned     4  SCLSHR_ZAP_SSHMXSHR    This user's Max share setting
                                                for CPUs of type zAAP.
 76  4C  Bitstring    1  SCLSHR_ZAP_SSHFLG1     This user's share flags for
                                                CPUs of type zAAP.
          1... ....      *                      
          .1.. ....      SCLSHR_ZAP_SSHLIMH     Max share for type zAAP is
                                                LIMITHARD if on. Max share for
                                                type zAAP is LIMITSOFT if off.
          ..1. ....      SCLSHR_ZAP_SSHNMSHA    Normal share for type zAAP is
                                                ABSOLUTE if on. Normal share
                                                for type zAAP is RELATIVE if
                                                off.
          ...1 ....      SCLSHR_ZAP_SSHMXSHA    Max share for type zAAP is
                                                ABSOLUTE if on. Max share for
                                                type zAAP is RELATIVE if off.
          .... 1...      *                      
          .... .1..      *                      
          .... ..1.      *                      
          .... ...1      *                      
 77  4D  Bitstring    3  *                      Reserved and available for
                                                IBM use.
 80  50  Unsigned     4  SCLSHR_IFL_SSHRELSH    This user's RELATIVE share
                                                setting for CPUs of type IFL.
 84  54  Unsigned     4  SCLSHR_IFL_SSHABSSH    This user's ABSOLUTE share
                                                setting for CPUs of type IFL.
 88  58  Unsigned     4  SCLSHR_IFL_SSHMXSHR    This user's Max share setting
                                                for CPUs of type IFL.
 92  5C  Bitstring    1  SCLSHR_IFL_SSHFLG1     This user's share flags for
                                                CPUs of type IFL.
          1... ....      *                      
          .1.. ....      SCLSHR_IFL_SSHLIMH     Max share for type IFL is
                                                LIMITHARD if on. Max share for
                                                type IFL is LIMITSOFT if off.
          ..1. ....      SCLSHR_IFL_SSHNMSHA    Normal share for type IFL is
                                                ABSOLUTE if on. Normal share
                                                for type IFL is RELATIVE if
                                                off.
          ...1 ....      SCLSHR_IFL_SSHMXSHA    Max share for type IFL is
                                                ABSOLUTE if on. Max share for
                                                type IFL is RELATIVE if off.
          .... 1...      *                      
          .... .1..      *                      
          .... ..1.      *                      
          .... ...1      *                      
 93  5D  Bitstring    3  *                      Reserved and available for
                                                IBM use.
 96  60  Unsigned     4  SCLSHR_ICF_SSHRELSH    This user's RELATIVE share
                                                setting for CPUs of type ICF.
100  64  Unsigned     4  SCLSHR_ICF_SSHABSSH    This user's ABSOLUTE share
                                                setting for CPUs of type ICF.
104  68  Unsigned     4  SCLSHR_ICF_SSHMXSHR    This user's Max share setting
                                                for CPUs of type ICF.
108  6C  Bitstring    1  SCLSHR_ICF_SSHFLG1     This user's share flags for
                                                CPUs of type ICF.
          1... ....      *                      
          .1.. ....      SCLSHR_ICF_SSHLIMH     Max share for type ICF is
                                                LIMITHARD if on. Max share for
                                                type ICF is LIMITSOFT if off.
          ..1. ....      SCLSHR_ICF_SSHNMSHA    Normal share for type ICF is
                                                ABSOLUTE if on. Normal share
                                                for type ICF is RELATIVE if
                                                off.
          ...1 ....      SCLSHR_ICF_SSHMXSHA    Max share for type ICF is
                                                ABSOLUTE if on. Max share for
                                                type ICF is RELATIVE if off.
          .... 1...      *                      
          .... .1..      *                      
          .... ..1.      *                      
          .... ...1      *                      
109  6D  Bitstring    3  *                      Reserved and available for
                                                IBM use.
112  70  Unsigned     4  SCLSHR_ZIP_SSHRELSH    This user's RELATIVE share
                                                setting for CPUs of type zIIP.
116  74  Unsigned     4  SCLSHR_ZIP_SSHABSSH    This user's ABSOLUTE share
                                                setting for CPUs of type zIIP.
120  78  Unsigned     4  SCLSHR_ZIP_SSHMXSHR    This user's Max share setting
                                                for CPUs of type zIIP.
124  7C  Bitstring    1  SCLSHR_ZIP_SSHFLG1     This user's share flags for
                                                CPUs of type zIIP.
          1... ....      *                      
          .1.. ....      SCLSHR_ZIP_SSHLIMH     Max share for type zIIP is
                                                LIMITHARD if on. Max share for
                                                type zIIP is LIMITSOFT if off.
          ..1. ....      SCLSHR_ZIP_SSHNMSHA    Normal share for type zIIP is
                                                ABSOLUTE if on. Normal share
                                                for type zIIP is RELATIVE if
                                                off.
          ...1 ....      SCLSHR_ZIP_SSHMXSHA    Max share for type zIIP is
                                                ABSOLUTE if on. Max share for
                                                type zIIP is RELATIVE if off.
          .... 1...      *                      
          .... .1..      *                      
          .... ..1.      *                      
          .... ...1      *                      
125  7D  Bitstring    3  *                      Reserved and available for
                                                IBM use.
128  80  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    128
SCLSHR_CALSHARF           24      1
SCLSHR_CP_SSHABSSH        34      4
SCLSHR_CP_SSHFLG1         3C      1
SCLSHR_CP_SSHLIMH         3C           40
SCLSHR_CP_SSHMXSHA        3C           10
SCLSHR_CP_SSHMXSHR        38      4
SCLSHR_CP_SSHNMSHA        3C           20
SCLSHR_CP_SSHRELSH        30      4
SCLSHR_END                80      0
SCLSHR_ICF_SSHABSSH       64      4
SCLSHR_ICF_SSHFLG1        6C      1
SCLSHR_ICF_SSHLIMH        6C           40
SCLSHR_ICF_SSHMXSHA       6C           10
SCLSHR_ICF_SSHMXSHR       68      4
SCLSHR_ICF_SSHNMSHA       6C           20
SCLSHR_ICF_SSHRELSH       60      4
SCLSHR_IFL_SSHABSSH       54      4
SCLSHR_IFL_SSHFLG1        5C      1
SCLSHR_IFL_SSHLIMH        5C           40
SCLSHR_IFL_SSHMXSHA       5C           10
SCLSHR_IFL_SSHMXSHR       58      4
SCLSHR_IFL_SSHNMSHA       5C           20
SCLSHR_IFL_SSHRELSH       50      4
SCLSHR_MRHDR               0      0
SCLSHR_VMDABSSH           20      4
SCLSHR_VMDAFSUP           2D           80
SCLSHR_VMDCFGEM           2C      1
SCLSHR_VMDCPUAF           2C           40
SCLSHR_VMDLIMTH           24           02
SCLSHR_VMDMXSHA           24           80
SCLSHR_VMDMXSHR           28      4
SCLSHR_VMDPUST            2D      1
SCLSHR_VMDRELSH           1C      4
SCLSHR_VMDUSER            14      8
SCLSHR_ZAP_SSHABSSH       44      4
SCLSHR_ZAP_SSHFLG1        4C      1
SCLSHR_ZAP_SSHLIMH        4C           40
SCLSHR_ZAP_SSHMXSHA       4C           10
SCLSHR_ZAP_SSHMXSHR       48      4
SCLSHR_ZAP_SSHNMSHA       4C           20
SCLSHR_ZAP_SSHRELSH       40      4
SCLSHR_ZIP_SSHABSSH       74      4
SCLSHR_ZIP_SSHFLG1        7C      1
SCLSHR_ZIP_SSHLIMH        7C           40
SCLSHR_ZIP_SSHMXSHA       7C           10
SCLSHR_ZIP_SSHMXSHR       78      4
SCLSHR_ZIP_SSHNMSHA       7C           20
SCLSHR_ZIP_SSHRELSH       70      4

This information is based on z/VM V6R1.0.
Last updated on 8 Oct 2009 at 21:08:13.
Copyright IBM Corporation, 1990, 2009