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

SSIBK

Prolog  

Control Block Contents  
   SSIBK DSECT

Storage Layout  

Cross Reference (Contains links to field and bit definitions)  


SSIBK Prolog

 NAME       : HCPSSIBK
 DESCRIPTION: System Information Block Dsect
 DSECT      : SSIBK
 FUNCTION   : This 4K block maps the output(s) returned from
              the Store System Information (STSI) instruction.
 LOCATED BY : HCPSSIBK
 CREATED BY : HCPSSI
 DELETED BY : N/A
 REFERENCES : none
 SERIALIZED : none
 RELOCATION CONSIDERATIONS : None
 COMPATIBILITY AND MIGRATION CONCERNS : N/A
              The Store System Information (STSI) instruction output will
              vary based on values in R0 and R1.
              Depending upon a "Function Code" value specified in General
              Register 0, either an identification of the level of the
              configuration executing the program is placed in General
              Register 0 or information about a component or components of
              a configuration is stored in a System-Information Block (SYSIB).
              When information about a component or components is requested,
              the information is further specified by contents of General
              Register 1.  The SYSIB, if any, is specified by the 2nd operand.
              The SYSIB is a 4K block and has different fields and values
              depending upon the Function code and Selector values, which are
              mapped out in this copy block file.
              The naming convention used herein is as follows:
              SSIxyyyy
              where:
              SSI - HCPSSIBK Major name
              x - Indicates the Source of the data
              1 - The data is from the 'Basic Machine'
              2 - The data is from an LPAR running on the Basic Machine
              3 - The data is from a Virtual Machine
              F - Current Configuration Level Information
              yyyy - Field name descriptor
              Notes      : A Basic Machine is always present, and a Logical
              Partition may or may not always be present between
              the Basic Machine and the Virtual Machine.
              Information about a level is only provided if that
              level implements the STSI instruction.

 

SSIBK Control Block Content


SSIBK DSECT

Hex   Dec Type/Val   Lng Label (dup)    Comments
---- ---- --------- ---- -------------- --------
0000    0 Structure      SSIBK          System Information Block Dsect
0000    0 Bitstring    1 SSIBEG (4096)  This block is 1 page
      Store System Information Block for:
       - STSI 1.1.1 - Basic-Machine Configuration
0000    0 Signed       2 SSI111 (0)
0000    0 Bitstring    1 SSI111B0       A flag byte
          1... ....      SSI1P          X'80' SSI1P Type-Percentage Byte
                                        Validity
          .... ...1      SSI1TRNS       X'01' SSI1TRNS Transient CCR and
                                        CAI.
0001    1 Bitstring    1 *              RESERVED
0002    2 Bitstring    1 SSI1CCR        Capacity-Change Reason
          00000001       SSI1CCR_manual 1 SSI1CCR_manual The capacity
                                        change is due solely to the
                                        setting of a manual control.
          00000002       SSI1CCR_machine_exception
                                        2 SSI1CCR_machine_exception The
                                        capacity change is due to a
                                        machine exception condition.
          00000003       SSI1CCR_machine_non_exception
                                        3 SSI1CCR_machine_non_exception
                                        The capacity change is due to a
                                        non-exception machine condition.
          00000004       SSI1CCR_environmental_exception
                                        4 SSI1CCR_environmental_exception
                                        The capacity change is due to an
                                        exception condition external to
                                        the machine.
0003    3 Bitstring    1 SSI1CAI        Capacity-Adjustment Indication
          00000000       SSI1CAI_no_indication
                                        0 SSI1CAI_no_indication
                                        Indication not repo
          00000064       SSI1CAI_normal 100 SSI1CAI_normal Running at
                                        nominal capacit
