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

#### STHLF

Prolog

Control Block Contents
STHLF DSECT

Storage Layout

Cross Reference (Contains links to field and bit definitions)

#### STHLF Prolog

     NAME       : HCPSTHLF
     DESCRIPTION: SUBSYSTEM TABLE HEADER BLOCK
     DSECT      : STHLF
     FUNCTION   : HCPSTHLF DESCRIBES THE SUBSYSTEM TABLE HEADER AREA
                  USED BY HCPLFP TO STORE ALL INFORMATION RELATED TO
                  A SIMULATED CFLF SUBSYSTEM. THERE IS ONE STH PER
                  SUBSYSTEM.
     LOCATED BY : None
                  CFGSTH/CFGSSID IN HCPCFGLF
     CREATED BY : None
                  HCPLFCST
     DELETED BY : None
                  HCPLFCST, HCPLFCRL
     SERIALIZED : CFLF CONFIGURATION LOCK.

#### STHLF Control Block Content

#### STHLF DSECT

    Hex   Dec Type/Val   Lng Label (dup)    Comments
    ---- ---- --------- ---- -------------- --------
    0000    0 Structure      STHLF          SUBSYSTEM TABLE HEADER BLOCK
    0000    0 Bitstring    1 STHFLG         HEADER FLAGS
    0001    1 Bitstring    1 *              RESERVED FOR IBM USE
    0002    2 Bitstring    2 STHSSID        SUBSYSTEM ID
    0004    4 Address      4 STHCFG         ADDRESS OF CONFIGURATION BLOCK
              00000400       STHLOCKS       1024 DEFAULT SUBSYSTEM LOCK SPACE
          THE MAXIMUM AND CURRENT LOCK COUNTS FOR ALL PARTITIONS IS
          MAINTAINED SO THAT THE OUT OF/QUEUED FOR RESOURCES CONDITION
          CAN BE EASILY SIMULATED.
    0008    8 Bitstring    2 STHMXLK        MAXIMUM LOCK SPACE FOR SUBSYSTEM
    000A   10 Bitstring    2 STHCRLK        CURRENTLY AVAILABLE LOCK SPACE
    000C   12 Bitstring    2 STHVDEV        BASE DEVICE ADDRESS FOR SUBSYSTEM
    000E   14 Bitstring    2 *              RESERVED FOR IBM USE
              00000008       STHPTNM        8 NUMBER OF PARTITIONS LIMIT
              00000020       STHUSERS       32 NUMBER OF USERS LIMIT
    0010   16 Bitstring   32 STHPTBL        PARTITION TABLE
          THE MAXIMUM AND CURRENT LOCK COUNTS FOR EACH PARTITION MUST
          ALSO BE MAINTAINED SINCE A PARTITION CAN BE ESTABLISHED
          WITH LESS THAN THE TOTAL ALLOCATED LOCKS.
    0010   16 Bitstring    2 STHMXLKP       MAXIMUM LOCKS FOR PARTITION
    0012   18 Bitstring    2 STHCRLKP       IN-USE LOCKS FOR PARTITION
              00000004       STHPTLN        *-STHMXLKP LENGTH OF A PARTITION
                                            TABLE ENTRY
              00000040       STHCNNM        (4*16) MAXIMUM # CONNECTS ALLOWED
    0030   48 Bitstring 1536 STHCNTB        CONNECT TABLE
              00000630       STHSIZE        *-STHLF SIZE IN BYTES
              000000C6       STHSIZ8        (*-STHLF+7)/8 SIZE IN DOUBLEWORDS

#### STHLF Storage Layout

    *** STHLF - SUBSYSTEM TABLE HEADER BLOCK
    *
    *     +------+------+-------------+---------------------------+
    *   0 |STHFLG|//////|  STHSSID    |          STHCFG           |
    *     +------+------+-------------+-------------+-------------+
    *   8 |  STHMXLK    |  STHCRLK    |  STHVDEV    |/////////////|
    *     +-------------+-------------+-------------+-------------+
    *  10 |                                                       |
    *     =                       STHPTBL                         =
    *     |                                                       |
    *     +-------------------------------------------------------+
    *  30 |                                                       |
    *     =                       STHCNTB                         =
    *     |                                                       |
    *     +-------------------------------------------------------+
    * 630
    *
    *** STHLF - SUBSYSTEM TABLE HEADER BLOCK

    *** Overlay for STHPTBL in STHLF
    *
    *     +-------------+-------------+
    *  10 |  STHMXLKP   |  STHCRLKP   | 14
    *     +-------------+-------------+
    *
    *** Overlay for STHPTBL in STHLF

#### STHLF Cross Reference

    Symbol         Dspl Value
    -------------- ---- -----
    STHCFG         0004
    STHCNNM        0012 00000040
    STHCNTB        0030
    STHCRLK        000A
    STHCRLKP       0012
    STHFLG         0000
    STHLOCKS       0004 00000400
    STHMXLK        0008
    STHMXLKP       0010
    STHPTBL        0010
    STHPTLN        0012 00000004
    STHPTNM        000E 00000008
    STHSIZE        0030 00000630
    STHSIZ8        0030 000000C6
    STHSSID        0002
    STHUSERS       000E 00000020
    STHVDEV        000C

This information is based on z/VM V5R2.0. Last updated on 12 Apr 2006 at 17:28:12 EDT.
Copyright IBM Corporation, 1990, 2005