Summary of Changes for z/VM: CP Commands and Utilities Reference

This information includes terminology, maintenance, and editorial changes. Technical changes or additions to the text and illustrations for the current edition are indicated by vertical lines and angle brackets (|<  >|) surrounding the change.

This publication is updated and published with greater frequency than user assistance (online help) is updated and delivered. If user assistance contains information that does not match the information in this publication, the publication contains the latest information.

SC24-6268-73, z/VM 7.3 (September 2025)

This edition includes changes to support product changes that are provided or announced after the general availability of z/VM 7.3.

[7.3 VM66878] Enhanced QDIO virtual switch vNIC simulation

With the PTF for APAR VM66878 (CP), z/VM 7.3 provides guests with the ability to define simulated enhanced QDIO (EQDIO) network interface cards (vNICs) on the virtual switch. With this support, a guest has the option to establish and activate a network connection in either traditional QDIO or EQDIO mode. QDIO mode requires three devices to activate a network connection but EQDIO mode requires only a single device.

[7.3 VM66850] Transactional execution disablement

With the PTF for APAR VM66850 (CP), z/VM 7.3 provides support for transactional execution disablement. This support introduces a way to test application migration and detect usage of the transactional-execution facilities with z/VM 7.3, thus preparing z/VM 7.3 users for the eventual reduction and removal of support for these facilities.

The following commands are new:
The following command is updated:

Miscellaneous updates for September 2025

The following topic is updated:

SC24-6268-73, z/VM 7.3 (July 2025)

This edition includes changes to support product changes that are provided or announced after the general availability of z/VM 7.3.

The following topic is updated:

SC24-6268-73, z/VM 7.3 (June 2025)

This edition includes changes to support product changes that are provided or announced after the general availability of z/VM 7.3.

[7.3 VM66823] z/VM support for the IBM z17 family

With the PTFs for APARs VM66823 and Start of changeVM66853End of change (7.3 CP) and Start of changeVM66857End of change (7.3 RACF), z/VM 7.3 provides support for the IBM® z17® family. For more information, see z/VM support for the IBM z17 family in the z/VM: Migration Guide.

The following topic is added:

SC24-6268-73, z/VM 7.3 (July 2024)

This edition includes changes to support product changes that are provided or announced after the general availability of z/VM 7.3.

[VM66746] QUERY DASD DETAILS command is updated to allow I/O to be issued for a user when QUICKDSP is set on

With the PTF for APAR VM66746, the QUERY DASD DETAILS command is updated to allow I/O to be issued for a user when QUICKDSP is set on. Previously, information about the fenced state and host access would not be displayed in the Q DASD DETAILS output. A usage note and a response that indicates the previous restrictions are removed from documentation of the QUERY DASD command.

[VM66749] Relax SCSI alternate path restrictions

With the PTF for APAR VM66749, the uniqueness requirement for the DEVICE fcp_vdev operand of the LOADDEV user directory statement and the SET LOADDEV and SET DUMPDEV commands is relaxed. Previously, the device number was required to be unique from any device numbers that were specified in any ALTERNATE path definitions. When the PTF is applied, the combination of device number and port name must be unique from those specified in any ALTERNATE path definitions.

The following CP commands are updated

[VM66742] VSwitch recovery logic is updated to eliminate endless recovery attempts

With the PTF for APAR VM66742, the VSwitch recovery logic is updated. When a device reset and re-initialization of a VSwitch Uplink Port does not clean up an error condition after multiple attempts, the VSwitch recovery logic now stops its device recovery attempts and issues message HCP3233E.

The documentation for the QUERY VSWITCH command is updated:
  • "VSWITCH CONNECT Required" is added to the list of error conditions for the Uplink and Bridge Port devices.
  • New message HCP3233E is added to the list of messages.

SC24-6268-73, z/VM 7.3 (June 2024)

This edition includes terminology, maintenance, and editorial changes.

Miscellaneous updates for June 2024

Casing of the WARNING operand and response is corrected in the following commands:

SC24-6268-73, z/VM 7.3 (April 2024)

This edition includes changes to support product changes that are provided or announced after the general availability of z/VM 7.3.

[VM66758, VM66759] SCP identification enhancements