0004    4 Signed       4 * (7)          RESERVED
0020   32 Character   16 SSI1MFG        Manufacturer
0030   48 Character    4 SSI1TYPE       Machine Type
0034   52 Character   12 *              RESERVED
0040   64 Character   16 SSI1MODL       Model Capacity Identifier
0050   80 Character   16 SSI1SEQ1       Sequence Code
0060   96 Character    4 SSI1POM1       Plant of Manufacture
0064  100 Character   16 SSI1MOD        Model
0074  116 Character   16 SSI1MPCI       Model-Perm-Capacity Identifier
0084  132 Character   16 SSI1MTCI       Model-Temp-Capacity Identifier
0094  148 Signed       4 SSI1MCR        Model-Capacity Rating
0098  152 Signed       4 SSI1MPCR       Model-Perm-Cap Rating
009C  156 Signed       4 SSI1MTCR       Model-Temp-Cap Rating
00A0  160 Bitstring    1 SSI1T1P        Type 1 Percentage
00A1  161 Bitstring    1 SSI1T2P        Type 2 Percentage
00A2  162 Bitstring    1 SSI1T3P        Type 3 Percentage
00A3  163 Bitstring    1 SSI1T4P        Type 4 Percentage
00A4  164 Bitstring    1 SSI1T5P        Type 5 Percentage
00A5  165 Character    3 *              RESERVED
00A8  168 Signed       4 SSI1NCR        Nominal-Capacity Rating
00AC  172 Signed       4 SSI1NPCR       Nominal-Perm-Capacity Rating
00B0  176 Signed       4 SSI1NTCR       Nominal-Temp-Capacity Rating
00B4  180 Bitstring 3916 *              RESERVED
      Store System Information Block for:
       - STSI 1.2.1 - Basic-Machine CPU
0000    0 Signed       2 SSI121 (0)
0000    0 Signed       4 * (20)         RESERVED
0050   80 Character   16 SSI1SEQ2       Sequence Code
0060   96 Character    4 SSI1POM2       Plant of Manufacture
0064  100 Signed       2 *              RESERVED
0066  102 Signed       2 SSI1CPUA       CPU Address
0068  104 Signed       4 * (998)        RESERVED
      Store System Information Block for:
       - STSI 1.2.2 - Basic-Machine CPU
0000    0 Signed       2 SSI122 (0)
0000    0 Signed       1 SSI1FORM       Format
0001    1 Bitstring    1 *              RESERVED
0002    2 Signed       2 SSI1ACC        Alternate-CPU-Capability offset
0004    4 Signed       4 * (5)          RESERVED
0018   24 Signed       4 SSI1NCAP       Nominal CPU Capability
001C   28 Signed       4 SSI1SCAP       Secondary CPU Capability
0020   32 Signed       4 SSI1CCAP       CPU Capability
0024   36 Signed       2 SSI1CCNT       Total CPU count
0026   38 Signed       2 SSI1CCFG       Configured CPU count
0028   40 Signed       2 SSI1CSTB       Standby CPU count
002A   42 Signed       2 SSI1CRES       Reserved CPU Count
002C   44 Signed       2 SSI1CMAF       MP CPU Capability Adjustment
002E   46 Signed       2 SSI1CMPA (2025)
                                        factors.
      Store System Information Block for:
       - STSI 2.2.1 - Logical-Partition CPU
0000    0 Signed       2 SSI221 (0)
0000    0 Signed       4 * (20)         RESERVED
0050   80 Character   16 SSI2SEQ1       Logical CPU sequence code
0060   96 Character    4 SSI2POM1       Logical Plant on Mfg
0064  100 Signed       2 SSI2CPID       LCPU identification
0066  102 Signed       2 SSI2CPUA       LCPU Address
0068  104 Signed       4 * (998)        RESERVED
      Store System Information Block for:
       - STSI 2.2.2 - Logical-Partition CPUs
