NAME       : HCPSSHBK
 DESCRIPTION: User Share Settings control block
 DSECT      : SSHBK
 FUNCTION   : HCPSSHBK contains an array of share values for a
              user per processor type as set by the SET SHARE
              command.  It is used by the System Resource
              Manager (Scheduler) to schedule system resources
              for the user.
 LOCATED BY : VMDSSHBK pointer
 CREATED BY : HCPBVM during user logon
 DELETED BY : HCPUSP during logoff processing
 REFERENCES : None
 SERIALIZED : Scheduler lock (SRMSLOCK)
 RELOCATION CONSIDERATIONS : This control block is relocated as part of a live
              guest relocation (LGR).  The bits and fields that
              need to be relocated are defined in the
              corresponding LGRSSHBK COPY file.  Whenever changes
              are made to this control block, consideration must
              be given to any effects these changes will have on
              a relocation.  If any new fields or bits are
              defined, they may need to be relocated.  If
              existing bits or fields are changed, corresponding
              modifications may be required in the LGR version of
              this control block.  Consider also the effects of
              these changes on a relocation involving a back-level
              release of CP.
 COMPATIBILITY AND MIGRATION CONCERNS : Prior to the support
              for the TYPE operand on the SET SHARE command, the
              fields in this control block were not saved but were
              calculated by adding the corresponding fields in each
              VMDBK in the virtual configuration.  This calculation
              was adequate because the share values were set per user,
              and applied to all CPU types.  Now, share values are set
              per CPU type and may even be set for a type of CPU that
              the user has not yet defined.  This requires a more
              permanent place to store these values for each CPU type
              for each user.

 SSHBK DSECT
Top of page

Hex   Dec Type/Val   Lng Label (dup)    Comments
---- ---- --------- ---- -------------- --------
0000    0 Structure      SSHBK          User Share Settings control block
0000    0 Bitstring   16 SSHARRAY (0)
          0000000C       SSHSIZE        (*-SSHBK+7)/8 SSHBK size in
                                        double words
          00000060       SSHBSIZE       SSHSIZE*8 SSHBK size in bytes


 SSHVBK DSECT
Top of page

Hex   Dec Type/Val   Lng Label (dup)    Comments
---- ---- --------- ---- -------------- --------
0000    0 Structure      SSHVBK         User Share Settings control block
0000    0 Signed       4 SSHSHARS (0)   A symbol used as a base for
                                        indexing the following two
                                        fields, SSHRELSH and SSHABSSH.
                                        Code depends on these fields each
                                        being fullwords and consecutive
                                        IN THE FOLLOWING ORDER.
0000    0 Signed       4 SSHRELSH       The relative share setting for
                                        this CPU type. Code should be
                                        able to handle a range of
                                        1-32767, although currently, only
                                        1-10000 is valid.
0004    4 Signed       4 SSHABSSH       The absolute share setting for
                                        this CPU type. The range is
                                        0.01-1.00.
0008    8 Signed       4 SSHMXSHR       The max-share setting for this
                                        CPU type. IT is either ABSOLUTE
                                        or RELATIVE the SSHMXSHA flag
                                        tells which. If it is RELATIVE it
                                        is an integer. If ABSOLUTE, it is
                                        stored as a fraction of the
                                        system, scaled SHRSCALE. If the
                                        user has no LIMIT it is zero.
                                        (See SSHLIMTH.)
             The following flag byte is defined to have the same
             values as the DVMDLIMT flag.
000C   12 Bitstring    1 SSHFLG1        Share flags byte 1
          .1.. ....      SSHLIMH        X'40' SSHLIMH Limithard share
                                        option
          ..1. ....      SSHNMSHA       X'20' SSHNMSHA Normal share
                                        setting (SSHSHARS) for this CPU
                                        type for this user is ABSOLUTE,
                                        not RELATIVE.
          ...1 ....      SSHMXSHA       X'10' SSHMXSHA Max-share setting
                                        (SSHMXSHR) for this CPU type for
                                        this user is ABSOLUTE, not
                                        RELATIVE.
000D   13 Bitstring    1 SSHFLG2        Share flags byte 2
          1... ....      SSHVINV        X'80' SSHVINV SSHVBK is marked
                                        invalid
000E   14 Bitstring    2 *              Reserved for IBM use
          00000010       SSHVSIZE       (*-SSHVBK) SSVBK size in bytes

          
*** SSHBK - User Share Settings control block
*
*
*** SSHBK - User Share Settings control block
          
*** SSHVBK - User Share Settings control block
*
*     +---------------------------+---------------------------+
*   0 |         SSHRELSH          |         SSHABSSH          |
*     +---------------------------+------+------+-------------+
*   8 |         SSHMXSHR          |:FLG1 |:FLG2 |/////////////|
*     +---------------------------+------+------+-------------+
*  10
*
*** SSHVBK - User Share Settings control block

 
Symbol         Dspl Value
-------------- ---- -----
SSHABSSH       0004
SSHARRAY       0000
SSHBSIZE       0000 00000060
SSHFLG1        000C
SSHFLG2        000D
SSHLIMH        000C 40
SSHMXSHA       000C 10
SSHMXSHR       0008
SSHNMSHA       000C 20
SSHRELSH       0000
SSHSHARS       0000
SSHSIZE        0000 0000000C
SSHVINV        000D 80
SSHVSIZE       000E 00000010