With the PTF for APAR VM66758, the z/VM Control Program (CP) can display identification information that is provided by guest operating systems. The CP display is similar to the HMC Systems Management "Partitions" display. SCP identification enhancements provide a means to determine what operating system a guest is running and also what guest operating systems have identified themselves since the z/VM system last IPLed.

The following CP command is new:
The following CP command is updated:

With the PTF for APAR VM66759, z/VM's Control Monitor System (CMS) is enhanced. A user can change the CMS system identification information that a guest sends to the hypervisor.

The following CMS command is new:
  • SET SCPID (See SET SCPID in z/VM: CMS Commands and Utilities Reference.)

SC24-6268-73, z/VM 7.3 (March 2024)

This edition includes changes to support product changes that are provided or announced after the general availability of z/VM 7.3.

Miscellaneous updates for March 2024

Documentation of the following command is updated:
  • VARY (Real Device): A usage note is updated to indicate the following behavior:

    Any duplicate device number that is encountered on a VARY ON command is skipped and no error message is issued. However, the duplicates are included in the summary message in the "device(s) specified" count.

SC24-6268-73, z/VM 7.3 (December 2023)

This edition includes changes to support product changes that are provided or announced after the general availability of z/VM 7.3.

[VM66726] MONWRITE CLOSE Enhancements

With the PTF for APAR VM66726, the z/VM 7.3 MONWRITE command can specify the file mode for the monitor files it produces when the CLOSE option is specified. Previously, the command could specify the mode of the monitor file or the CLOSE option but not both.

The following CP command is updated:

[VM66727] FCP SCSI List-directed IPL alternate paths

With the PTF for APAR VM66727, z/VM 7.3 provides the ability to specify alternate paths for list-directed SCSI IPL. If IPL fails for the primary device path, alternate device paths are used automatically. The new ALTERNATE operand of the SET DUMPDEV and SET LOADDEV commands and the LOADDEV directory statement can specify up to three alternate device paths. The responses to the QUERY DUMPDEV and QUERY LOADDEV commands indicate the alternate device paths.

The following CP commands are updated:
The responses to the following CP commands are updated:

SC24-6268-73, z/VM 7.3 (September 2023)

This edition includes changes to support product changes that are provided or announced after the general availability of z/VM 7.3.

[VM66678, VM66709] Warning Track Interruption Facility

With the PTFs for APARs VM66678 (CP) and VM66709 (Performance Toolkit), z/VM 7.3 exploits a feature of Processor Resource/Systems Manager (PR/SM) called the warning-track-interruption facility. z/VM's exploitation of this facility helps improve guest response time and overall performance of workloads that are run on vertical-low or vertical-medium logical processors.

The following CP commands are updated:

[VM66673] Information update about Large Guest Reset Time Mitigation

In support of APAR VM66673, the descriptions of the following commands are updated to explain how multiple instances of large-memory resets are shown in responses to each command:

[VM66683] Channel Path Usage

In support of APAR VM66683, a clarification about channel path usage is added to the description of this CP command:

SC24-6268-73, z/VM 7.3 (May 2023)

This edition includes changes to support product changes that are provided or announced after the general availability of z/VM 7.3.

[VM66423] Crypto Stateless-Command Filtering

With the PTF for APAR VM66423, z/VM 7.3 provides support for a capability of the Crypto Express8S adapter, when configured in Common Cryptographic Architecture (CCA) coprocessor mode, to enforce restrictions on classes of requests. This support is intended to be used to limit operations on shared crypto resources, such as prohibiting secure-key functions. z/VM’s exploitation of this hardware capability will replace the crypto stateless command filtering performed by z/VM for APVIRT crypto users, thus eliminating the need for future z/VM updates to allow stateless CCA operations beyond those currently supported. The z/VM hypervisor specifies the policy, and the Crypto Express8S adapter enforces it. Crypto Stateless-Command Filtering requires an IBM z16® family server with driver D51C Bundle S19 applied.

The following CP message is updated:
  • HCP1711I

[VM66423] Removal of obsolete IOCP Parameters DYN and NODYN

With the PTF for APAR VM66423, the IOCP parameters DYN and NODYN, which previously allowed or prevented dynamic changes to I/O configurations, no longer have any effect.

The following topics are updated:

[VM66424, VM66434, VM66650] Guest Secure IPL Support

