Programming Interface Information:
This information is NOT intended to be used as Programming Interfaces of z/VM. |
SSIBK
Control Block Contents
SSIBK DSECT
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
Copyright IBM Corporation, 1990, 2011