0000    0 Signed       2 SSI222 (0)
0000    0 Signed       4 * (8)          RESERVED
0020   32 Signed       2 SSI2PNUM       LPAR Number
0022   34 Bitstring    1 *              RESERVED
0023   35 Bitstring    1 SSI2CPCH       CPU Characteristics
0024   36 Signed       2 SSI2CCNT       Total LCPU count
0026   38 Signed       2 SSI2CCFG       Configured LCPU count
0028   40 Signed       2 SSI2CSTB       Standby LCPU count
002A   42 Signed       2 SSI2CRES       Reserved LCPU count
002C   44 Character    8 SSI2PNAM       LPAR Name
0034   52 Signed       4 SSI2PCAF       LPAR CAF
0038   56 Signed       4 * (4)          RESERVED
0048   72 Signed       2 SSI2CDED       Dedicated CPU count
004A   74 Signed       2 SSI2CSHR       Shared CPU count
004C   76 Signed       4 * (1005)       RESERVED
      Store System Information Block for:
       - STSI 3.2.2 - Virtual-Machine CPUs
0000    0 Signed       2 SSI322 (0)
0000    0 Signed       4 * (7)          RESERVED
001C   28 Bitstring    3 *              RESERVED
001F   31 Bitstring    1 SSI3DBCT       Descriptor Block Count
0020   32 Bitstring   64 SSI3VMDB       VM Descriptor Block
0020   32 Signed       4 *              RESERVED
0024   36 Signed       2 SSI3CPUC       Total VMDBK Logical-CPU count
0026   38 Signed       2 SSI3CCFG       Configured Logical-CPU count
0028   40 Signed       2 SSI3CSTB       Standby Logical-CPU count
002A   42 Signed       2 SSI3CRES       Reserved Logical-CPU count
002C   44 Character    8 SSI3VMID       Virtual Machine Identification
0034   52 Signed       4 SSI3MCAF       VM Capability Adjustment Factor
0038   56 Character   16 SSI3CPID       CP Identifier (Hypervisor) Id
0038   56 Character    8 SSI3VNAM       Virtual Machine Name
0040   64 Character    1 SSI3VVER       Virtual Machine Version
0041   65 Character    1 SSI3VDL1       Delimiter (.)
0042   66 Character    1 SSI3VREL       Virtual Machine Release
0043   67 Character    1 SSI3VDL2       Delimiter (.)
0044   68 Character    1 SSI3VMOD       Virtual Machine Release Mod Level
0045   69 Character    3 SSI3VEND       RESERVED
0048   72 Signed       4 * (6)          RESERVED
0060   96 Bitstring   64 SSI3VNXT (7)   Upto 7 nested VMDBK Levels
0220  544 Signed       4 * (888)        RESERVED
      Store System Information Block for:
       - STSI 15.1.x - Current Configuration Level Information
0000    0 Signed       2 SSIF1x (0)     STSI 15.1.x response
0000    0 Signed       2 *              Reserved for IBM use
0002    2 Signed       2 SSIFLEN        Length
0004    4 Bitstring    1 SSIFMAG6       Max MNest 6 containers
0005    5 Bitstring    1 SSIFMAG5       Max MNest 5 containers
0006    6 Bitstring    1 SSIFMAG4       Max MNest 4 containers
0007    7 Bitstring    1 SSIFMAG3       Max MNest 3 containers
0008    8 Bitstring    1 SSIFMAG2       Max MNest 2 containers
0009    9 Bitstring    1 SSIFMAG1       Max CPU-type TLEs
000A   10 Bitstring    1 *              Reserved for IBM use
000B   11 Bitstring    1 SSIFMNES       Max MNest facility installed (1-6
                                        are valid values)
000C   12 Signed       4 *              Reserved for IBM use
0010   16 Signed       4 SSIFTOPL (1020)
                                        Topology List...could grow to
                                        rest of 4K page

 

SSIBK Storage Layout

          
*** SSIBK - System Information Block Dsect
*
*     +-------------------------------------------------------+
*   0 |                                                       |
*     =                        SSIBEG                         =
*     |                                                       |
*     +-------------------------------------------------------+
*1000
*
*** SSIBK - System Information Block Dsect
          
