Programming Interface Information: This information is NOT intended to be used as Programming Interfaces of z/VM.

#### SSHBK

Prolog

Control Block Contents
SSHBK DSECT
SSHVBK DSECT

Storage Layout

Cross Reference (Contains links to field and bit definitions)

#### SSHBK Prolog

     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)
     NOTES      : 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 Control Block Content

#### SSHBK DSECT

####

####

####

    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

    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 Storage Layout

    *** 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

    SSHBK Cross Reference

    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

    This information is
    based on z/VM V6R1.0.
    Last updated on 18 Feb 2010 at 09:08:18 EDT.

    Copyright IBM Corporation, 1990, 2008