A fix is available
APAR status
Closed as new function.
Error description
NEW FUNCTION
Local fix
N/A
Problem summary
**************************************************************** * USERS AFFECTED: * * Users of HBB77C0 and above * **************************************************************** * PROBLEM DESCRIPTION: * * New Function: z/OS BCP enhancements for Wazi as a Service * * and ZVDT. * **************************************************************** * RECOMMENDATION: * **************************************************************** New Function: z/OS BCP enhancements for Wazi as a Service and ZVDT. Keyword ALTZHYP/K
Problem conclusion
Temporary fix
Comments
New Function: z/OS BCP enhancements for Wazi as a Service and ZVDT. Documentation Information: z/OS MVS Interactive Problem Control System (IPCS) Commands (SA23-1382) IPCS Subcommands Status IPCS STATUS SYSTEM subcommand now displays virtual machine information when it is available, including Control program ID (CPID), UUID, name and extended name. Example 1 adds this to the end VM Information: 7 VM CPID: zHYPaaS VM UUID: 72DF625E-AD77-4A6C-865D-B9718A67898F VM NAME: k8s_4094 VM EXT NAME: k8s_4094bc65b1bb4196b016f4651f0788bc_02u7... Note 7 is added: Virtual machine information is displayed when the dump was produced from a system where z/OS was running under a virtual machine and the data is available in the dump, as follows. The data is provided by the hypervisor via the STSI instruction. See the documentation provided by the hypervisor, if and when available, for details about the data values. VM CPID The 16-character control program identifier. For example: VM CPID: zHYPaaS If the value is not available in the dump, the display line shows: VM CPID IS NOT AVAILABLE VM UUID The universally unique identification (UUID) for the virtual machine, in the 8-4-4-4-12 format. For example: VM UUID: 72DF625E-AD77-4A6C-865D-B9718A67898F If the value is not available in the dump, the display line shows: VM UUID IS NOT AVAILABLE If the value is set to zeros, the display line shows: VM UUID IS NOT PROVIDED VM NAME The 8-character virtual machine name. For example: VM NAME: k8s_4094 If the value is not available in the dump, the display line shows: VM NAME IS NOT AVAILABLE VM EXT NAME The extended virtual machine name. When available, the name can be 1 256 characters long. If necessary, the characters will flow to the next line of the display. Example 1: VM EXT NAME: k8s_4094bc65b1bb4196b016f4651f0788bc_02u7 Example 2: VM EXT NAME: k8s_4094bc65b1bb4196b016f4651f0788bc_02u7_72... -b9718a67898f If the value is not available in the dump, the display line shows: VM EXT NAME IS NOT AVAILABLE If the value is set to zeros, the display line shows: VM EXT NAME IS NOT PROVIDED If the extended virtual machine name is not EBCDIC-encoded, the display line shows: VM EXT NAME IS NOT EBCDIC ENCODED z/OS MVS System Messages, Vol 7 (IEB-IEE) (SA38-0674) IEE254I Display IPLINFO output text in message IEE254I now displays virtual machine information when it is available, including control program ID (CPID), UUID, name and extended name. vminfo When z/OS is running in a virtual machine, vminfo is displayed, as follows. The data is provided by the hypervisor via the STSI instruction. See the documentation provided by the hypervisor, if and when available, for details about the data values. VM CPID = vmcpid VM UUID = vmuuid | VM UUID IS NOT PROVIDED VM NAME = vmname VM EXT NAME = vmextname | VM EXT NAME IS NOT PROVIDED | VM EXT NAME IS NOT EBCDIC ENCODED where: vmcpid The 16-character control program identifier. For example: VM CPID = zHYPaaS vmuuid The universally unique identifier (UUID) for the virtual machine, in the 8-4-4-4-12 format. For example: VM UUID = 72DF625E-AD77-4A6C-865D-B9718A67898F If the value is not provided, the display line shows: VM UUID IS NOT PROVIDED vmname The 8-character virtual machine name. For example: VM NAME = k8s_4094 vmextname The extended virtual machine name. When available, the name can be from 1-256 characters long. If necessary, the characters will flow to the next line of the display. Example 1: VM EXT NAME = k8s_4094bc65b1bb4196b016f4651f0788bc_02u7 Example 2: VM EXT NAME = k8s_4094bc65b1bb4196b016f4651f0788bc_02u7... -b9718a67898f If the value is not provided, the display line shows: VM EXT NAME IS NOT PROVIDED If the extended virtual machine name is not EBCDIC-encoded, the display line shows: VM EXT NAME IS NOT EBCDIC ENCODED z/OS MVS System Codes (SA38-0665) Wait state codes 07C New reason code 0A The system was IPLed from an unsupported virtual machine environment. System action: The system enters a non-restartable wait state. Operator response: Notify the system programmer. System programmer response: IPL the system from a supported virtual machine. Search problem reporting databases for a fix for the problem. If not fix exists, contact the IBM Support Center. z/OS MVS System Commands (SA38-0666) MVS system commands reference DISPLAY command Displaying IPL information (IPLINFO) If z/OS is running in a virtual machine, information about the virtual machine is now displayed. z/OS MVS Programming: Assembler Services Guide (SA23-1368) The hardware runtime environment New chapter: The hardware runtime environment The following topics describe the hardware environments in which z/OS can run and how programs can determine the hardware environment in which they are running. - Hardware environments that z/OS supports - How to determine the hardware environment Hardware environments that z/OS supports IBM z/OS can run in a logical partition (LPAR) on IBM Z hardware, in a virtual machine (VM) environment hosted by a hypervisor, or in an environment that emulates IBM Z hardware. - A hypervisor is a hosting control program. The operating system (OS) that the hypervisor is hosting in a virtual machine is known as a guest operating system (or simply guest). The virtual machine simulates the functionality of a real hardware environment. The real hardware resources that the hypervisor presents to its guests can be dedicated to a single virtual machine or shared among multiple virtual machines. Examples of hypervisors are the tier-1 hypervisor, Processor Resource/System Manager (PR/SM), that is built into the IBM Z hardware and creates and manages logical partition (LPAR) virtual machines, and the tier-2 hypervisor, IBM z/VM, which can host many virtual machines. Like many IBM Z operating systems, z/VM itself runs in an LPAR. - An emulator allows an operating system that is designed to run on one machine architecture to run on another. The IBM System z Personal Development Tool (zPDT) is an emulator that provides a means to run an IBM Z operating system on a machine with x86 architecture. Programs that run on z/OS might need to know about the hardware environment on which they are running for a variety of reasons, such as: - Performance will likely be degraded when not running in an LPAR environment, causing longer delays for resources. Thus, longer response times might be expected. - Some software might not be licensed to run in certain environments. - Some environments might provide enhanced or limited functionality that can only be determined from the host's documentation. For instance, z/VM provides enhanced functionality for the DIAGNOSE instruction. z/OS supports the following hardware environments: - LPAR under PR/SM - Virtual machine under IBM z/VM - An alternate virtual machine environment, such as: - Virtual server instance (VSI) under IBM Z Hypervisor as a Service (zHYPaaS) - IBM Virtual Dev and Test for z/OS (ZVDT) - An emulated hardware environment, such as: - IBM zPDT emulator - IBM Z Development and Test (ZD&T) environment (which is based on zPDT) How to determine the hardware environment z/OS provides the following programming interfaces to determine the hardware environment in which a program is running: The following Communication Vector Table (CVT data area) fields: - CVTVMEnv The CVTVMEnv bit within the CVTFLGBT byte indicates running in a virtual machine environment hosted by a tier-2 hypervisor (such as z/VM or zHYPaaS), which is further identified by the CVT fields that follow. This bit applies to any tier-2 hypervisor environment. This bit is available starting with z/OS 2.4 and 2.5, with appropriate service. - CVTUNDzVM The CVTUNDzVM bit within the CVTFLGBT byte indicates running in a virtual machine hosted by z/VM. This bit is available starting with z/OS 2.4 and 2.5, with appropriate service. An alternate name for this bit, CVTUNDVM, is available on all releases. - CVTUNDAltVM The CVTUNDAltVM bit within the CVTFLGBT byte indicates running in a virtual machine hosted by an alternate tier-2 hypervisor (that is, other than z/VM), such as zHYPaaS or IBM ZVDT. You can determine the specific hypervisor by examining the control program identifier in the SI22V3DBCPIdentifier field, which is returned by the CSRSI service and mapped by CSRSIIDF. The actual host program identifier is provided by the hypervisor documentation. This bit is available starting with z/OS 2.4 and 2.5, with appropriate service. - CVTzPDT The CVTzPDT bit indicates an environment based on the zPDT emulator, such as an IBM zPDT or ZD&T environment. This bit is available starting with z/OS 2.5. Prior to z/OS 2.5, you can check for a machine type value of 1090 in the SI11V1CPCType field returned by the CSRSI service. Table 1 summarizes the CVT bit settings for each of the supported hardware runtime environments listed in Hardware environments that z/OS supports. Table 1. Summary of supported hardware runtime environments and CVT bit settings Hardware enviroment CVTVMENV CVTUNDzVM CVTUNDAltVM CVTzPDT CVTUNDVM LPAR off off off off IBM z/VM virtual on on off off machine Virtual server instance on off on off (VSI) under zHYPaaS or IBM ZVDT IBM zPDT emulator or off off off on IBM ZD&T Notes: 1 The CVTVMENV, CVTUNDzVM, and CVTUNDAltVM bits are available starting with z/OS 2.4 and 2.5, with appropriate service. 2 The CVTzPDT bit is available starting with z/OS 2.5. Prior to z/OS 2.5, see the description of the CVTzPDT bit stated earlier. The CSRSI (Return System Information) service allows unauthorized programs to obtain STSI (Store System Information machine instruction) information, such as the CPU ID (SI00PCCACPID). If z/OS is a guest of a control program, the CSRSI service also returns information about the virtual machine environment, if provided by the control program, such as: - Control program identifier (SI22V3DBCPIdentifier) - Virtual machine name (SI22V3DBVMName or SI22V3ExtVMName) - Universally-unique identification (UUID) of the virtual machine (SI22V3DBUUID) The PCCACPID field in the Physical Configuration Communication Area (PCCA), mapped by the IHAPCCA macro, contains the first 6 bytes of the STIDP (Store CPU ID machine instruction) information translated to EBCDIC. Referencing this field should only be done when running authorized and disabled for external and I/O interrupts; instead, you can use the SI00PCCACPID value provided by the CSRSI service. Note: Starting with z/OS 2.4 with appropriate service, you should not need to reference this field, as the preferred method to determine the hardware environment is to examine the CVT fields that z/OS provides, as previously described. However, for completeness, the following guidance is provided about the STIDP information. The Environment field (bits 0 - 7) of the STIDP information can contain the following values: X'FF' Indicates a z/VM environment and will never indicate any other type of virtual machine environment. Refer to the CVTUNDzVM field described earlier. X'FD' Indicates an alternate virtual machine environment other than z/VM. Refer to the CVTUNDAltVM field described earlier to determine which one is the host. X'C1' or X'D3' Indicates running in a zPDT environment. Refer to the CVTzPDT field described earlier. X'00' Indicates running in an LPAR under PR/SM. z/OS MVS Data Areas Volume 1 (ABE - IAR) CSRSIIDF information CSRSIIDF mapping Table 12. Structure SI22V2 Offset Dec, Offset Hex, Type, Len, Name(Dim), Description New and replaced rows 76, (4C), CHARACTER, 3, , Reserved 79, (4F), BITSTRING, 1, SI22V2VSNameEncoding, an 8-bit unsigned integer indicating whether virtual-server information is provided in fields SI22V2VSName and SI22V2VSUUID, and if so, the encoding of the virtual-server-name field, SI22V2VSName, as follows: Value, Meaning, Equate; 0, Virtual-server information is not provided, SI22_ExtNameNotProvided; 1, EBCDIC, SI22_ExtNameEbcdic; 2, UTF-8, SI22_ExtNameUTF8; 3-255, Reserved, -- 80, (50), BITSTRING, 16, SI22V2VSUUID, When virtual-server information is provided, contains a 128- bit binary universally-unique identification (UUID, also known as a handle) of the virtual server for this configuration. Set to zeros when virtual-server information is not provided. 96, (60), CHARACTER, 160, , Reserved 256, (100), CHARACTER, 256, SI22V2VSName, When virtual-server information is provided, contain a 256-byte name of the virtual server for this configuration. The virtual-server name is left justified in the field. If the name is less than 256 bytes, the field is padded on the right with zeros. SI22V2VSNameEncoding indicates the encoding of the virtual-server-name field. When virtual-server information is not provided, SI22V2VSName is reserved and may be stored as zeros or may remain unchanged. Table 13. Structure SI22V3 Offset Dec, Offset Hex, Type, Len, Name(Dim), Description New and replaced rows 544, (220), CHARACTER, 1504, , Reserved 2048, (800), CHARACTER, 2048, SI22V3ExtVMNames, Array of 256-byte extended virtual machine names. For each provided SI22V3DBE, there is a corresponding SI22V3ExtVMName. The SI22V3DBExtVmNameEncoding field of a SI22V3DB indicates the encoding of the corresponding extended VM name. When SI22V3DBExtVmNameEncoding is zero, the corresponding extended-VM name field is stored as zeros. 2048, (800), CHARACTER, 256, SI22V3ExtVMName, An individual extended-VM-name entry corresponding to the SI22V3DBE. Left justified and padded to the right with zeros. If the leftmost byte contains zeros, no extended VM name is provided regardless of the corresponding SI22V3DBExtVmNameEncoding value. Table 14. Structure SI22V3DB Offset Dec, Offset Hex, Type, Len, Name(Dim), Description New and replaced rows 40, (28), CHARACTER, 3, , Reserved 43, (2B), BITSTRING, 1, SI22V3DBExtVmNameEncoding, Extended Virtual Machine Name Encoding -- an 8-bit unsigned integer indicating whether a corresponding SI22V3ExtVMName is provided, and if so, the encoding of the SI22V3ExtVMName as follows: Value, Meaning, Equate; 0, Virtual-server information is not provided, SI22_ExtNameNotProvided; 1, EBCDIC, SI22_ExtNameEbcdic; 2, UTF-8, SI22_ExtNameUTF8; 3-255, Reserved, --; When zero, an extended virtual machine name is not provided for this configuration. 44, (2C), CHARACTER, 4, , Reserved 48, (30), CHARACTER, 16, SI22V3DBUUID , Universally-Unique Identification (UUID): When not zero, comprises a UUID of the virtual machine configuration. When zero, no UUID was provided. CVT information CVT programming interface information - new fields CVTUNDzVM CVTUNDAltVM CVTVMENV CVT mapping Table 4. Structure CVTXTNT2 Offset Dec, Offset Hex, Type, Len, Name(Dim), Description replace CVTFLGBT descriptions 5, (5), BITSTRING, 1, CVTFLGBT, Flag byte. This byte is an interface only for bits CVTUNDzVM (CVTUNDVM), CVTUNDAltVM & CVTVMENV ... , , , ...1 ...., CVTUNDZVM, "X'10'" - Running under z/VM (this is not the same as running under VICOM) Bit is set to 0 when CVTUNDAltVM is 1. , , , ...1 ...., CVTUNDVM, "X'10'" - Same as CVTUNDzVM ... , , , .... ..1., CVTUNDAltVM, "X'02'" - Running under an alternate virtual machine environment. To determine which alternate virtual machine, the STSI output will list the control program identifier in field SI22V3DBCPIdentifier mapped by CSRSIIDF and can be obtained by the CSRSI service. Bit is set to 0 when CVTUNDzVM is 1 , , , .... ...1, CVTVMENV, "X'01'" - Running as a virtual machine environment. Bit is set to 1 when CVTUNDzVM or CVTUNDAltVM is set to 1 ECVT information Update ECVTVMNM description z/VM user id of the virtual machine, of which this z/OS image is a guest. This field is blanks if the processor is not a guest under z/VM (such as running under PR/SM or an alternate VM). z/OS MVS Data Areas Volume 3 (ITK - RQE) PCCA information Update PCCACPID description CPU ID (CONTAINS SERIAL NUMBER). Contains the first 6 bytes of the STIDP (STORE CPU ID) instruction results translated to EBCDIC. While it was common to check the first two bytes of PCCACPID to determine if z/OS is running under VM, it is recommended to check CVT bits instead: CVTUNDzVM (CVTUNDVM) for z/VM, CVTUNDAltVM for an alternate virtual machine such as IBM Wazi as a Service, or CVTVMENV for a system running under any virtual environment. Keyword ALTZHYP/K
APAR Information
APAR number
OA62744
Reported component name
SUPERVISOR CONT
Reported component ID
5752SC1C5
Reported release
7C0
Status
CLOSED UR1
PE
NoPE
HIPER
NoHIPER
Special Attention
YesSpecatt / New Function / Xsystem
Submitted date
2022-02-04
Closed date
2022-08-08
Last modified date
2023-11-07
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UJ09009 UJ09010 OA64286
Modules/Macros
IEAVNIP0 IEEVCHPR IEAIPL02 IEEUSTCK IEAVTSDI IEAVSETS IEE6603D IHAPCCA ISNDWTOR IEAVESPN IEAVNP20 CVT IEEXSA CSRSIIDF ISNTRACE BLWRIM IEAVTDSC IHAFACL IOSVICLA IEECB985 IHAECVT BLSRST01
SA23138200 | SA38067400 | SA38066500 | SA38066600 | SA23136800 |
GA32093500 | GA32093700 |
Fix information
Fixed component name
SUPERVISOR CONT
Fixed component ID
5752SC1C5
Applicable component levels
Fix is available
Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.
[{"Business Unit":{"code":"BU011","label":"Systems - zSystems software"},"Product":{"code":"SG19O"},"Platform":[{"code":"PF054","label":"z Systems"}],"Version":"7C0"}]
Document Information
Modified date:
07 November 2023