*** Overlay for SSIBEG in SSIBK
*
*     +------+------+------+------+---------------------------+
*   0 |:111B0|//////|:1CCR |:1CAI |///////////////////////////|
*     +------+------+------+------+///////////////////////////|
*   8 |///////////////////////////////////////////////////////|
*     =///////////////////////////////////////////////////////=
*     |///////////////////////////////////////////////////////|
*     +-------------------------------------------------------+
*  20 |                       SSI1MFG                         |
*     |                                                       |
*     +---------------------------+---------------------------+
*  30 |         SSI1TYPE          |///////////////////////////|
*     +---------------------------+///////////////////////////|
*     |///////////////////////////////////////////////////////|
*     +-------------------------------------------------------+
*  40 |                       SSI1MODL                        |
*     |                                                       |
*     +-------------------------------------------------------+
*  50 |                       SSI1SEQ1                        |
*     |                                                       |
*     +---------------------------+---------------------------+
*  60 |         SSI1POM1          |                           |
*     +---------------------------+                           |
*     |                       SSI1MOD                         |
*     |                           +---------------------------+
*  70 |                           |                           |
*     +---------------------------+                           |
*     |                       SSI1MPCI                        |
*     |                           +---------------------------+
*  80 |                           |                           |
*     +---------------------------+                           |
*     |                       SSI1MTCI                        |
*     |                           +---------------------------+
*  90 |                           |         SSI1MCR           |
*     +---------------------------+---------------------------+
*  98 |         SSI1MPCR          |         SSI1MTCR          |
*     +------+------+------+------+------+--------------------+
*  A0 |:1T1P |:1T2P |:1T3P |:1T4P |:1T5P |////////////////////|
*     +------+------+------+------+------+--------------------+
*  A8 |         SSI1NCR           |         SSI1NPCR          |
*     +---------------------------+---------------------------+
*  B0 |         SSI1NTCR          |///////////////////////////|
*     +---------------------------+///////////////////////////|
*  B8 |///////////////////////////////////////////////////////|
*     =///////////////////////////////////////////////////////=
*     |///////////////////////////////////////////////////////|
*     +-------------------------------------------------------+
*1000
*
*** Overlay for SSIBEG in SSIBK
          
*** Overlay for SSIBEG in SSIBK
*
*     +-------------------------------------------------------+
*   0 |///////////////////////////////////////////////////////|
*     =///////////////////////////////////////////////////////=
*     |///////////////////////////////////////////////////////|
*     +-------------------------------------------------------+
*  50 |                       SSI1SEQ2                        |
*     |                                                       |
*     +---------------------------+-------------+-------------+
*  60 |         SSI1POM2          |/////////////|  SSI1CPUA   |
*     +---------------------------+-------------+-------------+
*  68 |///////////////////////////////////////////////////////|
*     =///////////////////////////////////////////////////////=
*     |///////////////////////////////////////////////////////|
*     +-------------------------------------------------------+
*1000
*
*** Overlay for SSIBEG in SSIBK
          
*** Overlay for SSIBEG in SSIBK
*
*     +------+------+-------------+---------------------------+
*   0 |:1FORM|//////|  SSI1ACC    |///////////////////////////|
*     +------+------+-------------+///////////////////////////|
*     |///////////////////////////////////////////////////////|
*     |///////////////////////////////////////////////////////|
*     +---------------------------+---------------------------+
*  18 |         SSI1NCAP          |         SSI1SCAP          |
*     +---------------------------+-------------+-------------+
*  20 |         SSI1CCAP          |  SSI1CCNT   |  SSI1CCFG   |
*     +-------------+-------------+-------------+-------------+
*  28 |  SSI1CSTB   |  SSI1CRES   |  SSI1CMAF   |             |
*     +-------------+-------------+-------------+             |
*  30 |                                                       |
*     =                       SSI1CMPA                        =
*     |                                                       |
*     +-------------------------------------------------------+
*1000
*
*** Overlay for SSIBEG in SSIBK
          
*** Overlay for SSIBEG in SSIBK
*
*     +-------------------------------------------------------+
*   0 |///////////////////////////////////////////////////////|
*     =///////////////////////////////////////////////////////=
*     |///////////////////////////////////////////////////////|
*     +-------------------------------------------------------+
*  50 |                       SSI2SEQ1                        |
*     |                                                       |
*     +---------------------------+-------------+-------------+
*  60 |         SSI2POM1          |  SSI2CPID   |  SSI2CPUA   |
*     +---------------------------+-------------+-------------+
*  68 |///////////////////////////////////////////////////////|
*     =///////////////////////////////////////////////////////=
*     |///////////////////////////////////////////////////////|
*     +-------------------------------------------------------+
*1000
*
*** Overlay for SSIBEG in SSIBK
          
*** Overlay for SSIBEG in SSIBK
*
*     +-------------------------------------------------------+
*   0 |///////////////////////////////////////////////////////|
*     =///////////////////////////////////////////////////////=
*     |///////////////////////////////////////////////////////|
*     +-------------+------+------+-------------+-------------+
*  20 |  SSI2PNUM   |//////|:2CPCH|  SSI2CCNT   |  SSI2CCFG   |
*     +-------------+------+------+-------------+-------------+
*  28 |  SSI2CSTB   |  SSI2CRES   |        SSI2PNAM-          |
*     +-------------+-------------+---------------------------+
*  30 |          -(02C)           |         SSI2PCAF          |
*     +---------------------------+---------------------------+
*  38 |///////////////////////////////////////////////////////|
*     |///////////////////////////////////////////////////////|
*     +-------------+-------------+---------------------------+
*  48 |  SSI2CDED   |  SSI2CSHR   |///////////////////////////|
*     +-------------+-------------+///////////////////////////|
*  50 |///////////////////////////////////////////////////////|
*     =///////////////////////////////////////////////////////=
*     |///////////////////////////////////////////////////////|
*     +-------------------------------------------------------+
*1000
*
*** Overlay for SSIBEG in SSIBK
          
*** Overlay for SSIBEG in SSIBK
*
*     +-------------------------------------------------------+
*   0 |///////////////////////////////////////////////////////|
*     =///////////////////////////////////////////////////////=
*     |///////////////////////////+--------------------+------+
*  18 |///////////////////////////|////////////////////|:3DBCT|
*     +---------------------------+--------------------+------+
*  20 |                                                       |
*     =                       SSI3VMDB                        =
*     |                                                       |
*     +-------------------------------------------------------+
*  60
*
*** Overlay for SSIBEG in SSIBK
          
*** Overlay for SSI3VMDB in SSIBK
*
*     +---------------------------+-------------+-------------+
*  20 |///////////////////////////|  SSI3CPUC   |  SSI3CCFG   |
*     +-------------+-------------+-------------+-------------+
*  28 |  SSI3CSTB   |  SSI3CRES   |        SSI3VMID-          |
*     +-------------+-------------+---------------------------+
*  30 |          -(02C)           |         SSI3MCAF          |
*     +---------------------------+---------------------------+
*  38 |                       SSI3CPID                        |
*     |                                                       |
*     +-------------------------------------------------------+
*  48
*
*** Overlay for SSI3VMDB in SSIBK
          
*** Overlay for SSI3CPID in SSIBK
*
*     +-------------------------------------------------------+
*  38 |                       SSI3VNAM                        |
*     +------+------+------+------+------+--------------------+
*  40 |:3VVER|:3VDL1|:3VREL|:3VDL2|:3VMOD|     SSI3VEND       |
*     +------+------+------+------+------+--------------------+
*  48 |///////////////////////////////////////////////////////|
*     =///////////////////////////////////////////////////////=
*     |///////////////////////////////////////////////////////|
*     +-------------------------------------------------------+
*  60 |                                                       |
*     =                       SSI3VNXT                        =
*     |                                                       |
*     +-------------------------------------------------------+
* 220 |///////////////////////////////////////////////////////|
*     =///////////////////////////////////////////////////////=
*     |///////////////////////////////////////////////////////|
*     +-------------------------------------------------------+
*1000
*
*** Overlay for SSI3CPID in SSIBK
          