With the PTF for APARs VM66424, VM66434, and VM66650, z/VM V7.3 supports guest secure IPL (load and dump) for both ECKD and SCSI devices. A z/VM user can request that the machine loader validate the signed IPL code by using the security keys that were previously loaded by the customer into the HMC certificate store. The validation ensures that the IPL code is intact, unaltered, and originates from a trusted build-time source.

Support is provided for the following guest operating systems:
  • This support provides the ability for a Linux® guest to exploit hardware to validate the code being booted, helping to ensure it is signed by the client or its supplier.

    Linux on IBM zSystems instances that previously were able to perform secure boot first level on an IBM z15® or IBM LinuxONE III prior to Driver D41C Bundle S73a, or an IBM z16 or IBM LinuxONE 4 prior to Driver D51C Bundle S18, will no longer be able to use secure boot until appropriate additional support is applied to the Linux image. Details are available about the required service level of Linux to properly IPL securely first or second level after driver D41C Bundle S73a or Driver D51C Bundle S18 has been applied. See 230428 Machine Alert for 8561, 8562, 3931, 3932.

  • z/OS® is supported in audit mode only. Full exploitation requires Virtual Flash Memory support, which is not available to a guest. In audit mode, the IPL code is checked but the IPL continues even if the code is not valid.

z/VM and the z/VM stand-alone dump utility do not support performing host IPL via List-Directed IPL (LD-IPL) from ECKD. In addition, Secure IPL of the z/VM host and z/VM stand-alone dump are not supported.

[VM66654] Thin Stack Adapter Interrupt Support

With the PTF for APAR VM66654, z/VM 7.3 enhances the Thin Stack FCP SCSI device driver and associated I/O abstraction layers to exploit adapter interruptions and to implement improved error handling and reporting.

The following utility is updated:

[VM66673] Large Guest Reset Time Mitigation

With the PTF for APAR VM66673, z/VM 7.3 provides support for up to 2TB virtual memory within a single virtual machine under a set of restrictions while also providing a mitigation for long logoff times of guests with a large amount of instantiated virtual memory.

The following commands are updated:

[VM66675] Enable larger (>64GB) NVMe paging allocation extents

With the PTF for APAR VM66675, z/VM 7.3 allows paging space to be allocated anywhere on an NVMe EDEVICE and to be of any size up to the available capacity. This PTF also adds the ability for the CPFMTXA utility to accept FBA allocations specified in factors of megabytes, gigabytes, and terabytes.

See CPFMTXA.

This support requires the corresponding ICKDSF PTF for APAR PH52513, which removes the 64G restriction for PAGE allocation on an FBA volume.

[VM66677] Increase crashkernel area size

With the PTF for APAR VM66677, z/VM 7.3 increases the size of crashkernel area allocated by stand-alone dump programs in preparation for a future enhancement.

The following CP utility is updated:

Miscellaneous updates for May 2023

The following commands are updated:
  • QUERY MONITOR: New response for next sample date and time.
  • LOCATE VMDBK: New operand ** to locate all VMDBKs on the system.

SC24-6268-73, z/VM 7.3 (September 2022)

This edition supports the general availability of z/VM 7.3. Note that the publication number suffix (-73) indicates the z/VM release to which this edition applies.

Eight-member SSI support

This support increases the maximum size of a single system image (SSI) cluster from four members to eight, enabling clients to grow their SSI clusters to allow for increased workloads and providing more flexibility to use live guest relocation (LGR) for nondisruptive upgrades and workload balancing.

The following CP commands are updated:
The following CP utility is new:
The following CP utility is updated:

NVMe emulated device (EDEVICE) support

NVMe devices that are connected through PCI Express (PCIe) adapters can be defined and managed as Fixed-Block Architecture (FBA) EDEVICEs. As such, all host and guest FBA functions are supported except for those functions that require stand-alone support such as warm start and checkpoint. Linux guests that exploit EDEVICEs that are defined on NVMe adapters are not eligible for live guest relocation. NVMe adapters are only available on IBM LinuxONE servers. For more information, see Defining and Managing NVMe Devices.

Documentation is updated for the following commands:
The following command is new:

Display mnemonics for instructions that are not supported by CP Trace

z/VM 7.3 displays mnemonics for instructions in CP TRACE output regardless of whether the instruction is fully supported by z/VM. The following topics are updated:

Miscellaneous updates for z/VM 7.3

Documentation for the following CP commands is updated:
The following CP utilities are updated: