IBM United States
Software Announcement 201-286
October 4, 2001
IBM z/VM V4R2 Extends Core Technology Support for the IBM zSeries
(Corrected on October 31, 2001)
RACF V1R10.0 APAR number has been corrected, under Software Requirements section, Optional Product/Feature Requirements, third major bullet.
(Corrected on October 11, 2001)
Prices have been fixed for z/VM Subscription and Support (5739-SWS).
At a Glance
This new release, z/VM V4R2, includes:
For ordering, contact:
Your IBM representative, an IBM Business Partner, or IBM Americas Call Centers at 800-IBM-CALL (Reference: ME001).
Using virtualization technology as a foundation, z/VM Version 4 Release 2 (V4R2) offers new function and technology that exploits IBM Virtual Machine (VM) capabilities on the mainframe. Virtualization technology allows customers to virtualize processor, communications, storage, and I/O resources which may reduce the overhead of planning, purchasing, and installing new hardware to support new workloads.
z/VM V4 offers an ideal platform for consolidating Linux workloads on a single IBM zSeries 900 (z900) or S/390® server, enabling you to run hundreds of Linux guest images. Priced on a per-engine basis, z/VM V4 supports IBM Integrated Facility for Linux (IFL) processor features for Linux-based workloads and standard engines for all other z900 and S/390 workloads. When corresponding function is available with Linux on zSeries, z/VM V4R2 is designed to provide the capability for Linux guest virtual machines to use clear-key RSA functions of the IBM PCI Cryptographic Coprocessor (PCICC) or the IBM PCI Cryptographic Accelerator (PCICA) for Secure Socket Layer (SSL) acceleration on the zSeries 900 and S/390 servers. Additional guest-support improvements that will benefit Linux virtual machine performance include DASD fast Channel Command Word (CCW) translation when data resides above 2 GB, and enhanced page-fault handling, when corresponding function is available with Linux on zSeries, allowing a Linux guest to continue processing while the page faults are handled by z/VM. z/VM V4R2 offers some ease-of-use functions to manage Linux images and a migration facility to help existing customers of the Virtual Image Facility move their configuration files and data to a z/VM V4R2 system.
z/VM V4R2 extends its hardware support by exploiting technological enhancements for the z900 server, such as:
Connectivity enhancements to TCP/IP for z/VM, Level 420 are designed to include a new Internet Message Access Protocol (IMAP) server, improved security of the TCP/IP stack by preventing some Denial of Service (DOS) attacks, and support for HiperSockets. A "Guest LAN" capability is designed to allow a VM guest to install a virtual HiperSockets adapter and connect it with other virtual network adapters on the same VM host system to form an emulated LAN segment.
For the most current information on z/VM, refer to the z/VM Web site at:
VM Guest RSA-Assist Support for Linux: With the PTF for APAR VM62905 and when corresponding function is available from Linux for zSeries, Linux guest virtual machines can exploit the IBM PCI Cryptographic Coprocessor (PCICC) and the IBM PCI Cryptographic Accelerator (PCICA). This support provides clear-key RSA support for a considerably large number of Linux guests enabling hardware Secure Socket Layer (SSL) acceleration on the IBM zSeries 900 and S/390 servers. This new support for Linux virtual machines does not change VM's current guest support of the IBM CMOS Cryptographic Coprocessor. The CMOS Cryptographic support is intended for use with OS/390® or z/OS guests and limits the number of guests using cryptography to 16. A VM system may include Linux guests using the RSA-Assist support simultaneously with other VM guests using the CMOS Cryptographic support.
Fast Channel Command Word (CCW) Translation Extensions: To help improve the performance of I/O to network devices, the Control Program (CP) provided a fast CCW translator in z/VM V4R1 to translate a wide range of channel programs that perform I/O to network adapters. This fast translator for network devices included support for 64-bit indirect data address words (IDAWs), which allows guest machines to read and write data above the 2 GB limit using 64-bit I/O addressing.
In z/VM Version 4 Release 2 (V4R2), 64-bit IDAW support was further extended to the existing DASD fast CCW translator. This enhancement is also designed to include 64-bit IDAW support for DASD channel programs that are simulated via the minidisk cache (MDC).
Support for HiperSockets: z/VM V4R2 is designed to support the new z/Architecture HiperSockets function for high-speed TCP/IP communication among virtual machines and logical partitions within the same zSeries 900 (z900). The HiperSockets function uses an adaptation of the Queued-Direct I/O (QDIO) high-speed I/O protocol previously introduced with zSeries OSA-Express Gigabit-Ethernet support. The HiperSockets function allows virtual machines and/or logical partitions to communicate internally over the memory bus using the new internal-queued-direct (IQD) channel type in the z900.
Up to four IQD channels can be configured within a z900. Each IQD channel represents the ability for isolated communications among the logical partitions and virtual machines using a given channel. That is, it is designed so that there is no communication between different IQD channels, thereby providing communication security among separate groups of logical partitions and virtual machines connected to different IQD channels.
The z900 provides up to 1024 HiperSockets connections through which HiperSockets communication can be used, divided at your discretion among the four IQD channels.
z/VM supports HiperSockets for use by guest operating systems and the TCP/IP for z/VM server virtual machine. Thus, VM programs using TCP/IP can communicate via HiperSockets with other VM programs using TCP/IP and with guest operating systems and other logical partitions using TCP/IP.
z/VM support for HiperSockets requires a combination of a zSeries 900 at EC Level J10607 or J10608, z/VM V4R2, and enabling PTFs corresponding to APARs VM62938 and PQ51738, which are expected to be available by year end 2001. For the most current information on the z/VM support for HiperSockets, refer to the z/VM Web site at:
For customers who plan to run z/OS as a guest of z/VM V4R2, refer to Software Announcement 201-248 , dated September 18, 2001, for z/OS support for HiperSockets.
The OSA-Express Token Ring feature supports QDIO, a highly efficient data transfer architecture that breaks the barriers associated with the Channel Control Word (CCW) architecture. QDIO support requires z/VM V4R2. Refer to Hardware Announcement 101-308 , dated October 4, 2001, for more details.
The OSA-Express Token Ring feature continues to support non-QDIO environments, the traditional TCP/IP (LAN Channel Station LCS) and SNA (Link Services Architecture LSA) traffic. VM/ESA® V2R3, or later, is required.
z/VM V4R2 is designed to support this new OSA-Express function for use by guest operating systems and by the TCP/IP for z/VM server virtual machine.
Guest Coupling Duplexing: The z/VM guest coupling facility is enhanced and is designed to support the new duplexing capabilities of the zSeries Coupling Facility. Thus, if you have guest z/OS systems in a virtual Parallel Sysplex today, you can add duplexed Coupling Facilities to that environment and take advantage of the latest Parallel Sysplex functions in the virtual environment. You can thereby maintain currency with Parallel Sysplex functions while gaining the benefits of virtualization for pre-production testing of z/OS configurations, new release migration, operator education, and so on.
FICON Channel-to-Channel Adapter (CTCA) Guest Support: With the PTF for APAR VM62906, z/VM V4R2 will provide guest support for FICON Channel-to-Channel communications between the zSeries 900 and S/390 Parallel Enterprise Server Generation 5 and 6. This will enable more reliable and higher bandwidth host-to-host communication than is available with ESCON® channels.
Move from Model-Group Pricing to Engine-Based Pricing: The engine-based pricing introduced in z/VM V4R1 and continued with z/VM V4R2 may make it financially more attractive to add VM workload incrementally to an existing zSeries 900 or S/390 server. Engine-based pricing means customers will pay a one-time charge (OTC) for each processor engine. This can be for standard processor engines or Integrated Facility for Linux (IFL) processor features.
For additional information on the z/VM support for the IFL, refer to Software Announcement 201-163 , dated May 29, 2001.
z/VM V4R2 includes the engine-based priced, optional features of RealTime
Monitor (RTM) FL410, Performance Reporting Facility (PRF) FL410, and
Directory Maintenance Facility (DirMaint) FL410. These features have not
been updated for z/VM V4R2 and are at the same functional level as when
they were introduced in z/VM V4R1. However, the PTF for APAR number
VM62908 has been installed to DirMaint so it will function properly on
VM Guest-LAN Support: In addition to supporting the HiperSockets function on IQD channels, z/VM V4R2 is also designed to support the HiperSockets function on "guest LANs" that VM provides for interconnection of virtual machines. That is, VM simulates the HiperSockets function for communication among virtual machines without the need for IQD channels, much as VM simulates channel-to-channel adapters for communication among virtual machines without the need for ESCON, FICON, or other channel-to-channel connections.
Guest-LAN support enhances the HiperSockets function by providing an essentially unlimited number of isolated guest LANs (rather than the limit of four IQD channels). Each such guest LAN can be used by a group of virtual machines to communicate among themselves, independent of other groups of virtual machines on other guest LANs. "System" guest LANs can be defined to which individual users can be linked. In addition, guest LANs can be defined to be associated with a specific user and with other users allowed access as required. There is no limit to the number of virtual devices that can be "connected" to a guest LAN. The guest connecting to a guest LAN must have HiperSockets support which could be z/OS V1R2, z/VM V4R2, or Linux for zSeries.
An additional benefit of guest-LAN support for communication among virtual machines is that VM can better control the locking of virtual pages in memory when data is transferred between virtual machines.
Another advantage of guest-LAN capability is that customers with S/390 servers can gain the benefits of HiperSockets communication among the virtual machines within a VM image, since no real IQD channels are required.
TCP/IP Internet Message Access Protocol (IMAP) Server: The new TCP/IP IMAP Server included with TCP/IP for z/VM, Level 420 provides support for an IMAP Version 4 Revision 1 (IMAP4rev1) mail server that runs on z/VM. This support allows you to utilize the strengths of z/VM (reliability, availability, and security) for storing and serving electronic mail while allowing any IMAP4rev1 client to access and manipulate mail messages using the IMAP protocol that is defined by RFC 2060. The messages are kept in the z/VM IMAP Mailstore (residing in an SFS filepool), but can be accessed remotely by client e-mail programs as if they were local. For example, e-mail stored on the z/VM IMAP server can be manipulated from a desktop computer at home, a workstation at the office, or a laptop computer while away on business without the need to transfer messages back and forth.
Easier Management of Linux Images: The new System Administration Facility tools are intended for use on a non-tailored z/VM system. These tools are based on some of the ease-of-use functions that are part of the S/390 Virtual Image Facility for Linux. These functions help you create and manage multiple Linux images on a single z/VM platform. You will be able to allocate resources among multiple Linux servers running on z/VM. z/VM will manage the assignment of portions of hardware to each individual Linux image. A client program that runs under both Linux and CMS is used to send system management commands to the System Administration Facility server. These commands create Linux images, assign disk partitions, query, start and stop Linux images, and perform other control functions.
In addition to these ease-of-use functions, the migration facility (VIFMIGR) can be used to move existing Virtual Image Facility configurations and data to a z/VM V4R2 system.
z/VM V4 is not a replacement product for the Virtual Image Facility (5739-A01), but z/VM V4R2 does offer similar function found in the Virtual Image Facility product, in addition to extensive capabilities not available with the Virtual Image Facility.
OBSERVER support in z/VM V4R2 allows the output of one virtual
machine's console to be observed by another. This enables application
monitoring, user assistance, systems management automation, and other
functions. OBSERVER support may be particularly useful in an environment
where multiple Linux guests are running under z/VM.
Converging VM C Socket Libraries
There are inconsistencies and incompatibilities among the numerous socket APIs on z/VM. A new C sockets library has been created within the Language Environment (LE) for MVS and VM which is designed to provide:
New Ordering Process
The z/VM V4 System Delivery Offering (SDO), program number 5739-A04, is the IBM program offering for z/VM that includes a single deliverable containing z/VM V4R2 and a group of fully serviced IBM licensed program products. The z/VM SDO is the only method that can be used to order z/VM V4R2 and ordering capability is planned for October 4, 2001.
The z/VM SDO package contains:
The key benefit of the z/VM SDO is the ability to dynamically update the SDO with new program products (versions and releases), with service when available, or deleting withdrawn products. This capability makes the SDO a more effective solution for the z/VM V4 customer.
For a complete list of products available and serviced with the z/VM V4R2 SDO or for more information on the z/VM SDO, refer to the z/VM Web site at:
Solution Financing for zSeries 900 or S/390 from IBM Global Financing
Moving your company to the world of e-business presents significant opportunities, but with real challenges that include sourcing, integrating new applications, and establishing better ways to serve your customers. Today's highly competitive environment often requires creative financial solutions to execute timely IT projects that are essential to your future.
IBM Global Financing (IGF) can help you perform a successful and cost-effective transition to the e-business marketplace by making your zSeries 900 or S/390 solution more affordable.
A Financing Solution with Important Benefits
Finance Some or All of your Linux Solutions
For help in designing the correct financing approach for your Linux and zSeries 900 or S/390 solution, contact your IGF representative or visit the IGF Web site at:
Accessibility by People with Disabilities
The following features support use by people with disabilities:
This program is EuroReady.
For more information on the implications of the euro, visit the IBM euro Web site at:
IBM considers an IBM product to be EuroReady if the product, when used in accordance with its associated documentation, is capable of correctly processing monetary data in the euro denomination and of respecting the euro currency formatting conventions (including the euro sign). This assumes that all other products (for example, hardware, software, and firmware) that are used with this product are also EuroReady. IBM hardware products that are EuroReady may or may not have an engraved euro sign key on their keyboards.
Currently, EuroReady status applies primarily to IBM products specific to the EMU countries. Products that are not specific to these countries are deemed to be "not ready" for euro unless otherwise stated in the product's country-specific specifications.
IBM Hardware Ready
IBM supplies certain IBM products which include third-party software (pre-loaded or not) and/or third-party attached hardware. In these instances, IBM is not in a position to assert that these third-party products are, in themselves, EuroReady.
Therefore, such IBM products will be designated as hardware ready.
IBM considers a solution to be EuroReady when the solution providers have:
and can clearly demonstrate this by:
The euro capabilities of a EuroReady solution will be clearly identified as features of the solution specification, as described in the contracts document.
z/VM V4 is the follow-on product for VM/ESA and z/VM V3R1. It provides additional support and exploitation opportunities for the thousands of customers who have built enterprise-wide automation and infrastructure enhancements on the VM platform in support of their applications, database systems, and e-business solutions. It also provides the capability to run Linux on the IFL processor feature.
z/VM V4 is intended to address the following customer situations:
For information on the zSeries 900, refer to:
For information on IFL engines on the S/390 Multiprise 3000, refer to:
For z/VM capabilities, refer to:
For information on the most current product information on RTM and PRF, refer to:
The course, VM Basics for Linux (ZV050), is available from IBM Learning Services. For information on this course or other VM education, check with your local IBM Learning Services contact or call IBM Learning Services at 800-IBM-TEACH (426-8322) for catalogs, schedules, and enrollments. To request information via fax, call 800-IBM-4FAX (426-4329) and request document number 0007. You may also visit the IBM Learning Services Web site at:
Select zSeries 900 and S/390®, then z/VM and VM/ESA®.
For educational resources available for z/VM V4 or VM/ESA, visit the z/VM Web site at:
Product information is available through Offering Information (OITOOL) at:
Unlicensed documentation within the z/VM V4 library are available in Adobe PDF files, BookManager® files, or printed books. They have been defined as either "Basic" or "Optional."
The Publications Center is a worldwide central repository for IBM product publications and marketing material with a catalog of 70,000 items. Extensive search facilities are provided, as well as payment options via credit card. Furthermore, a large number of publications are available online in various file formats, which can currently be downloaded free of charge.
The Publication Notification System (PNS) is available by order number/product number. Customers currently subscribing to PNS will automatically receive notifications by e-mail. Customers who wish to subscribe, can visit the PNS Web site at:
Note that PNS subscribers most often order their publications via the Publications Center.
All publications updated for z/VM V4R2 are available as PDF files, which may be printed.
Adobe PDF Files: Publications that are available in PDF format are provided on the IBM Online Library Omnibus Edition: VM Collection CD-ROM (supplied with z/VM V4R2 at no additional charge) and on the IBM VM Internet Library at:
Publications are also available from the Publications Center Web site at:
You can view a PDF file using the Adobe Acrobat Reader, which is available free from the Adobe Web site at:
You can also print the entire publication or just the section in which you are interested.
BookManager Files: Publications that are available in BookManager format are provided on the IBM Online Library Omnibus Edition: VM Collection CD-ROM (supplied with z/VM V4R2 at no additional charge). BookManager files are also available from the IBM VM Internet Library at:
Publications are also available from the Publications Center Web site at:
The BookManager files can be read by either BookManager READ for VM (a separately orderable product) or IBM Softcopy Reader (supplied on the CD-ROM).
One copy of the basic z/VM V4R2 printed publications, and one copy of z/VM V4R2 Online publications on CD-ROM are supplied automatically with the basic machine-readable material.
Basic z/VM V4R2 New Editions
Order Format Title Number PDF BKM Print z/VM: Installation Guide GC24-5992 X X z/VM: General Information GC24-5991 X X X z/VM: Planning and Administration SC24-5995 X X X z/VM: Service Guide GC24-5993 X X X z/VM: System Messages and Codes - CP GC24-6030 X X X z/VM: System Messages and Codes - CMS GC24-6031 X X X z/VM: System Messages and Codes - GC24-6032 X X X Other Components z/VM: TCP/IP Level 420 Planning SC24-6019 X X X and Customization BKM = BookManager
Optional z/VM V4R2 Base New Editions
Updated or new for z/VM V4R2.
Order Format Title Number PDF BKM Print z/VM: CMS Callable Services Reference SC24-6004 X X z/VM: CMS Command and Utility SC24-6010 X X Reference z/VM: CP Command and Utility SC24-6008 X X Reference z/VM: CP Programming Services SC24-6001 X X z/VM: Diagnosis Guide GC24-6039 X X z/VM: Group Control System SC24-5998 X X z/VM: Language Environment(R) 1.8 C SC24-6038 X X Run-Time Library Reference z/VM: Migration Guide GC24-5996 X X z/VM: OpenExtensions Callable SC24-6007 X X Services Reference z/VM: OpenExtensions Command SC24-6006 X X Reference z/VM: Performance SC24-5999 X X z/VM: Quick Reference SC24-6011 X X z/VM: REXX/VM Reference SC24-6035 X X z/VM: Running Guest Operating Systems SC24-5997 X X z/VM: System Administration Facility SC24-6034 X X z/VM: TCP/IP Level 420 Diagnosis GC24-6023 X X Guide z/VM: TCP/IP Level 420 GC24-6022 X X Messages and Codes z/VM: TCP/IP Level 420 SC24-6021 X X Programmer's Reference z/VM: TCP/IP Level 420 User's Guide SC24-6020 X X z/VM: Virtual Machine Operation SC24-6036 X X z/VM: VMSES/E Introduction and GC24-5994 X X Reference
Optional z/VM V4R2 Base Not New Editions
Not updated for z/VM V4R2.
Order Format Title Number PDF BKM Print z/VM: CMS Application Development SC24-6002 X X Guide z/VM: CMS Application Development SC24-6003 X X Guide for Assembler z/VM: CMS Application Multitasking SC24-5961 X X z/VM: CMS File Pool Planning, SC24-5949 X X Administration, and Operation z/VM: CMS Macros and Functions SC24-6005 X X Reference z/VM: CMS User's Guide SC24-6009 X X z/VM: CMS Pipelines User's Guide SC24-5970 X X z/VM: CMS Pipelines Reference SC24-5971 X X z/VM: CP Exit Customization SC24-5953 X X z/VM: Dump Viewing Facility GC24-5966 X X z/VM: Enterprise Systems SC24-5965 X X Architecture/Extended Configuration Principles of Operation z/VM: OpenExtensions Advanced SC24-5979 X X Application Programming Tools z/VM: OpenExtensions POSIX GC24-5976 X X Conformance Document z/VM: OpenExtensions User's Guide SC24-5977 X X z/VM: Program Management Binder and SC24-5934 X X Loader for CMS z/VM: Reusable Server Kernel SC24-5964 X X Programmer's Guide and Reference z/VM: REXX/VM User's Guide SC24-5962 X X z/VM: System Operation SC24-6000 X X z/VM: VM Dump Tool SC24-5887 X X z/VM: XEDIT Command and Macro SC24-5973 X X Reference z/VM: XEDIT User's Guide SC24-5972 X X Debug Tool User's Guide and Reference SC09-2137 X X OS/390(R): DFSMS Program Management SC27-0806 X X X Language Environment for OS/390 and GC28-1945 X X X VM: Concepts Guide Language Environment for OS/390 and SC28-1942 X X X VM: Debugging Guide and Run-Time Messages Language Environment for OS/390 and SC28-1944 X X X VM: Migration Guide Language Environment for OS/390 and SC28-1939 X X X VM: Programming Guide Language Environment for OS/390 and SC28-1940 X X X VM: Programming Reference Language Environment for OS/390 and SC28-1943 X X X VM: Writing Interlanguage Communication Applications CMS/TSO Pipelines: Author's Edition SL26-0018 X X VM/ESA: CMS Primer SC24-5458 X X VM/ESA: Connectivity Planning, SC24-5756 X X Administration, and Operation VM/ESA: CPI Communications User's SC24-5595 X X Guide VM/ESA: DFSMS/VM(R) Function Level SC26-4704 X X 221 Installation and Customization VM/ESA: DFSMS/VM Function Level 221 SC26-4707 X X Messages and Codes VM/ESA: DFSMS/VM Function Level 221 GC35-0121 X X Planning Guide VM/ESA: DFSMS/VM Function Level 221 SC35-0141 X X Removable Media Services User's Guide and Reference Order Format Title Number PDF BKM Print VM/ESA: DFSMS/VM Function Level 221 SH35-0111 X X Storage Administration Guide and Reference VM/ESA: Open Systems Adapter Support SC28-1992 X X Facility User's Guide S/390: Open Systems Adapter-Express SA22-7403 X X X Customer's Guide and Reference zSeries 900: Planning for Open GA22-7477 X X Systems Adapter-2 Feature zSeries 900: Open Systems SA22-7476 X X Adapter-Express Customer's Guide and Reference VM/ESA: Programmer's Guide to the SC24-5455 X X Server-Requester Programming Interface for VM VM/ESA: REXX/VM Primer SC24-5598 X X Common Programming Interface SC26-4399 X X Communications Reference Common Programming Interface Resource SC31-6821 X X Recovery Reference External Security Interface GC28-1366 X X (RACROUTE) Macro Reference for MVS(TM) and VM Planning for the System/390(R) Open GC23-3870 X X X Systems Adapter Feature
Optional RealTime Monitor Feature New Editions
Updated for z/VM V4R2.
Order Format Title Number PDF BKM Print z/VM: RealTime Monitor FL410 SC24-6028 X X
Note: An "X" in one of the columns indicates available formats.
Optional Performance Reporting Facility Feature New Editions
Updated for z/VM V4R2.
Order Format Title Number PDF BKM Print z/VM: Performance Reporting SC24-6027 X X Facility FL410
Optional Directory Maintenance Facility Feature New Editions
Updated for z/VM V4R2.
Order Format Title Number PDF BKM Print z/VM: Directory Maintenance Facility SC24-6024 X X FL410 Tailoring and Administration Guide z/VM: Directory Maintenance Facility SC24-6025 X X FL410 Command Reference z/VM: Directory Maintenance Facility SC24-6026 X X FL410 Messages
Optional Licensed Not New Editions
Not updated for z/VM V4R2.
Order Format Title Number PDF BKM Print VM/ESA: DFSMS/VM Function Level 221 LY27-9589 X Diagnosis Guide
Note: An "X" in one of the columns indicates available formats.
IBM Redbooks are developed and published by the IBM International Technical Support Organization (ITSO). They are intended to develop and deliver skills, technical know-how, and materials to technical professionals of IBM, Business Partners, and customers.
Displayable Softcopy Publications
All unlicensed online books are also available on CD-ROM, SK2T-2067, the IBM Online Library Omnibus Edition: VM Collection. The VM Collection also contains libraries for approximately 60 products that run on z/VM V4R2. This will be available in the United States and Canada at the general availability of z/VM V4R2 and 30 days after general availability in other countries. For a list of kit contents, contact your IBM Business Partner or IBM representative.
One copy of the CD-ROM Collection Kit will be shipped automatically with the product at no additional charge. To order additional copies, order feature number 7221.
Feature Order Number Number CD-ROM Collection Kit 7221 SK2T-2067
The online books can be used with the BookManager READ licensed programs in any of the READ-supported environments. Online books CD-ROMs contains a program, Softcopy Receiver Tool, for transferring BookManager files to the workstation or host.
Terms and conditions for use of the machine-readable files are shipped with the files.
Source File Publications: z/VM V4R2 manuals are not offered in source file form.
Licensed Publications: Licensed documentation available for z/VM V4R2 is the DFSMS/VM Function Level 221 Diagnosis Guide (LY27-9589). This publication has not been updated for z/VM V4R2 and is only available in printed format. It is not available on the IBM Online Library Omnibus Edition: VM Collection CD-ROM and must be ordered separately for a fee from the IBM Publications Center:
Specified Operating Environment
z/VM V4R2 will operate on:
Specific processor facilities required by z/VM V4R2 can be found on the z/VM Web site at:
Refer to the appendix of the General Information manual for more information.
The TCP/IP for z/VM V4R2 requires one of the following:
VM Guest RSA-Assist Support for Linux Hardware Requirements: In order for the VM Guest RSA-Assist Support for Linux to operate, corresponding exploitation by Linux for zSeries and one of the following is required:
The prerequisite no-charge products, EREP and ICKDSF , are preinstalled on the base product System DDRs. Therefore, when ordering the z/VM V4R2 you must already be licensed for these products or a separate order must be placed for each of these products to establish a license.
OSA and Open Systems Adapter/Support Facility (OSA/SF) Program Requirements: OSA/SF for z/VM V4R2 is provided with and supported on z/VM V4R2. OSA/SF for z/VM V4R2 can be accessed by a CMS user ID, by a REXX call to OSA/SF API, and at the OSA/SF Windows® 95, Windows NT®, or OS/2® GUI.
To use the OSA/SF GUI, one of the following is required:
Access at the OSA/SF GUI requires one of the following communications protocols:
OSA/SF V2R2 is included in the OSA/SF feature for z/VM V4R2. To support an OSA in its TCP/IP Passthru mode in a z/VM V4R2 environment, OSA/SF requires the TCP/IP for z/VM V4R2. OSA/SF support is required in this mode only if access to one of the OSA's ports is being shared by more than one host program or if an ATM OSA-2 is being used as a LAN emulation client (LEC).
For additional information on OSA/SF, refer to Software Announcement 299-041 , dated February 22, 1999.
Linux Program Requirements: Linux for S/390 or Linux for zSeries is not provided with the z/VM V4R2. Linux must be obtained from distributors. For the VM Guest RSA-Assist support for Linux and 64-bit page fault handling to work as designed on z/VM V4, corresponding exploitation by Linux for zSeries is required. The support in Linux for zSeries is planned to be available in a future distribution of Linux for zSeries. For availability and for the most current information on Linux distributors, refer to:
The PTFs for the APARs listed have been applied as service to these products within the SDO, unless otherwise noted.
When IFL processor features are purchased, only Linux workloads running as guests of z/VM V4R2 can operate on these features.
System performance depends on the hardware resources allocated to
z/VM V4R2 and on the level of activity within each Linux image. For
assistance in understanding the performance implications for a particular
situation, contact your IBM representative or your IBM Business Partner.
If you desire the level of service expected with S/390 and z/VM program products, you are strongly encouraged to order the program number for z/VM S&S. This program number provides enhanced support which includes telephone assistance (voice support for defects during normal business hours) and access to updates, releases, and versions of the program for as long as support is in effect. z/VM S&S will be automatically added to your order. If you do not desire the S&S license for z/VM and/or the optional features of RTM, PRF, or DirMaint, you must take specific action to decline this support.
To host Linux guests of z/VM V4R2, you must also obtain the Linux for zSeries or Linux for S/390 code from one of the distributors that have a marketing relationship with IBM. These distributions can be found at:
Licensed Products Packaged with z/VM V4R2: With the availability of z/VM V4R2, the following priced, optional products or features are automatically shipped preinstalled on the z/VM V4R2 base product DDRs:
These products must be enabled to use. If you choose to enable them, you must have a license for the product or the feature.
If you do not have a license for RSCS and TSM, you may establish one by placing an order for the product and using the delivery option "ship publications only" (#3471). This delivery option will prevent unnecessary shipment of the media while allowing for shipment of the basic publications for the products, including the program directories.
If you do not have a license for RTM, PRF, or DirMaint, you may establish one by placing an order for the z/VM V4R2 features and using the delivery option "ship publications only" (#3471). This delivery option will prevent unnecessary shipment of the media while allowing for shipment of the basic publications for the products, including the program directories.
The program directories include instructions for enabling use of the products. Prior to installation, you should review the Software Vendor Product and IBM Licensed Product matrices to ensure you have the correct levels of products.
Running 370-Mode Applications: To simplify the migration of older applications and facilitate the running of 370-mode only CMS applications in non 370-mode virtual machines, such as XA- or XC-mode, IBM provides the 370 Accommodation function. This function originally shipped with VM/ESA V1R2.1 (available July 1993) has since been enhanced as the result of customer experience and input. 370 Accommodation handles the vast majority of inconsistencies between 370 mode and either XA or XC mode, eliminating the need to change these applications to exploit the new architectures.
z/VM V4 only supports XA-, ESA-, and XC-mode virtual machines. z/VM Version 4 no longer supports 370-mode virtual machines. 370-mode virtual machines are converted to XA mode during logon processing. The 370 Accommodation function is still supported for applications.
The CMS Migration Utility Feature, provided with VM/ESA V2R3, is not available with z/VM V4. Customers who find their applications cannot run under the current level of CMS should use the 370 Accommodation function or modify their applications, if possible. If problems persist, customers should call IBM Service for assistance.
Direct Customer Support: Direct customer support is provided by IBM Operational Support Services Support Line. This fee service enhances customers' productivity by providing voice and electronic access into the IBM support organization. IBM Operational Support Services Support Line will help answer questions pertaining to usage, and suspected software defects for eligible products.
Installation and technical support is provided by Global Services. For more information call, 800-IBM-4YOU (426-4968).
The z/VM V4R2 product package is distributed with the following:
Security, Auditability, and Control
The announced programs uses the security and auditability features inherent in the virtual machine and the System/370, ESA/370, ESA/390 architectures, and z/Architecture. The security and auditability of z/VM V4 is the same for ESA/390 and z/Architecture.
The customer is responsible for evaluation, selection, and implementation of security features, administrative procedures, and appropriate controls in application systems and communication facilities.
z/VM V4 is a zSeries operating system designed to host guest operating systems (z/OS, OS/390, VSE/ESA, TPF, VM, or Linux), application development, database management, e-business, and office systems; and has one charge unit. It is one-time charge (OTC) per standard processor engine or per IFL processor feature.
Order entry capability for z/VM V4R2 is planned to be available beginning October 4, 2001. Production of z/VM V4R2 orders is planned to begin on October 26, 2001.
z/VM V4R1 will be available until October 25, 2001, at which time it will be withdrawn from marketing and customers will receive z/VM V4R2. Any order received with a customer-requested arrival date (CRAD) specified as October 26, 2001, or later, will receive z/VM V4R2.
To order z/VM V4R2, specify asset registration 9001 and the OTC feature number of the desired distribution medium. To order the optional product features RTM, PRF, or DirMaint, specify the OTC feature number of the desired distribution medium.
Specify the quantity of engines required. When ordering z/VM V4R2 or the
optional features to operate on standard processor engines, the quantity
of engines ordered must be equal to the number of standard processor
engines on your zSeries 900 or S/390 server. When ordering z/VM V4R2 or
the optional features to operate on processor engines with the IFL
feature, the quantity of engines ordered must be equal to the number of
processor engines with the IFL processor feature on your zSeries 900 or
Current licensees of z/VM V4R1 who have purchased z/VM S&S (5739-SWS) must order z/VM V4R2 as specified in the Ordering Information section. Information for subscribers of the S&S should refer to the z/VM Web site at:
Customers with z/VM S&S will receive z/VM V4R2 at no charge.
Current customers with VM/ESA V2 or earlier, z/VM V3R1, z/VM V4R1 without the S&S license, or a new VM customer must order z/VM V4R2 as specified in the Ordering Information section. To place these orders, customers should contact their IBM representative, IBM Direct, or IBM Business Partner.
New Licensees for z/VM V4R2: z/VM V4R2 must be ordered under the z/VM V4R2 SDO packaged offering, program number 5739-A04. Specify feature number 9001 for asset registration and the feature number of the desired distribution medium. You must also specify the quantity of OTC licenses required.
When ordering z/VM V4R2 or the optional features to operate on standard processor engines, the quantity of engines ordered must be equal to the number of standard processor engines on your zSeries 900 or S/390 server. When ordering z/VM V4R2 or the optional features to operate on processor engines with the IFL feature, the quantity of engines ordered must be equal to the number of processor engines with the IFL processor features on your zSeries 900 or S/390 server.
With the ordering of z/VM V4R2, you will receive a system DDR tape or CD-ROM containing the program code for z/VM V4R2, an IPLA for 5739-A03, a LID, PoE, program directories, and one copy of each publication available for z/VM V4R2. If you are specifying more than a quantity of one on your order, you will be entitled to operate z/VM V4R2 on the number of processor engines specified, but you will not receive distribution media or publications for the additional processor engines specified. The maximum quantity ordered should not be more than:
Quantity Engines w/IFL Standard Feature Engines For Each Server 1 2 S/390 Multiprise 3000 (7060) 7 10 S/390 Parallel Enterprise Server(TM) (9672) Generation 5 11 12 S/390 Parallel Enterprise Server (9672) Generation 6 15 16 zSeries 900 (2064)
The combination of standard engines plus engines with the IFL feature cannot be greater than the number of standard engines for each server listed in the table.
The optional features RTM, PRF, and DirMaint are preinstalled on the base System DDRs. Ordering these features establishes a license for entitlement purposes and you will also receive a program directory for the optional feature ordered. To establish a license for RTM, PRF, or DirMaint, specify the program number, 5739-A04 and the OTC feature number of the desired distribution medium for each optional product desired.
When ordering the optional features to operate on standard processor engines, the quantity of engines ordered must be equal to the number of standard processor engines on your S/390 or zSeries server. When ordering the optional features to operate on processor engines with the IFL feature, the quantity of engines ordered must be equal to the number of processor engines with the IFL processor features on your S/390 or zSeries server.
You must also specify the quantity of OTC licenses equal to the number of z/VM V4R2 basic licenses.
z/VM S&S will be automatically added to your order. If you do not desire the S&S license for z/VM and/or the optional features of RTM, PRF, or DirMaint, you must take specific action to decline this support.
The quantity of z/VM S&S licenses must be equal to the number of OTC licenses ordered for the z/VM V4R2 base code or the optional features.
Program Name: z/VM Version 4 SDO
Program Number: 5739-A04
Program Feature Description Number Number Medium z/VM Version 4 5739-A04 6000 3480 Tape 3380 System DDR z/VM Version 4 5739-A04 6001 4-mm Tape 3380 System DDR z/VM Version 4 5739-A04 6002 3480 Tape 3390 System DDR z/VM Version 4 5739-A04 6003 4-mm Tape 3390 System DDR z/VM Version 4 5739-A04 1004 CD-ROM CD-ROM System DDR
Program Name: Optional Features of z/VM Version 4 SDO
Program Number: 5739-A04
Program Feature Description Number Number Medium RTM Feature 5739-A04 6167 3480 Tape RTM Feature 5739-A04 6168 4-mm Tape RTM Feature 5739-A04 1004 CD-ROM PRF Feature 5739-A04 6095 3480 Tape PRF Feature 5739-A04 6096 4-mm Tape PRF Feature 5739-A04 1004 CD-ROM DirMaint Feature 5739-A04 6157 3480 Tape DirMaint Feature 5739-A04 6158 4-mm Tape DirMaint Feature 5739-A04 1004 CD-ROM
Support for z/VM Version 4
Program Name: z/VM Subscription and Support
Program Number: 5739-SWS
Support for z/VM V4R2 is provided and licensed under the:
This 5739-SWS order establishes entitlement records worldwide as well as support for z/VM V4 or the optional features. If a 5739-SWS order is declined, the customer will only be entitled to support under the basic warranty for the z/VM V4R2 (5739-A03).
Central Service for z/VM V4R2 (5739-A03) is planned to be available by IBM until December 30, 2003.
The z/VM S&S provides:
On-site (local) support, although available, is provided as part of the IBM portfolio of fee-based services.
z/VM S&S will be automatically added to your order. If you do not desire the S&S license for z/VM and/or the optional features of RTM, PRF, or DirMaint, you must take specific action to decline this support. If desired, the annual support charges based on the quantity of licenses will be added to your order.
Support for Program Feature Program Description Number Number Number z/VM V4 3380 5739-SWS 6200 5739-A03 Sys DDR S&S z/VM V4 3390 5739-SWS 6202 5739-A03 Sys DDR S&S z/VM V4 CD-R 5739-SWS 6225 5739-A03 Sys DDR S&S Restricted 5739-SWS 6220 5739-A03 Source S&S DFSMS/Kanji S&S 5739-SWS 6212 5739-A03 RTM Feature S&S 5739-SWS 6224 5739-A03 PRF Feature S&S 5739-SWS 6217 5739-A03 DirMaint 5739-SWS 6222 5739-A03 Feature S&S
The quantity of S&S licenses must be equal to the number of processor engines and must be equal to the number of OTC licenses ordered for the z/VM V4R2 base code or the optional features.
The maximum quantity ordered should not be more than:
Quantity Engines w/IFL Standard Feature Engines For Each Server 1 2 S/390 Multiprise 3000 (7060) 7 10 S/390 Parallel Enterprise Server (9672) Generation 5 11 12 S/390 Parallel Enterprise Server (9672) Generation 6 15 16 zSeries 900 (2064)
National Language Translation
When you order z/VM V4R2, the National Language Translation files for message repositories, HELP files, and other panels or files are included with the system.
The following components/features are supported by z/VM V4R2 in the following languages:
The DirMaint feature provides national language translation for DirMaint messages in Kanji and is automatically included with the new feature.
If you would like DFSMS/VM translated in Kanji, order the no-charge feature number:
Program Feature Description Number Number Medium DFSMS/VM Kanji 5739-A04 6012 3490 Tape DFSMS/VM Kanji 5739-A04 6013 4-mm Tape
Restricted Source Feature
The z/VM Restricted Source feature contains annotated assembler listings (assembler source code generated from z/VM PL/X source modules) for CP, CMS, REXX/VM, VMSES/E, GCS, and TSAF and is shipped as a separately orderable feature tape or as part of the System DDR CD-ROM.
If you would like the z/VM Restricted Source feature, order the no-charge feature number:
Program Feature Description Number Number Medium z/VM Restricted 5739-A04 6020 3480 Tape Source Feature z/VM Restricted 5739-A04 6021 4-mm Tape Source Feature
Starting with z/VM V4R1, several products were automatically preinstalled on the base product DDRs.
Customization Options: Select the appropriate feature numbers to customize your order for the z/VM V4 SDO, program number 5739-A04, for the delivery options desired. The feature numbers associated with Initial and Update Shipments are only available for the licensed products within the SDO and not for z/VM base code or the orderable optional features. However, the feature numbers associated with the Expedite Shipments are applicable for both the z/VM V4R2 SDO licensed products and the z/VM base code plus the optional features.
Example: If publications are not desired for the initial order, specify feature number 3470 to ship media only. For future updates, specify feature number 3480 to ship media updates only. If, in the future, publication updates are required, order an MES to remove feature number 3480; then, the publications will ship with the next release of the program.
Feature Description Number Initial Shipments Serial Number Only (suppresses shipment 3444 of media and documentation) Ship Media Only (suppresses initial 3470 shipment of documentation) Ship Documentation Only (suppresses 3471 initial shipment of media) Feature Description Number Update Shipments Ship Media Updates Only (suppresses 3480 update shipment of documentation) Ship Documentation Only (suppresses 3481 update shipment of media) Suppress Updates (suppresses update 3482 shipment of media and documentation) Expedite Shipments Local IBM Office Expedite 3445 (for IBM use only) Customer Expedite Process Charge 3446 ($30 charge for each product)
Expedite shipments will be processed to receive 72-hour delivery from the time IBM Software Delivery and Fulfillment (SDF) receives the order. SDF will then ship the order via overnight air transportation.
Terms and Conditions
These products are licensed under the IPLA, and the associated Agreement for Acquisition of Support, and the Addendum for Support (Z125-6457) which provides for support with ongoing access to releases and versions of the program. These programs have a one-time license charge for use of the program and an ongoing recurring charge for the enhanced support that includes telephone assistance (voice support for defects during normal business hours) as well as access to updates, releases, and versions of the program as long as support is in effect. S/390 and zSeries IBM Operational Support Services Support Line is an option for those customers who desire added services.
Additional fee support will be provided through the IBM Operational Support Services Support Line and Country specific service offerings.
This program will be subject to the terms of the IPLA contained in the program package, and not to the Agreement for IBM Licensed Programs.
This Statement is complementary to the IBM IPLA contained in this package:
Program Program Name Number Service End Date z/VM V4R2 5739-A03 December 30, 2003
For program defect related problems, the following procedure for assistance in problem identification is applicable:
Problems should be submitted using one of the following methods:
E-mail address: email@example.com
Fax number: 607-752-1497
c/o VM Service
1701 North Street
Endicott, NY 13760
IBM will reply in writing with information about correction, bypass, or restriction with the intent to make the program perform according to its specifications, or, if there are none, to its principles of operation.
Customer information needed when submitting a problem:
Additional information on customer-reported problems can be obtained from your remarketer/distributor or IBM.
Products Eligible for Single Version Charging
Single Version Charging is only applicable when running on standard processor engines.
Replaced Programs Replacement Programs Program Program Program Program Number Name Number Name 5654-A17 z/VM Version 3 5739-A03 z/VM V4R2 5654-030 VM/ESA Version 2 5739-A03 z/VM V4R2 5684-112 VM/ESA Version 1 5739-A03 z/VM V4R2 5664-167 VM/SP(TM) 5739-A03 z/VM V4R2 5664-173 VM/SP HPO 5739-A03 z/VM V4R2 5664-301 VM/IS Base (Core) 5739-A03 z/VM V4R2 5664-308 VM/XA SP 5739-A03 z/VM V4R2 5735-FAL TCP/IP Version 2 5739-A03 z/VM V4R2 5798-FAL TCP/IP Version 1 5739-A03 z/VM V4R2 5796-PNA VM Realtime Monitor 5739-A03 z/VM V4R2 5798-DWD Realtime Monitor VM/ESA 5739-A03 z/VM V4R2 5684-073 VMPRF 5739-A03 z/VM V4R2 5748-XE4 DirMaint 5739-A03 z/VM V4R2 5688-198 Language Environment/370 5739-A03 z/VM V4R2 5706-116 DFSMS/VM 5739-A03 z/VM V4R2 5668-911 OS/PL/I V2 Library 5739-A03 z/VM V4R2 5734-LM4 OS PL/I Resident Library 5739-A03 z/VM V4R2 5734-LM5 OS PL/I Transient Library 5739-A03 z/VM V4R2 5688-022 VS COBOL II Library Only 5739-A03 z/VM V4R2 5668-940 VS COBOL II Library Only 5739-A03 z/VM V4R2 5740-LM1 OS/VS COBOL Library Only 5739-A03 z/VM V4R2 5688-039 C/370(TM) Library 5739-A03 z/VM V4R2
The prices provided in this announcement are suggested retail prices for the U.S. only and are provided for your information only. Dealer prices may vary, and prices may also vary by country. Prices are subject to change without notice. For additional information and current prices, contact your local IBM representative.
Program Name: z/VM Version 4 Release 2
Program Number: 5739-A03
OTC Program Feature Description Number Number OTC z/VM Version 4 5739-A03 0028 $45,000/engine (U.S.) RealTime Monitor 5739-A03 0027 1,650/engine (U.S.) Performance Reporting 5739-A03 0029 1,200/engine (U.S.) Facility Directory Maintenance 5739-A03 0026 760/engine (U.S.) Facility
Note: These charges are the same as z/VM V4R1.
Program Name: z/VM Subscription and Support
Program Number: 5739-SWS
Order under Program Support Number 5739-SWS for Standard Support Support for Program Annual Charge Annual Program Name Number Feature Number Charge z/VM Version 4 5739-A03 0033 $11,000/engine RealTime Monitor 5739-A03 0030 400/engine Performance 5739-A03 0031 300/engine Reporting Facility Directory Maintenance 5739-A03 0032 190/engine Facility
Note: These charges are the same as z/VM V4R1.
Contact your sales channel for IBM Operational Support Services Support Line pricing information.
Customer Financing: IBM Global Financing offers attractive financing to credit-qualified commercial and government customers and Business Partners in more than 40 countries around the world. IBM Global Financing is provided by the IBM Credit Corporation in the United States. Offerings, rates, terms, and availability may vary by country. Contact your local IBM Global Financing organization. Country organizations are listed on the Web at:
Use Priority/Reference Code: ME001 Phone: 800-IBM-CALL Fax: 800-2IBM-FAX Internet: firstname.lastname@example.org Mail: IBM Atlanta Sales Center Dept. ME001 P.O. Box 2690 Atlanta, GA 30301-2690
You can also contact your local IBM Business Partner or IBM representative. To identify them, call 800-IBM-4YOU.
Note: Shipments will begin after the planned availability date.