Function Code X'0000' - Processor Capacity Information
Function code X'0000' returns information on capacity of general-purpose processors (CPs), z Integrated Information Processor (zIIP), and Integrated Facility for Linux® processors (IFLs), including current CPU resources available at the machine, logical partition, hypervisor, and guest levels, as well as any caps that restrict the guest's use of these resources. This information enables an application to determine the maximum capacity of CPs, zIIPs, and IFLs available to software running in the issuing virtual machine.
When function code X'0000' is specified, general register R2 contains the guest logical address of a 4 KB response buffer, which must be on a 4 KB boundary or a specification exception is recognized.
When the instruction completes with condition code 3, the response buffer located by the guest logical address in R2 is unchanged. When the instruction completes with condition code 0, CPU capacity information will be stored into the buffer at the guest logical address specified by register R2.
The response buffer returns one section of data for each of the following:
- The Header section. See Function Code X'0000' Response Header (INF0HDR DSECT).
- The Machine section. See Function Code X'0000' Response Machine Section (INF0MAC DSECT).
- The Partition section. See Function Code X'0000' Response Partition Section (INF0PAR DSECT).
The response buffer returns up to three sections of data for each of the following:
- The Hypervisor section. See Function Code X'0000' Response Hypervisor Section (INF0HYP DSECT).
- The Guest section. See Function Code X'0000' Response Guest Section (INF0GST DSECT).
Multiple levels can be reported for the Hypervisor and Guest sections when, for example, z/VM® is run as a guest of z/VM. A maximum of three levels of Hypervisor and Guest sections are reported. When more than three levels exist, the three levels closest to the hardware that support the STHYI instruction are returned in the buffer. These sections are numbered 1-3, starting with the level that is closest to the hardware. The remaining unused area in the 4 KB response buffer is cleared (set to 0).
Each Hypervisor section in the function code 0 response contains a mask of the supported function codes. When running a hypervisor second level or higher, a complete response for function code 0 is available only if all hypervisor levels support function code 0.
Function Code X'0000' Response Buffer Format (INF0HDR)
INF0HDR DSECT in HCPINFBK COPY of HCPGPI MACLIB describes the response buffer format and might include information regarding usage of the fields in the DSECT.
The header section is placed at the beginning of the response buffer and identifies the location and length of all other sections. Valid sections have nonzero offset and length values in the header. Each section provides information about the validity of fields within that section.
Function Code X'0000' Response Header (INF0HDR DSECT)
+------+------+------+------+--------------------+------+
0 |:HFLG1|:HFLG2|:HVAL1|:HVAL2|////////////////////|:HYGCT|
+------+------+------+------+-------------+------+------+
8 | INFHTOTL | INFHDLN | INFMOFF | INFMLEN |
+-------------+-------------+-------------+-------------+
10 | INFPOFF | INFPLEN | INFHOFF1 | INFHLEN1 |
+-------------+-------------+-------------+-------------+
18 | INFGOFF1 | INFGLEN1 | INFHOFF2 | INFHLEN2 |
+-------------+-------------+-------------+-------------+
20 | INFGOFF2 | INFGLEN2 | INFHOFF3 | INFHLEN3 |
+-------------+-------------+-------------+-------------+
28 | INFGOFF3 | INFGLEN3 |///////////////////////////|
+-------------+-------------+---------------------------+
30
Hex Dec Type/Val Lng Label (dup) Comments
---- ---- --------- ---- -------------- --------
0000 0 Structure INF0HDR Mappings for STHYI
0000 0 Bitstring 1 INFHFLG1 Header Flag Byte 1 These flag
settings indicate the environment
that the instruction was executed
in and may influence the value of
validity bits. The validity bits,
not these flags, should be used
to determine if a field is valid.
1... .... INFGPDU X'80' INFGPDU Global Performance
Data unavailable
.1.. .... INFSTHYI X'40' INFSTHYI One or more
hypervisor levels below this
level does not support the STHYI
instruction. When this flag is
set the value of INFGPDU is not
meaningful because the state of
the Global Performance Data
setting cannot be determined.
..1. .... INFVSI X'20' INFVSI Virtualization stack
is incomplete. This bit indicates
one of 2 cases: 1. One or more
hypervisor levels do not support
STHYI. For this case INFSTHYI
will also be set. 2. There were
more than 3 levels of
guest/hypervisor information to
report.
...1 .... INFBASIC X'10' INFBASIC Execution
environment is not within a
logical partition.
0001 1 Bitstring 1 INFHFLG2 Header Flag Byte 2 reserved for
IBM use
0002 2 Bitstring 1 INFHVAL1 Header Validity Byte 1 Reserved
for IBM use
0003 3 Bitstring 1 INFHVAL2 Header Validity Byte 2 Reserved
for IBM use
0004 4 Bitstring 3 * Reserved for IBM use
0007 7 Unsigned 1 INFHYGCT Count of reported hypervisors/
guests. This indicates how many
hypervisor/guest sections are in
the response buffer up to a
maximum of 3.
00000003 INF0YGMX 3 Maximum Hypervisor/Guest
sections
0008 8 Unsigned 2 INFHTOTL Total length of the response
buffer in bytes, including the
Header, Machine, Partition, and
Hypervisor and Guest sections.
000A 10 Unsigned 2 INFHDLN Length of Header Section in bytes
000C 12 Unsigned 2 INFMOFF Offset to Machine Section mapped
by INF0MAC
000E 14 Unsigned 2 INFMLEN Length of Machine Section in
bytes
0010 16 Unsigned 2 INFPOFF Offset to Partition Section
mapped by INF0PAR
0012 18 Unsigned 2 INFPLEN Length of Partition Section in
bytes
0014 20 Unsigned 8 INFHYGS1 Hypervisor/Guest Header 1
0014 20 Unsigned 2 INFHOFF1 Offset to Hypervisor Section 1,
mapped by INF0HYP
0016 22 Unsigned 2 INFHLEN1 Length of Hypervisor Section 1 in
bytes
0018 24 Unsigned 2 INFGOFF1 Offset to Guest Section 1 mapped
by INF0GST
001A 26 Unsigned 2 INFGLEN1 Length of Guest Section 1 in
bytes
001C 28 Unsigned 8 INFHYGS2 Hypervisor/Guest Header 2
001C 28 Unsigned 2 INFHOFF2 Offset to Hypervisor Section 2
mapped by INF0HYP
001E 30 Unsigned 2 INFHLEN2 Length of Hypervisor Section 2 in
bytes
0020 32 Unsigned 2 INFGOFF2 Offset to Guest Section 2 mapped
by INF0GST
0022 34 Unsigned 2 INFGLEN2 Length of Guest Section 2 in
bytes
0024 36 Unsigned 8 INFHYGS3 Hypervisor/Guest Header 3
0024 36 Unsigned 2 INFHOFF3 Offset to Hypervisor Section 3
mapped by INF0HYP
0026 38 Unsigned 2 INFHLEN3 Length of Hypervisor Section 3 in
bytes
0028 40 Unsigned 2 INFGOFF3 Offset to Guest Section 3 mapped
by INF0GST
002A 42 Unsigned 2 INFGLEN3 Length of Guest Section 3 in
bytes
002C 44 Bitstring 4 * Reserved for IBM use
00000030 INF0HDSZ *-INF0HDR Size of header in bytes
00000006 INF0HDSD (*-INF0HDR+7)/8 Size of Header in
doublewordsFunction Code X'0000' Response Hypervisor/Guest Entry (INF0HDYG DSECT)
+-------------+-------------+-------------+-------------+
0 | INFYOFF | INFYLEN | INFGOFF | INFGLEN |
+-------------+-------------+-------------+-------------+
8
Hex Dec Type/Val Lng Label (dup) Comments
---- ---- --------- ---- -------------- --------
0000 0 Structure INF0HDYG Mappings for STHYI
0000 0 Unsigned 2 INFYOFF Offset to Hypervisor Section
mapped by INF0HYP
0002 2 Unsigned 2 INFYLEN Length of Hypervisor Section in
bytes
0004 4 Unsigned 2 INFGOFF Offset to Guest Section mapped by
INF0GST
0006 6 Unsigned 2 INFGLEN Length of Guest Section in bytes
00000008 INF0HYSZ *-INF0HDYG Size of section
description in bytes
00000001 INF0HYSD (*-INF0HDYG+7)/8 Size of section
description in doublewords.Function Code X'0000' Response Machine Section (INF0MAC DSECT)
+------+------+------+------+-------------+-------------+
0 |:MFLG1|:MFLG2|:MVAL1|:MVAL2| INFMSCPS | INFMDCPS |
+------+------+------+------+-------------+-------------+
8 | INFMSIFL | INFMDIFL | INFMNAME- |
+-------------+-------------+---------------------------+
10 | -INFMNAME | INFMTYPE |
+---------------------------+---------------------------+
18 | INFMMANU |
| |
+-------------------------------------------------------+
28 | INFMSEQ |
| |
+---------------------------+---------------------------+
38 | INFMPMAN |///////////////////////////|
+---------------------------+---------------------------+
40 | INFMPLNM |
+-------------+------------+----------------------------+
48 | INFMSZIIP | INFMDZIIP |////////////////////////////|
+-------------+------------+----------------------------+
50
Hex Dec Type/Val Lng Label (dup) Comments
---- ---- --------- ---- -------------- --------
0000 0 Structure INF0MAC Mappings for STHYI
0000 0 Bitstring 1 INFMFLG1 Machine Flag Byte 1
1... .... INFMPOOL X'80' INFMPOOL Reserved for IBM
use.
0001 1 Bitstring 1 INFMFLG2 Machine Flag Byte 2 reserved for
IBM use
0002 2 Bitstring 1 INFMVAL1 Machine Validity Byte 1
1... .... INFMPROC X'80' INFMPROC Processor Count
Validity When this bit is on, it
indicates that INFMSCPS,
INFMDCPS, INFMSIFL, and INFMDIFL
contain valid counts. The
validity bit may be off when: -
STHYI support is not available on
a lower level hypervisor, or -
Global Performance Data is not
enabled.
.1.. .... INFMMID X'40' INFMMID Machine ID Validity
This bit being on indicates that
a SYSIB 1.1.1 was obtained from
STSI and information reported in
the following fields is valid:
INFMTYPE, INFMMANU, INFMSEQ, and
INFMPMAN.
..1. .... INFMMNAM X'20' INFMMNAM Machine Name
Validity This bit being on
indicates that the INFMNAME field
is valid.
...1 .... INFMPLNV X'10' INFMPLNV Reserved for IBM
use.
.... 1... INFMZIIPV X'08' INFMZIIPV Machine zIIP
reporting validity. When on, the
INFMSZIIP and INFMDZIIP fields
are valid.
0003 3 Bitstring 1 INFMVAL2 Machine Validity Byte 2 Reserved
for IBM use
0004 4 Unsigned 2 INFMSCPS Count of shared CPs configured in
the machine or in the physical
partition if the system is
physically partitioned. (Valid if
(INFMPROC)
0006 6 Unsigned 2 INFMDCPS Count of dedicated CPs configured
in the machine or in the physical
partition if the system is
physically partitioned. (Valid if
(INFMPROC)
0008 8 Unsigned 2 INFMSIFL Count of shared IFLs configured
in the machine or in the physical
partition if the system is
physically partitioned. (Valid if
(INFMPROC)
000A 10 Unsigned 2 INFMDIFL Count of dedicated IFLs
configured in the machine or in
the physical partition if the
system is physically partitioned.
(Valid if (INFMPROC)
000C 12 EBCDIC 8 INFMNAME Machine Name, in EBCDIC format.
This is the CPC name associated
with the processor. (Valid if
(INFMMNAM)
0014 20 EBCDIC 4 INFMTYPE Machine Type, in EBCDIC format.
This is the machine type reported
by STSI 1.1.1 (Basic Machine
Configuration). (Valid if
(INFMMID)
0018 24 EBCDIC 16 INFMMANU Machine Manufacturer, in EBCDIC
format. This is the name of the
manufacturer of the configuration
reported by STSI 1.1.1. (Valid if
(INFMMID)
0028 40 EBCDIC 16 INFMSEQ Sequence Code, in EBCDIC format.
This is the sequence code of the
configuration reported by STSI
1.1.1. (Valid if (INFMMID)
0038 56 EBCDIC 4 INFMPMAN Plant of Manufacture, in EBCDIC
format. This is the 4-byte code
reported by STSI 1.1.1. (Valid if
(INFMMID)
003C 60 Bitstring 4 * Reserved for IBM use
0040 64 EBCDIC 8 INFMPLNM Reserved for IBM use.
0048 72 Signed 2 INFMSZIIP Count of shared zIIPs configured
in the macine or in the physical
partition if the system is
physically partitioned. (Valid if
INFMZIIPV)
004A 74 Signed 2 INFMDZIIP Count of dedicated zIIPs
configured in the machine or in
the physical partition if the
system is physically partitioned.
(Valid if INFMZIIPV)
004C 76 Bitstring 4 * Reserved for IBM use
00000050 INF0MSIZ *-INF0MAC Size of Machine Section
in bytes
0000000A INF0MSZD (*-INF0MAC+7)/8 Size of Machine
Section in doublewordsFunction Code X'0000' Response Partition Section (INF0PAR DSECT)
+------+------+------+------+-------------+-------------+
0 |:PFLG1|:PFLG2|:PVAL1|:PVAL2| INFPPNUM | INFPSCPS |
+------+------+------+------+-------------+-------------+
8 | INFPDCPS | INFPSIFL | INFPDIFL |/////////////|
+-------------+-------------+-------------+-------------+
10 | INFPPNAM |
+---------------------------+---------------------------+
18 | INFPWBCP | INFPABCP |
+---------------------------+---------------------------+
20 | INFPWBIF | INFPABIF |
+---------------------------+---------------------------+
28 | INFPLGNM |
+---------------------------+---------------------------+
30 | INFPLGCP | INFPLGIF |
+---------------------------+---------------------------+
38 | INFPPLNM |
+-------------+-------------+---------------------------+
40 | INFPSZIIP | INFPDZIIP | INFPWBZIIP |
+-------------+-------------+---------------------------+
48 | INFPABZIIP | INFPLGZIIP |
+---------------------------+---------------------------+
50
Hex Dec Type/Val Lng Label (dup) Comments
---- ---- --------- ---- -------------- --------
0000 0 Structure INF0PAR Mappings for STHYI
0000 0 Bitstring 1 INFPFLG1 Partition Flag Byte 1
1... .... INFPMTEN X'80' INFPMTEN Multithreading
(MT) is enabled
.1.. .... INFPPOOL X'40' INFPPOOL Reserved for IBM
use.
0001 1 Bitstring 1 INFPFLG2 Partition Flag Byte 2 reserved
for IBM use.
0002 2 Bitstring 1 INFPVAL1 Partition Validity Byte 1
1... .... INFPPROC X'80' INFPPROC Processor Count
Validity This bit being on
indicates that INFPSCPS,
INFPDCPS, INFPSIFL, and INFPDIFL
contain valid counts. When
INFPZIIPV is on, INFPSZIIP and
INFPDZIIP contain valid counts.
.1.. .... INFPWBCC X'40' INFPWBCC Partition
weight-based capped capacity
validity. This bit being on
indicates that INFPWBCP and
INFPWBIF are valid. When
INFPZIIPV is also on, INFPWBZIIP
is valid.
..1. .... INFPACC X'20' INFPACC Partition absolute
capped capacity validity. This
bit being on indicates that
INFPABCP and INFPABIF are valid.
When INFPZIIPV is also on,
INFPABZIIP is valid.
...1 .... INFPPID X'10' INFPPID Partition ID
Validity. This bit being on
indicates that a SYSIB 2.2.2 was
obtained from STSI and
information reported in the
following fields is valid:
INFPPNUM, INFPPNAM
.... 1... INFPLGVL X'08' INFPLGVL LPAR Group
Absolute Capacity Capping
information validity This bit
being on indicates that INFPLGNM,
INFPLGCP and INFPLGIF are valid.
When INFPZIIPV is also on,
INFPLGZIIP is valid.
.... .1.. INFPPLNV X'04' INFPPLNV Reserved for IBM
use.
.... ..1. INFPZIIPV X'02' INFPZIIPV Partition zIIP
reporting validity. When on, INFPSZIIP
and INFPDZIIP are valid, and INFPWBZIIP,
INFPABZIIP and INFPLGZIIP may be valid
depending on additional validity bits.
0003 3 Bitstring 1 INFPVAL2 Partition Validity Byte 2
reserved for IBM use.
0004 4 Unsigned 2 INFPPNUM Logical Partition Number. This is
the Logical-Partition Number
reported by STSI 2.2.2. (Valid if
INFPPID)
0006 6 Unsigned 2 INFPSCPS Count of shared logical CP cores
configured for this partition.
(Valid if INFPPROC)
0008 8 Unsigned 2 INFPDCPS Count of dedicated logical CP
cores configured for this
partition. (Valid if INFPPROC)
000A 10 Unsigned 2 INFPSIFL Count of shared logical IFL cores
configured for this partition.
(Valid if INFPPROC)
000C 12 Unsigned 2 INFPDIFL Count of dedicated logical IFL
cores configured for this
partition. (Valid if INFPPROC)
000E 14 Bitstring 2 * Reserved for IBM use
0010 16 EBCDIC 8 INFPPNAM Logical Partition Name, in EBCDIC
format. This is the Logical-
Partition Name reported by STSI
2.2.2. (Valid if INFPPID)
0018 24 Unsigned 4 INFPWBCP Partition weight-based capped
capacity for CPs, a scaled number
where X'00010000' represents one
CPU. Cap is applicable only to
shared processors. Zero if not
capped. (Valid if INFPWBCC)
001C 28 Unsigned 4 INFPABCP Partition absolute capped
capacity for CPs, a scaled number
where X'00010000' represents one
core. Cap is applicable only to
shared processors. Zero if not
capped. (Valid if INFPACC)
0020 32 Unsigned 4 INFPWBIF Partition weight-based capped
capacity for IFLs, a scaled
number where X'00010000'
represents one core. Cap is
applicable only to shared
processors. Zero if not capped.
(Valid if INFPWBCC)
0024 36 Unsigned 4 INFPABIF Partition absolute capped
capacity for IFLs, a scaled
number where X'00010000'
represents one core. Cap is
applicable only to shared
processors. Zero if not capped.
(Valid if INFPACC)
0028 40 EBCDIC 8 INFPLGNM LPAR Group Name (Valid if
INFPLGVL) EBCDIC, padded on right
with blanks when in an LPAR group
and valid. Binary zeros
otherwise. Only reported when
there is a group cap on CP, IFL, or
zIIP CPU types and the partition has
the capped CPU type.
0030 48 Unsigned 4 INFPLGCP LPAR Group Absolute Capacity
Value for the CP CPU type when
nonzero. Nonzero only when
INFPLGNM is nonzero and a cap is
defined for this LPAR Group for
the CP CPU type. When nonzero,
contains a scaled number where
X'00010000' represents one core.
(Valid if INFPLGVL)
0034 52 Unsigned 4 INFPLGIF LPAR Group Absolute Capacity
Value for the IFL CPU type when
nonzero. Nonzero only when
INFPLGNM is nonzero and a cap is
defined for this LPAR Group for
the IFL CPU type. When nonzero,
contains a scaled number where
X'00010000' represents one core.
(Valid if INFPLGVL)
0038 56 EBCDIC 8 INFPPLNM Reserved for IBM use.
00000040 INF0PSIZ *-INF0PAR Size of Partition
Section in bytes
00000008 INF0PSZD (*-INF0PAR+7)/8 Size of Partition
Section in doublewords
0040 64 Signed 2 INFPSZIIP Count of shared logical zIIP
cores configured for this
partition. (Valid if INFPZIIPV)
0042 66 Signed 2 INFPDZIIP Count of dedicated logical zIIP
cores configured for this
partition. (Valid if INFPZIIPV)
0044 68 Signed 2 INFPWBZIIP Partition weight-based capped
capacity for zIIPs, a scaled
number where X'00010000'
represents one core. Cap is
applicable only to shared
processors. Zero if not capped.
(Valid if INFPWBCC & INFPZIIPV)
0048 72 Signed 4 INFPABZIIP Partition absolute capped
capacity for zIIPs, a scaled
number where X'00010000'
represents one core. Cap is
applicable only to shared
processors. Zero if not capped.
(Valid if INFPACC & INFPZIIPV)
004C 76 Signed 4 INFPLGZIIP LPAR Group Absolute Capacity
Value for the zIIP CPU type when
nonzero. Nonzero only when
INFPLGNM is nonzero and a cap is
defined for this LPAR Group for
the zIIP CPU type. When nonzero,
contains a scaled number where
X'00010000' represents one core.
(Valid if INFPLGVL & INFPZIIPV)
00000050 INF0PSIZ *-INF0PAR Size of Partition
Section in bytes
0000000A INF0PSZD (*-INF0PAR+7)/8 Size of Partition
Section in doublewords
Function Code X'0000' Response Hypervisor Section (INF0HYP DSECT)
+------+------+------+------+------+------+------+------+
0 |:YFLG1|:YFLG2|:YVAL1|:YVAL2|:YTYPE|//////|:YCPT |:YIFLT|
+------+------+------+------+------+------+------+------+
8 | INFYSYID |
+-------------------------------------------------------+
10 | INFYCLNM |
+-------------+-------------+-------------+-------------+
18 | INFYSCPS | INFYDCPS | INFYSIFL | INFYDIFL |
+------+------+------+------+------+------+------+------+
20 |:YINS0|:YINS1|:YINS2|:YINS3|:YINS4|:YINS5|:YINS6|:YINS7|
+------+------+------+------+------+------+------+------+
28 |:YAUT0|:YAUT1|:YAUT2|:YAUT3|:YAUT4|:YAUT5|:YAUT6|:YAUT7|
+------+------+------+------+------+------+------+------+
30 |:YZIIPT|/////| :YSZIIP |///////////////////////////|
+------+------+-------------+------+------+------+------+
38
Hex Dec Type/Val Lng Label (dup) Comments
---- ---- --------- ---- -------------- --------
0000 0 Structure INF0HYP Mappings for STHYI
0000 0 Bitstring 1 INFYFLG1 Hypervisor Flag Byte 1
1... .... INFYLMCN X'80' INFYLMCN Consumption method
is used to enforce Limithard
caps.
.1.. .... INFYLMPR X'40' INFYLMPR If on, Limithard
caps use prorated core time for
capping. If off, raw CPU time is
used.
..1. .... INFYMTEN X'20' INFYMTEN Hypervisor is
MT-enabled.
0001 1 Bitstring 1 INFYFLG2 Hypervisor Flag Byte 2 Reserved
for IBM use
0002 2 Bitstring 1 INFYVAL1 Hypervisor Validity Byte 1
1... .... INFYZIIPV X'80' INFYZIIPV Hypervisor zIIP
reporting validity. When on,
INFYSZIIP, INFYZIIPT fields are
valid.
0003 3 Bitstring 1 INFYVAL2 Hypervisor Validity Byte 2
Reserved for IBM use
0004 4 Unsigned 1 INFYTYPE Hypervisor type
00000001 INFYTVM X'01' INFYTVM z/VM is the
hypervisor
00000002 INFYTKVM X'02' INFYTKVM KVM is the
hypervisor
00000003 INFYTZCX X'03' INFYTZCX zCX is the
hypervisor
0005 5 Bitstring 1 * Reserved for IBM use
0006 6 Bitstring 1 INFYCPT Threads in use per CP core. This
value is reported for the current
configuration settings even when
the guest CPUs are not dispatched
on CPs. The value is set only
when SMT enabled as indicated by
INFYFLG1.INFYMTEN.
0007 7 Bitstring 1 INFYIFLT Threads in use per IFL core. This
value is reported for the current
configuration settings even when
the guest CPUs are not dispatched
on IFLs. The value is set only
when SMT enabled as indicated by
INFYFLG1.INFYMTEN.
0008 8 EBCDIC 8 INFYSYID System Identifier, in EBCDIC
format, left justified and padded
with blanks. This is the value
generally specified on the
SYSTEM_IDentifier statement in
the system configuration file.
Blank if non-existent.
0010 16 EBCDIC 8 INFYCLNM Cluster Name, in EBCDIC format,
left justified and padded with
blanks. This is the name on the
SSI statement in the system
configuration file. Blank if
non-existent.
0018 24 Unsigned 2 INFYSCPS Number of CP cores shared by
non-dedicated CP-dispatched
virtual CPUs of this hypervisor.
001A 26 Unsigned 2 INFYDCPS Reserved for IBM use
001C 28 Unsigned 2 INFYSIFL Number of IFL cores shared by
non-dedicated IFL-dispatched
virtual CPUs of this hypervisor.
001E 30 Unsigned 2 INFYDIFL Reserved for IBM use
0020 32 Bitstring 8 INFYINSF (0) Mask of installed function codes.
Bit position corresponding to the
function code number is on if the
function code is supported by
this hypervisor. Bits may be on
even if the guest is not
authorized.
0020 32 Bitstring 1 INFYINS0 Function codes 0-7.
1... .... INFYFCCP X'80' INFYFCCP FC=0 - Obtain CPU
Capacity Info.
.1.. .... INFYFHYP X'40' INFYFHYP FC=1 - Hypervisor
Environment Info
..1. .... INFYFGLS X'20' INFYFGLS FC=2 - Guest List
...1 .... INFYFGST X'10' INFYFGST FC=3 - Designated
Guest Info
.... 1... INFYFPLS X'08' INFYFPLS FC=4 - Resource
Pool List
.... .1.. INFYFPDS X'04' INFYFPDS FC=5 - Designated
Resource Pool Information
.... ..1. INFYFPML X'02' INFYFPML FC=6 - Resource
Pool Member List
0021 33 Bitstring 1 INFYINS1 Function codes 8-15.
0022 34 Bitstring 1 INFYINS2 Function codes 16-23.
0023 35 Bitstring 1 INFYINS3 Function codes 24-31.
0024 36 Bitstring 1 INFYINS4 Function codes 32-39.
0025 37 Bitstring 1 INFYINS5 Function codes 40-47.
0026 38 Bitstring 1 INFYINS6 Function codes 48-55.
0027 39 Bitstring 1 INFYINS7 Function codes 56-63.
0028 40 Bitstring 8 INFYAUTF (0) Mask of authorized function
codes. Bit position corresponding
to the function code number is on
if the function code is supported
by this hypervisor and the guest
has been authorized in the
directory.
0028 40 Bitstring 1 INFYAUT0 Function codes 0-7.
1... .... INFYFCCP X'80' INFYFCCP FC=0 - Obtain CPU
Capacity Info.
.1.. .... INFYFHYP X'40' INFYFHYP FC=1 - Hypervisor
Environment Info
..1. .... INFYFGLS X'20' INFYFGLS FC=2 - Guest List
...1 .... INFYFGST X'10' INFYFGST FC=3 - Designated
Guest Info
.... 1... INFYFPLS X'08' INFYFPLS FC=4 - Resource
Pool List
.... .1.. INFYFPDS X'04' INFYFPDS FC=5 - Designated
Resource Pool Information
.... ..1. INFYFPML X'02' INFYFPML FC=6 - Resource
Pool Member List
0029 41 Bitstring 1 INFYAUT1 Function codes 8-15.
002A 42 Bitstring 1 INFYAUT2 Function codes 16-23.
002B 43 Bitstring 1 INFYAUT3 Function codes 24-31.
002C 44 Bitstring 1 INFYAUT4 Function codes 32-39.
002D 45 Bitstring 1 INFYAUT5 Function codes 40-47.
002E 46 Bitstring 1 INFYAUT6 Function codes 48-55.
002F 47 Bitstring 1 INFYAUT7 Function codes 56-63.
0030 48 Bitstring 1 INFYZIIPT Threads in use per zIIP core.
This value is reported for the
current configuration settings
even when the guest CPUs are not
dispatched on zIIPs. The value is
set only when SMT enabled as
indicated by INFYFLG1.INFYMTEN.
(Valid if INFYZIIPV)
0031 49 Bitstring 1 * Reserved for IBM use.
0032 50 Signed 2 INFYSZIIP Number of zIIP cores shared by
non-dedicated zIIP-dispatched
virtual CPUs of this hypervisor.
(Valid if INFYZIIPV)
Note: zIIP virtual CPUs are never
dedicated.
0034 52 Signed 4 * Reserved for IBM use.
00000038 INF0YSIZ *-INF0HYP Size of Hypervisor
Section in bytes
00000007 INF0YSZD (*-INF0HYP+7)/8 Size of
Hypervisor Section in doublewords
Function Code X'0000' Response Guest Section (INF0GST DSECT)
All counts of CPs, IFLs, and zIIPs and capacity values
are based on quantities of cores when multithreading is
enabled. While virtual CPUs are thread dispatched
they have the potential of consuming an entire core.
Therefore virtual CP, IFL, and zIIP counts are counts of
virtual CPUs but treated as counts of cores.
+------+------+------+------+---------------------------+
0 |:GFLG1|:GFLG2|:GVAL1|:GVAL2| INFGUSID- |
+------+------+------+------+-------------+-------------+
8 | -INFGUSID | INFGSCPS | INFGDCPS |
+------+--------------------+-------------+-------------+
10 |:GCPDT|////////////////////| INFGCPCC |
+------+------+-------------+------+--------------------+
18 | INFGSIFL | INFGDIFL |:GIFDT|////////////////////|
+-------------+-------------+------+--------------------+
20 | INFGIFCC |:GPFLG|////////////////////|
+---------------------------+------+--------------------+
28 | INFGPNAM |
+---------------------------+---------------------------+
30 | INFGPCCC | INFGPICC |
+-------------+--------+----+---------------------------+
38 | INFGSZIIP |:GZIIPDT|////| INFGZIIPCC |
+-------------+--------+----+---------------------------+
40 | INFGPZCC |///////////////////////////|
+---------------------------+---------------------------+
38
Hex Dec Type/Val Lng Label (dup) Comments
---- ---- --------- ---- -------------- --------
0000 0 Structure INF0GST Mappings for STHYI
0000 0 Bitstring 1 INFGFLG1 Guest Flag Byte 1
1... .... INFGMOB X'80' INFGMOB Guest mobility is
enabled.
.1.. .... INFGMCPT X'40' INFGMCPT Guest has multiple
CPU types
..1. .... INFGCPLH X'20' INFGCPLH Guest CP dispatch
type has LIMITHARD cap.
...1 .... INFGIFLH X'10' INFGIFLH Guest IFL dispatch
type has LIMITHARD cap.
.... 1... INFGVCPT X'08' INFGVCPT Virtual CPs are
thread dispatched
.... .1.. INFGVIFT X'04' INFGVIFT Virtual IFLs are
thread dispatched
.... ..1. INFGZIIPH X'02' INFGZIIPH Guest zIIP
dispatch type has LIMITHARD cap
(Valid if INFGZIIPV).
.... ...1 INFGVZIIPT X'01' INFGVZIIPT Virtual zIIPs
are thread dispatched (Valid if
INFGZIIPV).
0001 1 Bitstring 1 INFGFLG2 Guest Flag Byte 2 Reserved for
IBM use
0002 2 Bitstring 1 INFGVAL1 Guest Validity Byte 1 Reserved
for IBM use
1... .... INFGZIIPV X'80' INFGZIIPV Guest zIIP
reporting validity. When on,
INFGSZIIP, INFGZIIPDT,
INFGZIIPCC, INFGPZCC fields, and
INFGZIIPH, INFGVZIIPT, INFGPZLH,
and INFGPZPC flags are valid.
0003 3 Bitstring 1 INFGVAL2 Guest Validity Byte 2 Reserved
for IBM use
0004 4 EBCDIC 8 INFGUSID Guest's userid, in EBCDIC format
000C 12 Unsigned 2 INFGSCPS Number of guest shared CPs
000E 14 Unsigned 2 INFGDCPS Reserved for IBM use
0010 16 Unsigned 1 INFGCPDT Dispatch type for guest CPs This
field is valid if INFGSCPS or
INFGDCPS is greater than zero.
Always INGGPUCCP.
00000000 INFGPUCCP X'00' INFGPUCCP General Purpose
(CP)
00000003 INFGPUCIFL X'03' INFGPUCIFL Integrated Fac
for Linux (IFL).
00000005 INFGPUCZIP X'05' INFGPUCZIP zSeries
Integrated Information Processor
(zIIP).
000000FF INFGPUCZCP X'FF' INFGPUCZCP May be
dispatched on zIIP and CP
Processors due to spillover.
0011 17 Bitstring 3 * Reserved for IBM use
0014 20 Unsigned 4 INFGCPCC Guest current capped capacity for
CP-dispatched, shared vCPUs, a
scaled number where X'00010000'
represents one core. Zero if not
capped.
0018 24 Unsigned 2 INFGSIFL Number of guest shared IFLs
001A 26 Unsigned 2 INFGDIFL Reserved for IBM use
001C 28 Unsigned 1 INFGIFDT Dispatch type for guest IFLs.
This field is valid if INFGSIFL
or INFGDIFL is greater than zero.
May be INFGPUCIFL or INFGPUCCP.
00000000 INFGPUCCP X'00' INFGPUCCP General Purpose
(CP)
00000003 INFGPUCIFL X'03' INFGPUCIFL Integrated Fac
for Linux (IFL).
00000005 INFGPUCZIP X'05' INFGPUCZIP zSeries
Integrated Information Processor
(zIIP).
000000FF INFGPUCZCP X'FF' INFGPUCZCP May be
dispatched on zIIP and CP
Processors due to spillover.
001D 29 Bitstring 3 * Reserved for IBM use
0020 32 Unsigned 4 INFGIFCC Guest current capped capacity for
IFL-dispatched, shared vCPUs, a
scaled number where X'00010000'
represents one core. Zero if not
capped.
0024 36 Bitstring 1 INFGPFLG Resource Pool Capping Flags
1... .... INFGPCLH X'80' INFGPCLH Resource Pool's CP
virtual type has LIMITHARD cap.
.1.. .... INFGPCPC X'40' INFGPCPC Resource Pool's CP
virtual type has CAPACITY cap.
..1. .... INFGPILH X'20' INFGPILH Resource Pool's
IFL virtual type has LIMITHARD
cap.
...1 .... INFGPIFC X'10' INFGPIFC Resource Pool's
IFL virtual type has CAPACITY
cap.
.... 1... INFPRCTM X'08' INFPRCTM Resource Pool uses
prorated core time.
.... .1.. INFGPZLH X'04' INFGPZLH Resource Pool's
zIIP virtual type has LIMITHARD
cap. (Valid if INFGZIIPV)
.... ..1. INFGPZPC X'02' INFGPZPC Resource Pool's
zIIP virtual type has CAPACITY
cap. (Valid if INFGZIIPV)
0025 37 Bitstring 3 * Reserved for IBM use
0028 40 EBCDIC 8 INFGPNAM Resource pool name. Blanks if not
Resource Pool.
0030 48 Unsigned 4 INFGPCCC Resource pool capped capacity for
shared virtual CPs, a scaled
number where X'00010000'
represents one core if capped.
Zero if not capped.
0034 52 Unsigned 4 INFGPICC Resource pool capped capacity for
shared virtual IFLs, a scaled
number where X'00010000'
represents one core if capped.
Zero if not capped.
0038 56 Signed 2 INFGSZIIP Number of guest shared zIIPs.
(Valid if INFGZIIPV)
Note: zIIP virtual CPUs are never
dedicated.
003A 58 Signed 1 INFGZIIPDT Dispatch type for guest zIIPs.
This field is set when INFGSZIIP
> 0. May be INFGPUCZIIP,
INFGPUCCP or INFGPUCZCP. (Valid
if INFGZIIPV)
00000000 INFGPUCCP X'00' INFGPUCCP General Purpose
(CP)
00000003 INFGPUCIFL X'03' INFGPUCIFL Integrated Fac
for Linux (IFL).
00000005 INFGPUCZIP X'05' INFGPUCZIP zSeries
Integrated Information Processor
(zIIP).
000000FF INFGPUCZCP X'FF' INFGPUCZCP May be
dispatched on zIIP and CP
Processors due to spillover.
003B 59 Bitstring 1 * Reserved for IBM use.
003C 60 Signed 4 INFGZIIPCC Guest current capped capacity for
zIIP-dispatched, shared vCPUs, a
scaled number where X'00010000'
represents one core. Zero if not
capped. (Valid if INFGZIIPV)
0040 64 Signed 4 INFGPZCC Resource pool capped capacity for
shared virtual zIIPs, a scaled
number where X'00010000'
represents one core if capped.
Zero if not capped. (Valid if
INFGZIIPV)
0044 68 Signed 4 * Reserved for IBM use.
00000048 INF0GSIZ *-INF0GST Size of Guest Section
in bytes
00000009 INF0GSZD (*-INF0GST+7)/8 Size of Guest
Section in doublewords