OA62744: NEW FUNCTION: z/OS BCP enhancements for Wazi as a Service and ZVDT

Obtain the fix for this APAR.

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 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
  

Fix information

• Fixed component name

  SUPERVISOR CONT

• Fixed component ID

  5752SC1C5

Applicable component levels

• R7D0 PSY UJ09010

     UP22/08/24 P F208  

• R7C0 PSY UJ09009

     UP22/08/24 P F208  

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.