*** Overlay for SSIBEG in SSIBK
*
*     +-------------+-------------+------+------+------+------+
*   0 |/////////////|  SSIFLEN    |:FMAG6|:FMAG5|:FMAG4|:FMAG3|
*     +------+------+------+------+------+------+------+------+
*   8 |:FMAG2|:FMAG1|//////|:FMNES|///////////////////////////|
*     +------+------+------+------+---------------------------+
*  10 |                                                       |
*     =                       SSIFTOPL                        =
*     |                                                       |
*     +-------------------------------------------------------+
*1000
*
*** Overlay for SSIBEG in SSIBK

 

SSIBK Cross Reference

Symbol         Dspl Value
-------------- ---- -----
SSIBEG         0000
SSIFLEN        0002
SSIFMAG1       0009
SSIFMAG2       0008
SSIFMAG3       0007
SSIFMAG4       0006
SSIFMAG5       0005
SSIFMAG6       0004
SSIFMNES       000B
SSIFTOPL       0010
SSIF1x         0000
SSI1ACC        0002
SSI1CAI        0003
SSI1CAI_no_indication
               0003 00000000
SSI1CAI_normal
               0003 00000064
SSI1CCAP       0020
SSI1CCFG       0026
SSI1CCNT       0024
SSI1CCR        0002
SSI1CCR_environmental_exception
               0002 00000004
SSI1CCR_machine_exception
               0002 00000002
SSI1CCR_machine_non_exception
               0002 00000003
SSI1CCR_manual
               0002 00000001
SSI1CMAF       002C
SSI1CMPA       002E
SSI1CPUA       0066
SSI1CRES       002A
SSI1CSTB       0028
SSI1FORM       0000
SSI1MCR        0094
SSI1MFG        0020
SSI1MOD        0064
SSI1MODL       0040
SSI1MPCI       0074
SSI1MPCR       0098
SSI1MTCI       0084
SSI1MTCR       009C
SSI1NCAP       0018
SSI1NCR        00A8
SSI1NPCR       00AC
SSI1NTCR       00B0
SSI1P          0000 80
SSI1POM1       0060
SSI1POM2       0060
SSI1SCAP       001C
SSI1SEQ1       0050
SSI1SEQ2       0050
SSI1TRNS       0000 01
SSI1TYPE       0030
SSI1T1P        00A0
SSI1T2P        00A1
SSI1T3P        00A2
SSI1T4P        00A3
SSI1T5P        00A4
SSI111         0000
SSI111B0       0000
SSI121         0000
SSI122         0000
SSI2CCFG       0026
SSI2CCNT       0024
SSI2CDED       0048
SSI2CPCH       0023
SSI2CPID       0064
SSI2CPUA       0066
SSI2CRES       002A
SSI2CSHR       004A
SSI2CSTB       0028
SSI2PCAF       0034
SSI2PNAM       002C
SSI2PNUM       0020
SSI2POM1       0060
SSI2SEQ1       0050
SSI221         0000
SSI222         0000
SSI3CCFG       0026
SSI3CPID       0038
SSI3CPUC       0024
SSI3CRES       002A
SSI3CSTB       0028
SSI3DBCT       001F
SSI3MCAF       0034
SSI3VDL1       0041
SSI3VDL2       0043
SSI3VEND       0045
SSI3VMDB       0020
SSI3VMID       002C
SSI3VMOD       0044
SSI3VNAM       0038
SSI3VNXT       0060
SSI3VREL       0042
SSI3VVER       0040
SSI322         0000

This information is based on z/VM V6R2.0. Last updated on 21 Nov 2011 at 11:23:02 EDT.
Copyright IBM Corporation, 1990, 2011