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
       2   2  Unsigned      2  MRHDRZER
       4   4  Unsigned      1  MRHDRDM
       5   5  Unsigned      1  *
       6   6  Unsigned      2  MRHDRRC
       8   8  Character     8  MRHDRTOD
      16  10  Character     4  *
      20  14  Character     0  MRHDR_END
      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.
                                                      Note: This field is
                                                      maintained for compatibility.
                                                      The per- CPU type fields
                                                      below should be used instead,
                                                      as they contain the share
                                                      settings for the virtual
                                                      machine, not just one of the
                                                      virtual CPUs
      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.
                                                      Note: This field is
                                                      maintained for compatibility.
                                                      The per- CPU type fields
                                                      below should be used instead,
                                                      as they contain the share
                                                      settings for the virtual
                                                      machine, not just one of the
                                                      virtual CPUs
      36  24  Bitstring     1  SCLSHR_CALSHARF        Set Share flags Note: This
                                                      field is maintained for
                                                      compatibility. The per- CPU
                                                      type fields below should be
                                                      used instead, as they contain
                                                      the share settings for the
                                                      virtual machine, not just one
                                                      of the virtual CPUs
              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. Note:
                                                      This field is maintained for
                                                      compatibility. The per- CPU
                                                      type fields below should be
                                                      used instead, as they contain
                                                      the share settings for the
                                                      virtual machine, not just one
                                                      of the virtual CPUs
      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 V7R2.0.

    Last updated on 08 August 2020 at 16:13:45.

    Copyright IBM Corporation, 1990, 2020