VSE/ESA VERSION 2 RELEASE 1 AND VSE/ESA LANGUAGES -- PL/I, COBOL, LE

VSE/ESA Version 2 Release 1 and VSE/ESA Languages -- PL/I, COBOL, LE

Software Announcement
September 13, 1994
Announcement Letter Number: 294-519

VSE/ESA offers entry and intermediate S/390 (R) users a system package with full function batch and online transaction processing. VSE/ESA is also the S/390 operating system of choice for multiples or centrally managed, remote unattended systems. VSE/ESA can be used alone, or in combination with VM/ESA.

VSE/ESA Version 2 builds on a foundation of VSE/ESA Version 1 success. It addresses customer needs in traditional areas of VSE strength.

VSE/ESA Version 2 Release 1 offers substantial improvements in the following areas:

Provides exciting new client/server capabilities. In addition to VSE/ESA Version 1 client/server functions, such as:
- TCP/IP, MQSeries, SQL/DS DRDA server capability, and full membership in the CICS Family
- LANRES/VSE as a new function, IBM VisualLift for MVS, VSE and VM and ADSTAR Distributed Storage Manager for VSE/ESA as new optional products. VSE Workdesk includes and improves Distributed Workstation Feature and offers the "point-and-click" VSE Interactive Interface.
Reduced cost of computing
- Closely related base products are integrated into a single new product
- Significant improvements to console support
- Improved installation procedures, Fast Service Upgrade for VSE/ESA Version 1 Release 3
- A new, improved price structure
Support for IBM hardware. VSE/ESA Version 2 runs only on ES/370- or ESA/390-capable processors (native, under LPAR, or as a VM/ESA guest). Most I/O support by VSE/ESA Version 1 is also supported by VSE/ESA Version 2. For exceptions, refer to VSE/ESA General Information, Planning Aspects (GC33-6628).
- New CMOS processors. This includes the new "VSE/ESA Turbo Dispatcher" that provides native support for multiprocessors with common storage.
- VSAM data compression, including exploitation of the hardware assist standard on newer models of S/390
- RAMAC Array DASD and Array Subsystem (supported by VSE/ESA Version 1 as well)
- Native VSE support for IBM 3494 Tape Library (hardware feature)
Improved affinity between VSE/ESA Version 2 and MVS/ESA. VSE/ESA and MVS/ESA are two members of an "MVS" family. Together, they offer an extraordinary range of scalable solutions.
- New language environment programs
- Networking offering
- MVS/ESA code for various VSE/ESA system functions
- In the future, a "common" CICS-based on CICS/ESA

IBM PL/I for VSE, IBM COBOL for VSE, and IBM Language Environment for VSE are being announced today. They are VSE/ESA-enabled versions of the following MVS- and VM-based programs:

IBM SAA AD/Cycle LE/370 Version 1.2 (CEL)
IBM SAA AD/Cycle PL/I MVS & VM Version 1.1 (Compiler + Run-time)
IBM SAA AD/Cycle COBOL/370 Version 1.1 (Compiler + Run-time)

For more information on these products, refer to Software Announcements 291-480, dated September 9, 1991, and 293-095, dated February 23, 1993.

Planned Availability Dates:

April 21, 1995, VSE/ESA Languages -- general availability: PL/I, COBOL, LE
April 21, 1995, VSE/ESA Version 2.1 general availability, except for the following functions:
- July 28, 1995, VSE/ESA Turbo Dispatcher available via PTF
- October 27, 1995: REXX extensions available via PTF

 (R)  Registered trademark of International Business Machines
      Corporation
**    Product or company name is a trademark or registered trademark
      of its respective holder.

------------------------------

This announcement is provided for your information only. For additional information, contact your IBM representative, call 800-IBM-4YOU, or visit the IBM home page at: %+%Start_URL%+% http://www.ibm.com

DESCRIPTION

Hardware Technology Exploitation

System/390 Parallel Enterprise Servers

With the announcement of the S/390 Parallel Enterprise Server, IBM introduces a series of powerful, cost-effective models based on CMOS microprocessor technology. Advanced CMOS technology brings VSE customers significant savings in energy, in service/maintenance, and in floor space compared to prior generation large processors. In addition to big environmental savings, the S/390 Parallel Enterprise Server offers increased availability and advanced features such as hardware-assisted data compression. At the same time, these new S/390 Parallel Enterprise Servers protect customer investments in systems management, skills, applications, and information assets. CMOS technology, in conjunction with new VSE/ESA V2 capabilities, enhances the VSE customer's ability to exploit the advantages of a client/server environment.

VSE/ESA Version 1 (Release 2 and Release 3) supports the uniprocessor model, IBM 9672-R11, natively. Other models are supported as separate LPARS or as guests under VM/ESA. VSE/ESA Version 2 supports all models.

VSE/ESA Turbo Dispatcher

VSE/ESA Version 2 offers VSE customers the value of superior IBM CMOS technology by introducing the "VSE/ESA Turbo Dispatcher". The Turbo Dispatcher brings "N-way" support to VSE for the first time. With the addition of this new dispatcher, VSE/ESA Version 2 supports all the S/390 Parallel Enterprise Server models natively. That is, when the Turbo Dispatcher is selected, VSE/ESA Version 2 supports the IBM 9672 R 1-way through 6-way processor models.

In addition to the S/390 Parallel Enterprise Server, VSE/ESA Version 2 natively supports all models of the ES/9000 (TM) family. For example, besides uniprocessor models also supported by VSE/ESA Version 1, VSE/ESA Version 2 with the Turbo Dispatcher supports ES/9221 2-way models and 2-4 way models of the ES/9121.

At IPL time, the customer selects either the old VSE dispatcher or new Turbo Dispatcher. If the old dispatcher is selected, support is limited to uniprocessors. If the Turbo Dispatcher is selected, the user has an option of uniprocessor or N-way mode. Even in uni-processor mode, the Turbo Dispatcher provides enhanced function (that is, equalized weighting of dynamic and static partitions). In N-way mode, the customer may run VSE/ESA Version 2 on any real N-way ESA processor, or on a virtual N-way ESA processor under VM/ESA.

On an N-way processor, the Turbo Dispatcher assigns "units of work" to processor units (PU). Each unit of work represents a single partition and will be assigned to a single PU for processing. When a unit of work from Partition A is complete, that PU will be assigned another unit of work, but not necessarily a unit of work from Partition A. When the next unit of work from Partition A is ready to be scheduled, it will be assigned to the next available PU. Thus a job may run on all PUs, but never more than one PU at a time. This simple, straight forward design ensures that VSE/ESA Version 2's N-way support is internally consistent with Version 1. The result is an N-way implementation specifically for entry and mid-range customers that minimizes any impact on existing VSE applications and operations.

VSE/ESA Version 2 supports only ESA processors, ESA LPARs, or ESA guests under VM/ESA. Also, VSE/ESA Version 2 N-way support is limited to processors with common storage and channel subsystem. Specifically, it does not support coupled systems.

S/390 Hardware-Assisted Data Compression

Data Compression for VSAM Datasets: VSE/ESA Version 2.1 supports data compression for selected VSAM datasets. VSAM will exploit the S/390 hardware-assisted compression feature, if available on the processor.

Data compression provides various benefits:

VSAM data stored in compressed form require significantly less DASD space. This allows considerable reduction in total cost of computing.
Processing of compressed data results in reduced channel traffic, thus overall system throughput will increase.
If VSAM runs on an S/390 processor with hardware-assisted compression feature, less processor time will be required compared to equivalent software compression techniques for compression and expansion of data.
VSAM datasets have an upper addressability limit of 4GB. Compressed datasets can effectively hold more data now, depending on the compression ratio.

No changes are required to application programs accessing compressed VSAM datasets, and only minor modifications to JCL (IDCAMS) are required to activate compression of datasets. Therefore, the full benefit of the VSE/ESA Version 2 Release 1 compression support can be achieved with minimal effort.

Data compression of VSAM data fulfills the Statement of Direction in Software Announcement 294-160, dated April 6, 1994.

Data Compression by the Networking Offering: VTAM's new product offering for VSE/ESA will also support hardware assisted data compression.

New and Enhanced Device Support

IBM 3494 Tape Library Dataserver: The IBM 3494 is an intermediate automated tape library. It automates retrieval, storage, and control of IBM 3490E cartridge tapes. VSE/ESA Version 2.1 supports the automated library by:

An API in VSE for application programs, for example, a tape management system. This API is a front-end for both native and guest library control architectures and is designed to allow tape management products to exploit the 3494 functions and to maintain cartridge inventory synchronization between tape management catalogs and the 3494. The API needs a counterpart either in another VSE partition or in VM:
- IBM 3494 hardware feature number 9203 (VSE Device Driver for native support in VSE), which utilizes the LAN attachment capability of the 3494 or
- DFSMS (TM)/RMS in VM with appropriate PTF
New Job Control Statements. Any user program can issue automated mounts without using a tape management system.

IBM RAMAC Array DASD/Subsystem: VSE/ESA Version 2.1 supports a new generation of storage devices, the IBM RAMAC Array Family. These devices offer, for example, exceptional data availability, high performance, high function, and ease of installation. Host connectivity options include parallel and/or ESCON (R) attachment.

IBM 3990 Model 6: With VSE/ESA Version 2 Release 1 the function Control-Unit-Initiated Reconfiguration (C.U.I.R.) of the enhanced mode of operation of the IBM 3990 Model 6 is supported (refer to Hardware Announcement 194-051, dated March 1, 1994).

Today, without CUIR, the process of applying maintenance to a device involves either setting the device offline, or, in case of control units being serviced, reconfiguring the channel paths on which devices are accessed. In order to do this, the current configuration of the entire I/O system of a processor has to be known to the operator, who has to find out which devices are affected, and is responsible for possible reconfiguration actions.

With CUIR, the process is automated in that a service representative uses a function on the 3990 service panel to notify the host software of a pending service action. The host software then takes the affected resources offline and notifies the 3990. At the end of the service action, the 3990 notifies the host and the resources are brought back online.

IBM 3480/3490 Automatic Cartridge Loader Flip/Flop: The support for the automatic cartridge loader has been improved by supporting asynchronous rewind for alternate tape processing with IBM 3490 and 3490E cartridges. Programs using alternative tape processing no longer need to wait until the rewind has been completed, but can switch to the alternate tape and continue processing immediately.

IBM 3390 Model 9: The new IBM 3390 model 9 disk is supported in several Interactive Interface dialogs of VSE/ESA Version 2.1. Beyond this automatic recognition during initial installation is provided.

Enhanced VSE/ESA Systems Management

VSE/ESA Version 2.1 offers new dimensions in systems management. Console support, integration and improvement of the REXX interpreter, and a reduction of complexity make it easy to operate VSE. The Interactive Interface can be used on workstations as a second step in the direction of the new "point-and-click" VSE/ESA, after the introduction of the Distributed Workstation Feature.

VSE/ESA Version 2.1 Console Support

The VSE/ESA Version 1 console support has been re-engineered, reliability has been improved, internal complexity has been reduced, MVS affinity has been enhanced, clear interfaces were defined to applications, and vendor products. This results in:

Improved Console Capabilities: System integrity and availability have been enhanced by a proven design to handle queueing and routing of messages, replies and responses. System operation and automation capabilities have been improved through various new console functions:
- When using multiple user consoles, only the user-relevant subset of the total console traffic can be routed to a specific console. For example, a user can specify to see all messages relating to one specific job for debugging purposes.
- Improved handshaking between VSE/ESA Version 2.1 and VM. VSE/ESA Version 2.1 systems running under VM support a CMS terminal to be used to control VSE/ESA operations, for example, VSE spooling. CMS presentation features like PF-keys can be used. Previous restrictions (for example, for dynamic partitions) to control VSE/ESA from VM no longer apply.
- System responses are routed to the originator. The application programming interface (API) or operator communication has been extended to allow full application control of console messages, including message deletion. This interface is MVS/ESA compatible.
- Improved logging allows unique identification of source, or target console, or user-ID. For non-critical query messages and responses, logging can be suppressed. Thus, auditing and reporting becomes easier. Performance to retrieve logged console entries has been improved.
Improved User Interface: Several long-standing user requirements were satisfied. PF-keys can now be defined. Retrieving previously entered commands and re-submitting logged commands avoid time-consuming and error-prone retyping of commands. Time-stamps on all console messages simplify search for messages. Message explanations are offered in all national languages supported.
Console Integration: The System/390 console can be used as VSE/ESA Version 2.1 system console. This eliminates the need for a separate local non-SNA terminal in these environments and represents a considerable cost saving in many environments since a control unit dedicated to the console is no longer required.

Integration of REXX/VSE

REXX/VSE has been improved and integrated into the new VSE/ESA base program, "VSE Central Functions". It can be used to tailor the VSE/ESA Version 2.1 operating system instead of and along with VSE conditional JCL. The improvements in REXX are compatible with the MVS TSO REXX to ease porting of applications.

REXX batch programs can now issue JCL commands, which are immediately executed with return codes. Thus, REXX can loop on JCL commands and thereby offers superior conditional job control capabilities.
REXX can now communicate with user consoles. Messages and replies are possible using the REXX instructions SAY and PULL, offering an interactive communication in line mode.
The VSE utilities Librarian and VSAM Access Method Services exploit a new host command environment to call a batch program: Librarian and VSAM AMS commands can be issued from REXX, which are immediately executed with a return code. Input/output data can be exchanged using REXX stems.
POWER list queue access is extended. Print output can be read from or written to REXX variables with the print control characters, if wanted.
The REXX message external function specifies the output destination where the REXX messages are routed to. Total REXX message suppression can be specified.
REXX permits a cost effective implementation of new and additional procedures for automated operations of the VSE/ESA system. This helps increase the productivity of system administrators and end users as well.

Addition of LANRES/VSE

The LAN Resource Extension and Services (LANRES) function for VSE/ESA establishes a server environment on VSE/ESA Version 2.1 to allow NetWare clients transparent access to mainframe resources. With LANRES/VSE, System/390 VSE systems, NetWare LAN servers, and heterogeneous clients, can be integrated in a way that helps maximize user productivity and provides unique business solutions. Customers who use LANRES/VSE can save time and leverage skilled resource while they provide their NetWare clients with improved services. With LANRES/VSE, a single NetWare server can communicate with an VSE, MVS, VM, and/or OS/400 (R) host at the same time.

LANRES/VSE services include:

Disk Serving allows workstation hard disks to be stored as single files on VSE. To the end user, there is no difference between files stored on VSE DASD and files stored on hard drives on the NetWare server. The client can access a combination of local disk drives, drives on the NetWare server, and disk drives on the host. By using the VSE environment for disk serving, you can increase the disk storage capacity available to NetWare file servers and have the reliability of VSE DASD. You can also take advantage of the DP center operation and control of disk storage devices, and the VSE backup procedures combined with the physical security of the DP center when storing sensitive information.
Print Serving provides for both LAN-to-host and host-to-LAN printing. LANRES/VSE lets NetWare end users route print jobs through NetWare to the host for printing. In addition, VSE users can route print jobs to NetWare for printing on NetWare attached printers. An advantage of using LANRES/VSE for LAN-to-host print services is that LAN clients can use high-speed, high-volume host printers for faster turnaround and do it in a physically secure environment.
Data Distribution allows VSE users to manipulate files and directories controlled by NetWare. The volumes containing these files may be on the NetWare server or on a LANRES/VSE host disk. This function implements a central data distribution capability and allows customers to write their own applications for moving data between the VSE system and the LAN. The advantage of this function is to allow for host-controlled automated data exchange between VSE and the NetWare server.
LAN Administration allows an authorized VSE user to perform LAN administration tasks such as adding, deleting and renaming users on the LAN. There are two objectives for the administration facility. First,to centralize your administration and perform administrative services from the host. Second, to allow the administration commands to be combined together in REXX execs to automate NetWare administration tasks.

The user interfaces to the above described LANRES/VSE services via a REXX interface. The VSE to NetWare server connections supported by LANRES/VSE include parallel channel attachment as well as SNA LU6.2 communication. All NetWare clients are supported.

VSE Workdesk

CUA Option for Interactive Interface: The VSE Workdesk is the second step towards a "point-and-click VSE". The VSE Workdesk offers the Interactive Interface of VSE/ESA Version 2.1 in a graphical form on a workstation. It offers the same "look-and-feel" as workstation applications do, and in most cases makes handling easier and reduces the probability of input errors. The menu-driven, 3270 Interactive Interface is still offered. Both, the 3270 Interactive Interface and the VSE Workdesk can be used simultaneously to control the same VSE/ESA system.

The same results can be achieved for any user application that is 3270-based by using the new IBM program IBM VisualLift for MVS, VSE and VM.

The VSE Workdesk partially fulfills the Statement of Direction in Software Announcement 294-160, dated April 6, 1994.

DWF Enhancements: The VSE Distributed Workstation Feature (DWF) provides CUA dialogs, host connections, and VSE/ESA host services to do program development on a workstation. The communication between workstation and host is based on CICS/APPC (LU6.2). This results in a more flexible and more robust communication. The performance of DWF has been improved.

Reduced Complexity

Improved Integration: The functionality of the VSE/ESA Version 2.1 System Package has been enhanced, and at the same time the product structure has been streamlined. The VSE/ESA Version 2.1 System Package with base and optional programs is a proven concept. One single program, VSE Central Functions, now provides the functions previously provided by the following separate base programs, VSE/Advanced Functions, VSE/Unique Code, VSE/POWER, VSE/Fast Copy, VSE/VSAM with its features Space Management and Backup/Restore, VSE/ICCF, VSE/OLTEP, and in addition, REXX/VSE, which is an optional program on VSE/ESA Version 1. LANRES/VSE has been added VSE Central Functions.

Now, VSE/ESA Version 2.1 is comprised of the following base programs:

Product Product Name Level Number

VSE Central Functions 6.1.0 5686-066 CICS/VSE (R) incl. RCF 2.3.0 5686-026 Networking Offering * BTAM-ES 1.1.0 5746-RC5 IBM High Level Assembler for VSE * DITTO/ESA for VSE 1.1.0 5648-099 VSE/ICKDSF 1.16.0 5747-DS2 VSE/EREP 3.5.0 5656-260

*     Product number will be provided before general availability.

For ease of understanding, familiar names like POWER, VSAM, and REXX are still used, however, they now refer to functions instead of separate programs. VSE Central Functions is easy to install and use.

This facilitates and simplifies ordering of VSE/ESA Version 2.1 significantly, and fulfills the Statement of Direction in Software Announcement 294-160, dated April 6, 1994.

ESA Supervisor: VSE/ESA Version 2 Release 1 depends on ESA hardware features. Therefore it runs only on processors that support ESA/370 or ESA/390 architecture. The new ESA supervisor offers all capabilities of the former ESA supervisor, and additionally two important capabilities from the former VM/ESA supervisor running under VM:

Performance advantage of the former VM/ESA supervisor by avoiding duplicate paging can be obtained. An IPL option is offered to run without VSE page dataset. This option can be used when the processor storage (actual or simulated by VM) is as large as the virtual VSE storage.
The Inter-User Communication Vehicle (IUCV) is generally supported when VSE/ESA runs under VM.

Elimination of 3 of the 4 supervisor mode of VSE/ESA Version 1 reduces the complexity for the system administrator.

Installation And Customization Enhancements: During installation, a VSE environment is loaded from tape. The same ESA supervisor is used now for IPL either from tape or from disk. This offers device sensing, better recovery and all the console advantages like PF-keys and full-screen console also to the stand-alone environment. The former separate "stand-alone" program ICKDSF is replaced by the online version of ICKDSF. The interface to the operator is the same; a customization table built for the previous "stand-alone supervisor" works unchanged.

A predefined customization table is shipped on the installation tape, which requires only minimal information via operator prompts; complex commands for initialization of the system disks no longer have to be entered.

A Fast Service Upgrade (FSU) path from VSE/ESA Version 1.3 to VSE/ESA Version 2.1 is provided.

Thus, initial installation of VSE/ESA is considerably easier, less error-prone and faster since the information required for/during IPL is retrieved from the system instead of being requested from the operator. In addition the number of IPLs required for initial installation is reduced.

Miscellaneous Enhancements: Many other enhancements have been made, especially to ease running vendor products or debugging applications.

Vendor Exits: In cooperation with business partners, exits have been designed and implemented in VSE/ESA Version 2.1, which allow application programs, for example, vendor products, to gain control on predefined points of VSE.

These exits reduce the need to hook into the system in varying and potentially improper ways, which might result in damage to the VSE/ESA code. The exits constitute product sensitive interfaces, are not intended for general use and should be used only by qualified persons.

Problem Determination Enhancements: A new debugging tool for application programs is provided. The interactive partition trace program PTRACE traces the execution of programs running in a static or dynamic partition. It is controlled interactively from any VSE/ESA console and operates at the level of machine instructions and virtual storage addresses, similar to the CP debugging facilities of VM/ESA. It is possible to trace successful branch instructions and storage alterations within a specified storage area, and to enter interactive debug at abnormal end (ABEND).

VSE/ESA Base Programs

New programs and new levels of existing base programs are offered in the VSE/ESA Version 2 package.

Networking Offering: IBM intends to provide a product offering VSE/ESA networking environments which will support the latest technology in networking for client/server environments, delivering Systems Network Architecture Advanced Peer-to-Peer Networking (R) (APPN) capability.

CICS Version 2 Release 3: Utilization of the Language Environment for VSE (the optional program LE for VSE) will allow further relief from virtual storage constraints compared to earlier 24-bit code.

CICS API and SPI enhancements have been made to smooth the transition between CICS/VSE Version 2 and subsequent versions. The programming commands provide:

Command-level equivalents of functions that, until now, have been available as part of the macro-level programming interface only.
Additional commands, brought from the CICS/ESA product, to enhance the interfaces.

For more details, refer to Software Announcement 294-520, dated September 13, 1994.

DITTO/ESA Release 1: Data Interfile Transfer, Testing, and Operations Utility (DITTO) is working with tapes, disks, VTOCs and catalogs, VSAM data, VSE library members, sequential data sets, and card images.

DITTO/ESA Release 1 exploits 31-bit addressing and new features of VSE/ESA. It adds new functions and many improvements based on customer requirements received. The DITTO Version 3.2 Productivity Feature for VSE is now included in this new version of DITTO.

DITTO's functions can be used either in full-screen mode using its own interactive panel driver (independent from ICCF). It can be used on REXX procedures using DITTO's new keyword command mode. For routine tasks, DITTO can be used in batch jobs using control statements. In emergency situations it can also be used on a system console in dialog mode.

For more details, refer to Software Announcement 294-537, dated September 13, 1994.

IBM High Level Assembler for VSE: The High Level Assembler was previously available as an optional program with VSE/ESA Version 1. A new release of it is now integrated in the VSE/ESA Version 2.1 base system package. It provides 31-bit virtual addressing, ESA Data Space access, and extensive usability, productivity and reliability enhancements, such as user input/output (I/O) exits, XREF facilities and extensive support capabilities for debugging and program analysis.

ICKDSF Version 1 Release 16: With VSE/ESA Version 2.1 and ICKDSF Version 1 Release 16 VTOC expansion is supported. This function allows the VTOC size to be increased and relocated without re-initialization of the entire volume. The VTOC expansion function is only available for CKD/ECKD (TM) devices.

VSE/ESA Optional Programs

New programs and new levels of existing optional programs are offered in the VSE/ESA Version 2.1 system package.

Client/Server

ADSTAR Distributed Storage Manager for VSE/ESA: This is a new optional product for VSE/ESA Version 2.1. It is a member of the ADSTAR Distributed Storage Manager family of products, and provides VSE/ESA-based backup/archive services for a variety of client platforms including DOS, OS/2 (R), AIX/6000 (R), Microsoft Windows+, and Novell NetWare systems, and uses the host's central data storage facilities, disk and tape, for saving critical data dispersed on different workstations throughout the company. Workstation users, that is ADSM clients, can now easily backup or archive their data. The data can then be recovered at any time using ADSM's restore and retrieve functions.

For details, refer to Software Announcement 294-536, dated September 13, 1994.

IBM VisualLift for MVS, VSE and VM: VisualLift, provides a visual "face-lift" that can make existing 3270-based applications look brand new, without programming and without changing the application at the host. The VisualLift user sees a workstation screen and is able to use the mouse to access workstation controls, such as push buttons, check boxes, notebooks etc.. VisualLift provides investment protection for function-rich host applications, while at the same time making them appear brand new with little effort and minimal investment.

For more details, refer to Software Announcement 294-531, dated September 13, 1994.

Application Development

VisualGen (TM): VisualGen is an OS/2-based application development solution for applications that run in a variety of workstation and host environments, including VSE/ESA Version 2.1. It provides the capability to define, test and generate graphical user interface (GUI) client applications (OS/2 and Windows Version 3.1), server applications, and single-system applications in the same development environment.

VisualGen produces applications that support CICS and batch processing and remote access to data stored on DB2 (R)/VSE and VM (SQL/DS) using Distributed Relational Database Architecture (TM) (DRDA).

VisualGen Developer: Allows a developer to interactively build applications and interpretively test it without a single workstation.
VisualGen Generator Option for VSE: The application generator builds optimized COBOL code for the target execution environment. VisualGen generates COBOL source code to be compiled with either VS COBOL II, or COBOL for VSE compilers.
VisualGen Workstation Services are required at the workstation to assist during preparation and execution.
VisualGen Host Services are required at the VSE host to assist during preparation and execution. VS COBOL II Library (or Library + Compiler, or Library + Compiler + Debug) are required. COBOL for VSE requires LE for VSE.

Cross System Product (CSP) definitions can be migrated to VisualGen.

For additional information, refer to Software Announcements 294-335, and 294-336, dated May 24, 1994.

VSE/ESA Languages

The language compilers are complemented by a common language environment that supports compilation and/or execution of applications with a single run-time library for multiple languages.

The language compilers produce object code, which uses the common run-time environment resulting in:

Improved ability to build applications out of reusable components
Improved usability of native language condition handling in mixed language applications.

The following support will not be provided by the VSE/ESA languages:

Interactive debug
Batch or symbolic debug
Multi-tasking
LE-supported Interlanguage Communications (ICL) with C/370 (TM), or FORTRAN

IBM Language Environment for VSE: LE for VSE offers the ability to mix languages readily in a single application. COBOL for VSE and PL/I for VSE are supported as well as interfaces or CICS and DB2/VSE and VM (SDL/DS). This means that an application originally written in one language can be extended or enhanced in another. For example, an application originally written in COBOL might have a new feature added by a PL/I programmer.

LE for VSE also provides for common code between language processors. This means increased programmer familiarity with the attributes of common code. Such common code includes math libraries and communications code, as well as interface standards and application utilities. With LE for VSE there is a run-time environment to run COBOL and PL/I programs on VSE/ESA just like on VM/ESA and MVS/ESA.

LE for VSE is an implementation of IBM SAA AD/Cycle LE/370.

IBM COBOL for VSE: COBOL for VSE is a fully upward compatible successor to VS COBOL II, and offers the same level of support for the ANSI 1985 COBOL standard as VS COBOL II. It supports the following:

SAA CPI for COBOL
Associated Data function (ADATA)
Intrinsic function
Common Execution Environment (CEE)
LE for VSE run-time like MVS and VM
Improved performance optimization
Fixed-point decimal data as a native data type

It is an implementation of IBM SAA AD/Cyle COBOL/370, which is based on the ANSI 1989 COBOL standard, and requires LE for VSE as prerequisite program. Documents are also available in softcopy form.

IBM PL/I for VSE: DOS PL/I has been available on VSE for many years. The successor product, PL/I for VSE, offers:

31-bit virtual addressing
Support for LE for VSE functions
Enhanced interface to COBOL for VSE
Inter Language Communication (ILC) with COBOL for VSE
Source program compatibility with DOS PL/I Release 6 for most PL/I programs

PL/I for VSE is an implementation of IBM SAA AD/Cycle PL/I MVS and VM, and requires LE for VSE as prerequisite program

Other VSE/ESA Optional Programs

DFSORT (TM)/VSE Version 3 Release 1: This program is a fast and efficient data processing tool that provides sorting, merging, copying, and data manipulation capabilities for VSE/ESA. DFSORT/VSE exploits ESA/390 and ESA/370 processors and supports functions, such as 31-bit addressing, data spaces, and VSE/VSAM functions. It provides productivity features that allow user applications to work with data efficiently.

For more details, refer to Software Announcement 294-521, dated September 13, 1994.

IBM VSE/OCCF Version 1 Release 5: This new release of VSE/OCCF can run in a private rather than in a shared partition, which offers additional private space below the 16MB line.

If OCCF runs without NetView (R), or in an unattended node, OCCF tables may be put in the shared virtual area rather than in a private or shared partition. This reduces the space overhead and can save more than 100KB space below the 16MB line.

IBM DL/I DOS/VS Version 1 Release 10 (including PTF): Now, DL/I Version 1.10 with PTF fully supports all 31-bit languages (including the new COBOL for VSE, and PL/I for VSE) in the VSE/ESA environment. Both, DL/I online and batch/MPS applications written in any of these languages can execute above the 16MB line. This is possible for programs implemented both in the DL/I CALL and DL/I HLPI interface. Any definitions or options formerly required to place the DL/I parameters below the 16MB line are no longer required.

IBM ASF/VSE Version 3

Application Support Facility/VSE is a cross-industry product which allows the creation and processing of small to very large volumes of individual and structured documents and business correspondence. The documents can consist of text, graphics, and variable data.

Document processing requires the Document Composition feature in conjunction with Document Composition Facility (DCF), of the Document Writing feature in conjunction with DisplayWrite (R)/370.

ASF/VSE also integrates applications through a consistent Application Programming Interface (API). In addition the Workstation feature is required if applications running under OS/2 should be included. The workstation provides a connection to FlowMark (TM)/2, thus offering possibilities to control the processing of applications on the host.

IBM VSE/ESA Version 2 Release 1 Optional Programs

Following is a complete list of VSE/ESA Version 2 Release 1 optional programs including their current release/modification levels:

Program Program Name Number V.R.M

Core Optional Programs

LE for VSE 5686-067 1.1.0

System Control

ADSM/VSE 5686-073 1.2.0 VSE/OCCF 5746-XC5 1.5.0 VSE/Access Control Logging and Reporting 5746-XE7 1.2.1

Network Control

ACF/NCP for IBM 3725 5668-854 4.3.1 ACF/SSP 5686-064 4.1.0 EP for ACF/NCP 4.3.1 5735-XXB 1.6.1 ACF/NCP 3745 5648-063 7.1.0 ACF/NCP for IBM 3720/3745 5668-738 5.4.0 EP for ACF/NCP 5.4.0 in PEP mode (non-SNA support for 3745) 5735-XXB 1.8.0 EP for ACF/NCP 5.4.0 5735-XXB 1.9.0 EP for ACF/NCP 7.1.0 5735-XXB 1.12.0 NetView 5686-055 2.3.0 NetView FTP 5686-013 1.1.1 X.25 NPSI for ACF/NCP 4.3.1 5668-719 2.1.0 X.25 NPSI for ACF/NCP 5.4.0 5688-035 3.4.0 X.25 NPSI for ACF/NCP 7.1.0 5688-035 3.7.0

Compiler and Tools

VisualGen Developer 5648-040 1.1.0 VisualGen Workgroup Services 5648-076 1.1.0 VisualGen Host Service 5648-078 1.1.0 VisualGen Gen. Option for VSE 5648-086 1.1.0 CSP/AD CSP/AD PWS feature 5668-813 3.3.0 CSP/AE 5668-814 3.3.0 VS COBOL II Library 5688-022 1.4.0 VS COBOL II Compiler + Lib 5688-023 1.4.0 VS COBOL II Comp+Lib+Debug 5668-958 1.4.0 COBOL for VSE 5686-068 1.1.0 PL/I for VSE 5686-069 1.1.0 C/370 Compiler 5688-187 2.1.0 C/370 Library 5688-188 2.1.0 CICS/DDM VSE 5686-018 1.1.0 DFSORT/VSE 5746-SM3 3.1.0 DOS/VS COBOL 5746-CB1 1.3.1 DOS/VS RPG II 5746-RG1 1.3.0 DOS PL/I Optional Compiler and Libraries 5736-PL3 1.6.0 Optimizing Compiler 5736-PL1 1.6.0 Resident Library 5736-LM4 1.6.0 Transient Library 5736-LM5 1.6.0 Program Program Name Number V.R.M

SDF/CICS SDF/CICS Kanji feature 5746-XXT 1.5.0 CICSPARS/VSE 5666-329 1.1.1 CICSVR/VSE 5686-011 1.1.0 VisualLift for MVS, VSE and VM 5648-109 1.1.0

Remote Control Support

VSE/DSNX 5686-041 2.1.2

Database

SQL/DS SQL/DS NL feature 5688-103 3.4.0 DL/I DOS/VS 5746-XX1 1.10.0

DP AND Business Professional Support

GDDM (R) IMD 5668-801 2.1.2 GDDM VSE GDDM VSE -- NL feature 5686-057 3.1.1 GDDM PGF 5668-812 2.1.2 GDDM IVU 5668-723 1.1.2 QMF (TM)/VSE QMF/VSE -- NL feature 5648-061 3.1.1

Office Support

PS/CICS 5666-318 1.3.1 DISOSS/370 5666-270 3.4.0 DisplayWrite/370 under VSE/CICS -- NLS Feature 5686-022 2.1.0 ASF/VSE -- ASF/VSE NLS features 5686-075 3.1.0

Advanced Function Printing (TM)

PSF (TM)/VSE PSF/VSE Core Interchange Fonts 5686-040 2.2.1 PPFA/370 5688-190 1.1.0 OGL/370 5688-191 1.1.0

PRODUCT POSITIONING

VSE/ESA offers System/390 users a full-function on-line and batch transaction processing system. To these traditional VSE strengths, VSE/ESA Version 2.1 adds exciting new client/server capabilities.

Alone, or in combination with VM/ESA, VSE/ESA can be the primary system for small and intermediate data centers. VSE/ESA is also the System/390 offering for centrally managed, remote unattended systems.

VSE/ESA Version 2.1 has been designed to address the following customer segments:

Small- and medium-sized customers with VSE/ESA Version 1 and ES/9000 processors.
Intermediate-sized customers with VSE/ESA Version 1 and ES/9000 processors who have substantial growth requirements.
Customers with VSE/SP or VSE/ESA Version 1 who need to replace System/370 (TM), 370-XA, or competitive processors.
Large enterprises who require multiple systems or networks of unattended systems with a strong affinity to MVS/ESA.
New customers and OEM vendors who require low-cost solutions based on S/390 technology.

First announced in September 1990, VSE/ESA Version 1 focused primarily on increasing the capacity of VSE. In addition, it offered VSE/SP customers investment protection and began an ongoing process of increasing affinity between VSE and MVS.

VSE/ESA Version 2.1 builds on a strong Version 1 base and adds exciting new open, client/server capabilities which transform VSE/ESA Version 2.1 into a "power server" for the 1990s. It expands VSE capacity even further by exploiting multiprocessor models. In addition, VSE/ESA Version 2.1 reduces the cost of computing through quality, simplicity, ease-of-use, and improved packaging and integration.

VSE/ESA Version 2.1 continues to bring VSE/ESA and MVS/ESA even closer together. In many ways, VSE/ESA Version 2.1 can be considered a "derivative" of MVS/ESA. Subsystems such as CICS and a New Networking Offering are common. In fact, many operating system services in VSE/ESA Version 2.1 are based on MVS/ESA code. Because of the close affinity to MVS/ESA, VSE/ESA Version 2.1 can be thought of as a "value", "entry", or "junior" version of MVS/ESA. Together, VSE/ESA Version 2.1 and MVS/ESA make up an "MVS family", offering customers an exceptional range of scalable solutions. VSE/ESA Version 2.1 focuses on entry and intermediate System/390 solutions while MVS/ESA focuses on large-intermediate to very large, "leading edge" solutions.

Please note, VSE/ESA Version 1 will continue to be available. While VSE/ESA Version 2.1 is the clear offering of choice for most customers, VSE/ESA Version 1 will remain a valid solution in selected situations.

TECHNICAL INFORMATION

Specified Operating Environment

Hardware Requirements: VSE/ESA Version 2.1 provides native support for System/390 processors and other ESA capable processors. Compared to VSE/ESA Version 1.3, this includes, through the VSE/ESA Turbo Dispatcher, exploitation of multiple processors in one Central Electronic Complex (CEC), sharing common memory. It excludes, however, support of all non-ESA processors or non-ESA logical partitions.

Specifically, the new System/390 Parallel Enterprise Servers with storage from 128MB to 2GB are supported:

S/390 9672 Model R11 -- Uniprocessor model
S/390 9672 Model R21, R31, R41, R51, R61 -- Multiprocessor models with 2 to 6 processors, natively supported through the new VSE/ESA Turbo Dispatcher

The ESA capable models of the following processors are supported by VSE/ESA Version 2.1; in case of multiprocessor models through the new VSE/ESA Turbo Dispatcher:

All ES/9000 models
ES/3090 (TM)-9000T
ES/4381 (TM) Models 90E, 91E, 92E
ES/3090 E/J/S

The following processors are no longer supported:

9370
4341
4361
4381 except as noted above

The following devices are no longer supported:

3350 DASD
3375 (except as data device)
3410, 8809 tape units
1600 bpi distribution media

A comprehensive list of IBM processors supported by VSE/ESA Version 1.3, and VSE/ESA Version 2.1 can be found in the VSE/ESA General Information Manual, Planning Aspects (SC33-6628). A list including all processors newly added or removed with VSE/ESA Version 2.1 can be found in VSE/ESA General Information Manual, What's New (SC33-6627).

Minimum Configuration: The minimum configuration for VSE/ESA Version 2.1 requires a supported ESA-processor with the following features:

8MB central storage.
Two-disk volumes of the same type offering together approximately 440 MB. A detailed DASD layout can be found in the VSE/ESA V2 Installation Guide (SC33-6604).
One magnetic tape or cartridge unit.
One-line printer or local terminal printer with a speed of at least 300 lines-per-minute.
At least one display unit with 24 x 80 characters screen, at least 10 Programmable Function (PF) keys, and the capability to handle 3270 datastream.
A system console for installation. For System/390, this can be SNA-connected.

Depending on the customer environment and the products used, the above values may not be sufficient for productive use of the system.

LANRES/VSE

For the host part:
For the PC part:
For connectivity:
One of the following is required:
- An IBM PS/2 (R) Micro Channel (R) to Mainframe Connection to support parallel channel attachment. Refer to Hardware Announcement 192-156, dated June 30, 1992.
- Hardware as required to support SNA LU6.2 communications. Refer to NetWare for SAA Administration Guide for details.

IBM 3494 Usage: The Tape Library Dataserver IBM 3494 requires hardware feature number 9203 for native support in VSE/ESA Version 2.1 (also, refer to Software Requirements).

VSE/ESA Languages -- PL/I, COBOL, LE: PL/I for VSE Version 1.1, COBOL for VSE Version 1.1, and LE for VSE Version 1.1 support the following hardware configurations, System/390 processors with VSE/ESA Version 2.

Software Requirements: VSE/ESA Version 2 Release 1 generally is supported native, with PR/SM (TM) LPAR, or together with VM/ESA. Running native, the processors supported are described under Hardware Requirements.

VSE/ESA Version 2.1 can run on all supported VM/ESA releases. In this case, all processors are supported that are supported by the VM/ESA release used.

VSE/ESA Version 2.1 is supported in the VM Modes

V=V  Virtual Guest
V=R  Real mode (Preferred Guest)
V=F  Fixed mode (Multiple Preferred Guest)

VSE/ESA Version 2.1 is supported without page data set. This was previously possible only in the VM and VM/ESA mode of VSE/ESA Version 1, but now is possible with the (only) ESA supervisor mode. In addition, all VM linkage enhancements that had been available only in the VM mode of VSE/ESA, are available on the VSE/ESA Version 2.1 ESA supervisor mode. Because of the limitations of a single address space, the VMESA supervisor mode is no longer offered.

IBM 3494 Usage: Guest support of the Tape Library Dataserver IBM 3494 is based on DFSMS/RMS with the appropriate PTF in VM/ESA.

LANRES/VSE

For the host part:
- LANRES/VSE runs with VSE/ESA Version 2.1
- Print Services Facility (TM) (PSF)/VSE (5686-040) for Advanced Function on Printing (AFP (TM)) on appropriate PSF-supported printers.
For the PC part:
- NetWare Version 3.12 or Version 4, or NetWare Version 3.12 Japanese Version for the Japanese environment.
For connectivity
- For LU 6.2 connectivity between the VSE host and the NetWare server, you need NetWare for SAA Version 1.3B installed on the NetWare server. The NetWare for SAA Version 1.3B Japanese version is required together with NetWare Version 3.12 Japanese Version.

VSE/ESA Languages -- PL/I, COBOL, LE:

PL/I for VSE Version 1.1, and COBOL for VSE Version 1.1 run under control of VSE/ESA Version 2.
LE for VSE Version 1.1 requires in addition CICS/VSE Version 2 (5686-026) Release 3.

Compatibility:

VSE/ESA Turbo Dispatcher: VSE/ESA Version 2.1 supports processors with more than one processing unit in the most compatible way. Programs running on VSE/ESA Version 2.1 using official interfaces will be able to run unchanged with the VSE/ESA Turbo Dispatcher.

Specific system related applications using unofficial interfaces that interfere with the VSE system code might need to be modified. Such changes should mainly consist of indicating portions of the application code as "non-parallel", which means it can run in parallel with applications but not in parallel with other such code specified as "non-parallel".

Limitations:

VSE/ESA Turbo Dispatcher: Any processor is dynamically assigned to the highest priority work unit (partition) ready to work. Supporting for example six-way multiprocessors, the highest six work units (partitions) are assigned to the six available processors at an instant.

Since the VSE/ESA concept of supporting the VSE/ESA Turbo Dispatcher is based on dispatching on a partition rather than on a subtask basis, the degree of exploiting multi-processors depends on the number and type of active VSE partitions in a customer environment.

Maximum throughput for a single CICS (or any other) partition is limited by the processing power of a single processing unit in a parallel environment. Also, the maximum total throughput is determined by the amount of non-parallel work units, which cannot be run concurrently.

The VSE/ESA Turbo Dispatcher is limited to multiprocessors using the same central storage. Parallel Sysplex and the coupling link facility are not supported.

Supervisor Options: The supervisor generation options TTIME (task timer) and MODE (to select the supervisor mode) were dropped.

Integrated Console: When using the System/390 service processor PS/2-based console as VSE console, the performance typically is not expected to be adequate for system workloads with a high message traffic. Therefore, message traffic is redirected without disruption to another console as soon as one becomes active.

ESA-Mode Only: VSE/ESA Version 2.1 depends on ESA hardware features. Therefore it runs only on processors that support ESA/370 or ESA/390 architectures. The same is true for virtual machines, and VM environments must enable direct address translation (DAT). Therefore, the supervisor modes 370, VM, and VMESA are dropped.

REXX/VSE: Although REXX/VSE can be used interactively, ICCF interactive partitions are not supported by REXX. Batch programs that are not programmed properly may create problems when called by REXX.

IBM 3390 Model 9: VSE/VSAM support for the 3390 Model 9 DASD is restricted: Only the first 65,535 tracks (4,369 cylinders) of the total capacity of 150,255 tracks (10,017 cylinders) can be used for VSAM space. However, in a VM/VSE environment, mini disks containing VSAM data may reside anywhere on the 3390 Model 9 DASD.

SDAID: Register alteration trace in SDAID is dropped because ESA hardware does not offer the hardware facility.

Performance Considerations: VSE/ESA Version 2.1 performance and capacity has been enhanced in several areas:

Additional System/390 Support

The following System/390 performance aspects apply:

Support of System/390 hardware-assisted data compression
Support of System/390 multiprocessors

Hardware data compression, supported by VSE/VSAM will allow data compression at considerably lower additional CPU-time cost than equivalent software compression. DASD requirements for compressed VSAM data sets will be reduced. The same applies to the physical DASD I/Os, depending on the individual customer environment.

The VSE/ESA Turbo Dispatcher of VSE/ESA Version 2.1 focuses on S/390 entry and intermediate systems, without providing sophisticated balancing methods and dispatching granularity as, for example, provided by MVS/ESA or VM/ESA. Therefore the major benefits are expected to be in the area of up to 4 fully exploited processors, depending on the workload and the number of VSE partitions used in a customer environment.

More information on the VSE/ESA Turbo Dispatcher performance will be available at general availability of VSE/ESA Version 2.1 together with other performance information in a performance package VE21PERF on the IBMVSE tools disk, available to your IBM representative.

Virtual Storage Constraint Relief (VSCR)

The exploitation of 31-bit addressing, which was introduced with VSE/ESA Version 1.3, is continued and provides additional VSCR below the 16MB line:

VSAM access control blocks are moved above the 16MB line (Place Holder (PLH), Buffer Control Block (BCB), Buffer Subpool Header (BSPH), Buffer Header (BHD))
Shared space is moved above the 16MB line, for example, the move-mode transients, or console buffers and console support code
VSE/OCCF Version 1.5 now can run in private rather than shared space
31-bit PL/I applications via LE for VSE
Major VTAM (R) buffers moved above the 16MB line
DL/I parameter lists can reside above the 16MB line

This results in higher VSE capacity, and is of major benefit for individual CICS partitions. It also allows to further exploit Data In Memory (DIM) to save DASD I/Os and thus improve transaction response times.

VSE/POWER

Additional performance enhancements have been incorporated into VSE/ESA Version 2.1 for POWER spool handling.

The maximum block sizes of VSE/POWER data file and the size of the print output buffers as well as BSC/CTCA networking buffers have been increased. This allows a reduction of I/Os for spooling, printing, and networking, together with an improved track utilization of the spool data.

Viewing of POWER spool file entries has been enhanced significantly by a more intelligent file access. Also, POWER queue entries can be viewed concurrently by multiple users, so far this was not possible at all. Activity recording on the POWER spool files in a non-shared spooling environment has been improved by reducing queue file I/Os.

A new output segmentation macro IPWSEGM is offered with improved performance and usability compared to the present SEGMENT macro, enabling the caller to specify many more spooling parameters and/or to inherit spooling parameters from a previous segment. Also the application interface communication is improved with the user receiving important spooling information in a parameter list.

A limited failing user exit recovery is introduced to enhance system availability.

Miscellaneous

ESA-Mode-Only Supervisor: The provision of a single supervisor mode only (MODE=ESA) means that for existing MODE=VMESA guests under VM, MODE=ESA is implicitly used. This will result in a better overall ITR (Internal Throughput Rate), provided that the guest is run with reserved central storage (V=R/F) and with dedicated devices. In other cases, some overall ITR degradation will occur for such smaller VM/VSE guests. Further performance enhancements for VSE/ESA Version 2.1 are provided by, for example,

Full-ECKD support for fetch/load
Miscellaneous tracing enhancements

User Group Requirements: This announcement satisfies or partially satisfies a number of requirements from one or more of the worldwide user group communities, which include Australasian SHARE/GUIDE (ASG), COMMON, COMMON Europe, GUIDE International, G.U.I.D.E. Europe, Japan GUIDE/SHARE (JGS), Guide Latin America (LAG), SHARE Europe, and SHARE Incorporated.

GO4CPR92004 VSE/ESA multi-processor support GO4CPR93014 VSE/ESA multi-processor support ESDOSD93011 VSE/ESA multi-processor support

ESDOSD86254 Multiple console support ESDOSD86255 Routing of messages ESDOSD86256 Partition related consoles ESDOSD86258 Use of PF keys ESDOSD86259 Logged console lines should be selectable ESVSES88032 PF keys in VSE ESVSES88033 Enhancements in VSE system console support JOOS0792013 Installation option to set console auto-deletion ESVSES92002 Installation option to set console auto-deletion ASVSEX90005 Prevent VSE waiting if console in redisplay mode ESVSES92010 Improve IUI-Console Scroll Function GO4CPR88019 Multiple / alternate console GO4CPR88020 Console support GO4CPR88021 Console message handling GO4CPR88022 Console error recovery GO4CPR88041 OCCF should run in private space GO4CPR88054 ORIGination id for console input GO4CPR90039 Console command K to overrule others GO4CPR91002 K command defaults GO4CPR91024 IOSP console integration capability GO4CPR91041 Equalize weighting for dynamic partition GO4CPR90040 Multi console support GO4CPR89041 Display system activities on console GO4CPR93004 Write emergency messages fr. MIH to hardcopy file

GO4CPR93002 ES/9000 data compression support JOOS0093044 Extended storage and data compression

ESDOSD93002 Remove VSE/VSAM 4 GB Restriction GO4CPR93012 Remove VSE/VSAM 4 GB Restriction ESDOSD93019 If RSIZE >= VSIZE eliminate Page Data Set ESDOSD93024 Clean vendor exits GO4CPR92030 Executable RE-IPL program GO4CPR93001 POWER "SEGMENT" MACRO enhanced functionality GO4CPR93020 Add date/time info to DOSVSDMP scan list GGVS4094008 SVA MOVE mode phases should be in 31-bit SVA GGVS4094023 Provide significant software price reduction JOOS0093031 Display number of ICCF-library members (size ind)

Legend:

GO4CPR..... US GUIDE (until 1993) GGVS4O..... US GUIDE (since 1994)

ESDOSD..... European GUIDE (Germany) ESVSES..... European GUIDE (Nordic) JOOS0...... GUIDE Japan ASVSE...... GUIDE Australia

Planning Information

Customer Responsibilities:

Codepage Conversions Supported by LANRES/VSE:

Workstation Workstation Host Host Codepage Country Codepage Country

301 Japanese Kanji DB 300 Japanese Kanji DB (valid first byte 81-9F, E0-FC) 041 Japanese Kanji SB 1027 Japanese Latin SB

437 USA/Latin-1 037 USA/Canada/Netherlands/ Portugal/Brazil/Australia/ New Zealand/Others

437 USA/Latin-1 273 Austria/Germany

437 USA/Latin-1 280 Italy

437 USA/Latin-1 284 Spain/Latin America (Spanish)

437 USA/Latin-1 285 United Kingdom

437 USA/Latin-1 297 France

850 Latin-1 037 USA/Canada/Netherlands/ Portugal/Brazil/Australia/ New Zealand/Others

850 Latin-1 273 Austria/Germany

850 Latin-1 280 Italy

850 Latin-1 284 Spain/Latin America (Spanish)

850 Latin-1 285 United Kingdom

850 Latin-1 297 France

926 Korean DB 834 Korean DB (valid first byte 81-BF)

927 Traditional 835 Traditional Chinese DB Chinese DB

Future Software Support

CICS/VSE: CICS/VSE Version 2 will be the last version to support the macro level interface and internal control block access. The API and SPI enhancements of CICS Version 2 Release 3 will allow customers to migrate to a command-level-only version of CICS, and to develop command-level-only programs now.

CICS/VSE Version 2 will be the last version to support internal security. Customers requiring security will need an external security manager facility for future versions of CICS on the VSE/ESA platform, a basic form of this is intended to be provided as part of the VSE/ESA base program set.

The term, "External Security Manager" (ESM), refers specifically to any product, which implements the IBM RACROUTE interface via a Security Authorization Facility (SAF). It is intended that a future release of VSE/ESA will provide a SAF and that the basic ESM will implement its functions with RACROUTE.

Users requiring more comprehensive security facilities will require a product, which also implements its functions in this way. A utility is intended to be provided to extract all security related information from the control blocks of the customers' CICS system and from the Interactive Interface file.

BTAM-ES: Due to the new CICS program, BTAM-ES will be removed with a later release from the VSE/ESA Version 2 base program set.

Other Products: The product, NtuneMon Version 1 (5648-077) Release 1, previously announced on VSE/ESA Version 1 Release 3, is not supported on VSE/ESA Version 2.

Installability: A Fast Service Upgrade (FSU) path from VSE/ESA Version 1.3 to VSE/ESA Version 2.1 is supported.

Packaging: Depending on the order, a customer receives a package containing either of the following that contain the VSE/ESA Version 2 Release 1 base programs:

One magnetic tape with density 9/6250 bpi
One tape cartridge for a 3480 cartridge unit, or
One tape cartridge for a 9346 cartridge unit

Depending on the order, the package contains additional tapes/cartridges of the same format:

One or more tapes/cartridges for the optional programs, stacked one after the other on the medium.

Program directories for all component programs both, base and optional, are contained in the package as well, and one or more CD-ROM containing softcopy documentation.

Hardcopy documentation (manuals) are shipped separately.

Vendor Testing

IBM started early test opportunities for vendor products on VSE/ESA Version 2. This offering will allow software vendors to obtain early publications, access MACRO libraries, or test their products at an IBM tests center or remotely with this latest version of VSE/ESA before it is generally available. All software vendors are eligible to enroll in this program.

Software vendors can request to be placed on the VSE mailing list, or obtain assistance by contacting:

In the USA:

Phone: 914-435-3032 FAX: 914-433-3569 IBMMAIL: USIB1X2V

Security, Auditability, and Control

The announced programs use the existing security and auditability features of its components.

User management is responsible for evaluation, selection, and implementation of security features, administrative procedures, and appropriate controls in application systems and communication facilities.

ORDERING INFORMATION

The advance publications listed below will be available on October 14, 1994. To order, contact your IBM representative.

Order Title Number

VSE/ESA GIM Folder only GC33-6625 VSE/ESA GIM Introducing the System GC33-6626

The advance publications listed below will be available on December 30, 1994. To order, contact your IBM representative.

Order Title Number

GBOF number -- All GIM's and GIM Folder GC33-6625 VSE/ESA GIM What's New? GC33-6627 VSE/ESA GIM Planning Aspects GC33-6628

New Licensees

Orders for new licenses will be accepted now. Shipment will begin on the planned availability date. Orders that ship after the planned availability date will receive VSE/ESA Version 2 Release 1.

New users of VSE/ESA Version 2 Release 1 should specify:

Type Model

5690 VSE (SIPO SPO) 5686 066 5686 026 5648 099 5746 RC5 5747 DS2 5656 260

New users of LE for VSE should specify:

Type Model

5686 067

Note: This program is not part of the base package but is included in the optional 5690-VSE (SIPO SPO).

New users of COBOL for VSE should specify:

Type Model

5686 068

Note: This program is not part of the base package but is included in the optional 5690-VSE (SIPO SPO).

New users of PL/I for VSE should specify:

Type Model

5686 069

Note: This program is not part of the base package but is included in the optional 5690-VSE (SIPO SPO).

Basic License: To order a basic license, specify the program number and feature number 9001 for asset registration. For a graduated one-time charge or graduated monthly license charge specify one of the following feature numbers as applicable and corresponding to the processor group that contains the designated machine.

Specify the feature number 3501 for the Distributed Workstation Master. The workstation master cannot be used until a workstation feature one-time charge is ordered. Also specify the feature number of the desired distribution medium.

VSE Central Functions (5686-066)

Basic Basic Graduated Graduated Processor One-Time Charge Monthly License Charge Group Feature Number Feature Number

18 0020 0003 20 0021 0004 25 0022 0005 28 0023 0006 29 0024 0007 30 0025 0008 31 0026 0009 32 0027 0010 35 0028 0011 38 0029 0012 40 0030 0013 50 0031 0014 60 0032 0015 70 0033 0016 80 0034 0017 Language Environment for VSE (5686-067)

Basic Basic Graduated Graduated Processor One-Time Charge Monthly License Charge Group Feature Number Feature Number

18 0016 0001 20 0017 0002 25 0018 0003 28 0019 0004 29 0020 0005 30 0021 0006 31 0022 0007 32 0023 0008 35 0024 0009 38 0025 0010 40 0026 0011 50 0027 0012 60 0028 0013 70 0029 0014 80 0030 0015

COBOL for VSE (5686-068)

Basic Basic Graduated Graduated Processor One-Time Charge Monthly License Charge Group Feature Number Feature Number

18 0016 0001 20 0017 0002 25 0018 0003 28 0019 0004 29 0020 0005 30 0021 0006 31 0022 0007 32 0023 0008 35 0024 0009 38 0025 0010 40 0026 0011 50 0027 0012 60 0028 0013 70 0029 0014 80 0030 0015

PL/I for VSE (5686-069)

Basic Basic Graduated Graduated Processor One-Time Charge Monthly License Charge Group Feature Number Feature Number

18 0016 0001 20 0017 0002 25 0018 0003 28 0019 0004 29 0020 0005 30 0021 0006 31 0022 0007 32 0023 0008 35 0024 0009 38 0025 0010 40 0026 0011 50 0027 0012 60 0028 0013 70 0029 0014 80 0030 0015

Multiple Operating System -- PR/SM (MOSP): For a graduated one-time charge or graduated monthly license charge, specify the feature number, corresponding to the group that contains the designated machine.

VSE Central Functions (5686-066)

MOSP Basic MOSP Basic Graduated Graduated Monthly Processor One-time Charge License Charge Group Feature Number Feature Number

18 0101 0071 20 0102 0072 25 0103 0073 28 0104 0074 29 0105 0075 30 0106 0076 31 0107 0077 32 0108 0078 35 0109 0079 38 0110 0080 40 0111 0081 50 0112 0082 60 0113 0083 70 0114 0084 80 0115 0085

Language Environment for VSE (5686-067)

MOSP Basic MOSP Basic Graduated Graduated Monthly Processor One-time Charge License Charge Group Feature Number Feature Number

18 0046 0031 20 0047 0032 25 0048 0033 28 0049 0034 29 0050 0035 30 0051 0036 31 0052 0037 32 0053 0038 35 0054 0039 38 0055 0040 40 0056 0041 50 0057 0042 60 0058 0043 70 0059 0044 80 0060 0045

COBOL for VSE (5686-068)

MOSP Basic MOSP Basic Graduated Graduated Monthly Processor One-time Charge License Charge Group Feature Number Feature Number

18 0046 0031 20 0047 0032 25 0048 0033 28 0049 0034 29 0050 0035 30 0051 0036 31 0052 0037 32 0053 0038 35 0054 0039 38 0055 0040 40 0056 0041 50 0057 0042 60 0058 0043 70 0059 0044 80 0060 0045 PL/I for VSE (5686-069)

MOSP Basic MOSP Basic Graduated Graduated Monthly Processor One-time Charge License Charge Group Feature Number Feature Number

18 0046 0031 20 0047 0032 25 0048 0033 28 0049 0034 29 0050 0035 30 0051 0036 31 0052 0037 32 0053 0038 35 0054 0039 38 0055 0040 40 0056 0041 50 0057 0042 60 0058 0043 70 0059 0044 80 0060 0045

Note: The group can be determined by referring to the Exhibit for IBM System/370 and System/390 Machines (Z125-3901) or the Exhibit for Non-IBM Machines (Z125-3902) that are associated with the IBM Customer Agreement (Z125-4575).

Single Version Charging: To elect Single Version Charging, the customer must notify and identify to IBM the prior program and replacement program and the designated machine the programs are operating on.

Version-To-Version Upgrade Credit: To upgrade from a prior program acquired for a one-time charge to a replacement program using a Version-to-Version upgrade credit, the customer must notify and identify to IBM the applicable prior program and replacement program participating in the upgrade credit.

Basic Machine-Readable Material for VSE/ESA languages: To order LE for VSE (5686-067), select the feature number of the desired distribution medium (does not apply to 5690-VSE):

5801 magnetic tape 9/6250 bpi 5802 3480 tape cartridge 5804 1/4-inch tape cartridge

NLS Japanese:

5811 magnetic tape 9/6250 bpi 5812 3480 tape cartridge 5814 1/4-inch tape cartridge

NLS Mixed Case English:

5821 magnetic tape 9/6250 bpi 5822 3480 tape cartridge 5824 1/4-inch tape cartridge

To order COBOL for VSE (5686-068), select the feature number of the desired distribution medium (does not apply to 5690-VSE):

5801 magnetic tape 9/6250 bpi 5802 3480 tape cartridge 5804 1/4-inch tape cartridge NLS Japanese:

5811 magnetic tape 9/6250 bpi 5812 3480 tape cartridge 5814 1/4-inch tape cartridge

NLS Upper Case English:

5821 magnetic tape 9/6250 bpi 5822 3480 tape cartridge 5824 1/4-inch tape cartridge

To order PL/I for VSE (5686-069), select the feature number of the desired distribution medium (does not apply to 5690-VSE):

5801    magnetic tape 9/6250 bpi
5802    3480 tape cartridge
5804     1/4-inch tape cartridge

Basic Machine-Readable Material for 5690-VSE System Program Order: To order, select the feature number of the desired distribution medium. Basic machine-readable material for the individual licensed component programs will be shipped in 9/6250 bpi tape reels, 3480 tape cartridges or 1/4-inch tape cartridges as part of the 5690-VSE system program order.

Order feature numbers for VSE/ESA Version 2 base programs (to be specified under 5690-VSE) are:

1000    magnetic tape 9/6250 bpi
1001    3480 tape cartridge
1002     1/4-inch tape cartridge

Order feature number for VSE/ESA Version 2 optional programs (High-Level Identifiers, to be specified under 5690-VSE) are:

3401    9/6250 bpi magnetic tape
3405    3480 tape cartridge
3403     1/4-inch tape cartridge

VSE/ESA Version 2 Base Programs

5690-VSE SPO Unlicensed Publications Group Feature Program Number Number Description (1)

5686-066 VSE Central Functions 6.1.0 5686-026 CICS/VSE 2.3.0 7069 Networking Offering 7002 (2) High Level Assembler for VSE 7003 (2) 5648-099 DITTO/ESA for VSE 1.1.0 7000 5746-RC5 BTAM-ES 1.1.0 7001 5747-DS2 VSE/ICKDSF 1.16.0 (3) 5656-260 VSE/EREP 3.5.0 (3)

(1) Assign under 5690-VSE. (2) Ordering information will be provided before general availability. (3) These programs are no-charge programs and will be shipped automatically.

Basic License for Optional Program Programs: The optional programs are available under the (5690-VSE) VSE/ESA package offering. To order, specify the order feature number and the unlicensed publications group feature number under the 5690-VSE program number.

Unlicensed Publications Order Group Feature Feature Program Number Number Number Description (1) (1)

5648-040 VisualGen Developer 1.1.0 1005 7004 NLS Brazilian Portuguese 1143 NLS Korean 1144 5648-061 QMF/VSE Base 3.1.1 1007 7006 NLS French 1008 NLS Spanish 1009 NLS German 1010 NLS Italian 1011 NLS Swiss French 1012 NLS Swiss German 1013 NLS UC English 1014 NLS Brazilian Portuguese 1015 NLS Canadian French 1016 NLS Japanese 1017 NLS Korean 1018 NLS Simplified Chinese 1019 5648-063 ACF/NCP 3745 7.1.0 7007 Base, Tiers 1-5 1020 3749-900 NCP feature 1021 5648-076 VisualGen Wrkgrp Serv. 1.1.0 1022 7008 NLS German 1145 NLS Spanish 1146 NLS Swiss German 1147 NLS Brazilian Portuguese 1148 NLS Korean 1150 5648-078 VisualGen Host Serv. 1.1.0 1023 7009 NLS German 1151 NLS Spanish 1152 NLS Swiss German 1153 NLS UC English 1154 NLS Brazilian Portuguese 1155 NLS Japanese 1156 NLS Korean 1157 NLS Chinese 1158 5648-086 VisualGen Application Generator Option for VSE 1.1.0 (including 5648-041) 1029 7010 5648-109 VisualLift for MVS, VSE and VM 1192 7085 5666-270 DISOSS/370 for VSE 3.4.0 1025 7011 5666-318 PS/CICS-VSE 1.3.1 1027 7012 5666-329 CICSPARS/VSE 1.1.1 1030 7013

5668-719 X.25 NPSI 2.1.0 1032 7014 5668-723 GDDM-IVU 1.1.2 1033 7015 5668-738 ACF/NCP 3745+3720 5.4.0 7016 Base-Tier 1 1034 Tier 2 1035 Tier 2.5 1036 Tier 3 1037 Tier 4 1038 Tier 5 1039 5668-801 GDDM-IMD 2.1.2 1040 7017 5668-812 GDDM-PGF 2.1.2 1041 7018 5668-813 CSP/AD 3.3.0 1042 7019 PWS + NLS 1120 5668-814 CSP/AE 3.3.0 1043 7020 5668-854 ACF/NCP 3725 4.3.1 1044 7021 5668-958 VS COBOL II 1.4.0 COM, LIB, DEBUG 1045 7022 5686-011 CICSVR/VSE 1.1.0 1046 7023 5686-013 NetView FTP 1.1.1 1047 7024 5686-018 CICSDDM (VSE) 1.1.0 1048 7025 5686-022 DisplayWrite/370 2.1.0 1049 7026 NLS 1050 5686-040 PSF/VSE 2.2.1 1052 7028 B240LAT Fonts 1054 B240INTL Fonts 1055 U240LAT Fonts 1056 U240INTL Fonts 1057 B300LAT Fonts 1058 B300INTL Fonts 1059 4028METR Fonts 1060 5686-041 VSE/DSNX 2.1.2 1061 7029 5686-055 NetView for VSE 2.3.0 7030 CSF NV/VSE Base, ENU, EXT 1062 DSF NV/VSE Base, ENU 1063 CSF NV/VSE Japanese 1064 DSF NV/VSE Japanese 1065

(1) Assign under 5690-VSE.

Unlicensed Publications Order Group Feature Feature Program Number Number Number Description (1) (1)

5686-057 GDDM/VSE Base 3.1.1 1066 7031 NLS Danish 1067 NLS French 1068 NLS Italian 1069 NLS Norwegian 1070 NLS German 1071 NLS Spanish 1072 NLS Swedish 1073 NLS Brazilian Portuguese 1074 NLS Canadian French 1075 NLS Japanese 1076 NLS Korean 1077 NLS Traditional Chinese + Simplified Chinese 1078 5686-064 ACF/SSP for VSE 4.1.0 1079 7032 5686-066 VSE Central Functions 6.1.0 LANRES/VSE Function 1175 5686-067 LE for VSE 1.1.0 1141 7071 NLS Mixed Case English 1188 NLS Japanese 1189 5686-068 COBOL for VSE 1.1.0 1121 7060 NLS Mixed Case English 1190 NLS Japanese 1191 5686-069 PL/I for VSE 1.1.0 1122 7061 5686-073 ADSM 1.2.0 1119 7059 5686-075 ASF for VSE 3.1.0 Base 1080 7033 Base + NLS German 1180 Base + NLS French 1181 Base + NLS Dutch 1182 Base + NLS Spanish 1183 Base + NLS Danish 1184 DC Feature + NLS 1185 DW Feature + NLS 1186 5688-022 VS COBOL II Library only, 1.4.0 1081 7034 5688-023 VS COBOL II Compiler Lib 1.4.0 1082 7035

5688-035 X.25 NPSI 3.4.0 V3R3 VSE BASE 1083 7036 V3R3 VSE TIER 2 1084 V3R3 VSE TIER 2.5 1085 V3R3 VSE TIER 3 1086 V3R3 VSE TIER 4 1087 V3R3 VSE TIER 5 1088 5688-035 X.25 NPSI 3.7.0 1089 7037 5688-103 SQL/DS 3.4.0 7038 Base, English 1090 UC English 1091 French 1092 German 1093 Italian 1094 Spanish 1095 Japanese 1096 Chinese 1097 5688-187 C/370 Compiler 2.1.0 1098 7039 5688-188 C/370 Library 2.1.0 1099 7040 5688-190 PPFA/370 1.1.0 1100 7041 5688-191 OGL/370 1.1.0 1101 7042 5735-XXB EP 1.6.1 1102 7043 5735-XXB EP 1.8.0 1103 7044 5735-XXB EP 1.9.0 1104 7045 5735-XXB EP 1.12.0 1105 7046 5736-LM4 DOS PL/I Res Library 1.6.0 1106 7047 5736-LM5 DOS PL/I Trans Library 1.6.0 1107 7048 5736-PL1 PL/I Optional Comp. 1.6.0 1108 7049 5736-PL3 DOS PL/I Optional Comp 1.6.0 Composite 1109 7050 5746-CB1 DOS/VS COBOL Comp 1.3.1 + Lib including 5746-LM4 1110 7051 5746-RG1 DOS/VS RPG II 1.3.0 1112 7053 5746-SM3 DFSORT/VSE 3.1.0 1113 7054 5746-XC5 VSE/OCCF 1.5.0 1114 7055 5746-XE7 VSE/ACLR 1.2.1 1115 7056 5746-XXT SDF/CICS 1.5.0 1116 7057 NLS Japanese 1117 5746-XX1 DL/I DOS/VS 1.10.0 1118 7058

(1Assign under 5690-VSE.

Customization Options: Select the appropriate feature number(s) to customize your order to specify the delivery options desired. These features can be specified on the initial or MES orders, and should be ordered against 5690-VSE.

Example: If publications are not desired for the initial order, and for future updates, specify feature numbers 3470 to ship media only, and 3480 to ship media updates only. In the future if publication updates were required, order an MES to remove feature number 3480, and the publications will ship with the next release for the program.

Feature Description Number

Initial Shipments

Serial Number Only (suppresses shipment of media and documentation) 3444*

Ship Media Only (suppresses initial shipment of documentation) 3470

Ship Documentation Only (suppresses initial shipment of media) 3471

*     This feature number does not apply to 5690-VSE program orders.

Update Shipments

Ship Media Updates Only (suppresses update shipment of documentation) 3480

Ship Documentation Only (suppresses update shipment of media) 3481

Suppress Updates (suppresses update shipment of media and documentation) 3482*

*     This feature number does not apply to 5690-VSE program orders.

Expedite Shipments

Local IBM Office Expedite (for IBM use only) 3445

Customer Expedite Process Charge ($30 charge for each product) 3446

Expedite shipments will be processed to receive 72-hour delivery from the time IBM Software Manufacturing Solutions (ISMS) receives the order. ISMS will then ship the order via overnight air transportation.

DSLO License: To order a DSLO license, specify the program number, feature number 9901 for asset registration, and the feature number for graduated one-time charge or graduated monthly license charge that corresponds to the processor group containing the designated machine.

VSE Central Functions (5686-066)

DSLO DSLO Graduated Graduated Processor One-time Charge Monthly License Charge Group Feature Number Feature Number

18 0054 0037 20 0055 0038 25 0056 0039 28 0057 0040 29 0058 0041 30 0059 0042 31 0060 0043 32 0061 0044 35 0062 0045 38 0063 0046 40 0064 0047 50 0065 0048 60 0066 0049 70 0067 0050 80 0068 0051

Language Environment for VSE (5686-067)

DSLO DSLO Graduated Graduated Processor One-time Charge Monthly License Charge Group Feature Number Feature Number

18 0076 0061 20 0077 0062 25 0078 0063 28 0079 0064 29 0080 0065 30 0081 0066 31 0082 0067 32 0083 0068 35 0084 0069 38 0085 0070 40 0086 0071 50 0087 0072 60 0088 0073 70 0089 0074 80 0090 0075

COBOL for VSE (5686-068)

DSLO DSLO Graduated Graduated Processor One-time Charge Monthly License Charge Group Feature Number Feature Number

18 0076 0061 20 0077 0062 25 0078 0063 28 0079 0064 29 0080 0065 30 0081 0066 31 0082 0067 32 0083 0068 35 0084 0069 38 0085 0070 40 0086 0071 50 0087 0072 60 0088 0073 70 0089 0074 80 0090 0075 PL/I for VSE (5686-069)

DSLO DSLO Graduated Graduated Processor One-time Charge Monthly License Charge Group Feature Number Feature Number

18 0076 0061 20 0077 0062 25 0078 0063 28 0079 0064 29 0080 0065 30 0081 0066 31 0082 0067 32 0083 0068 35 0084 0069 38 0085 0070 40 0086 0071 50 0087 0072 60 0088 0073 70 0089 0074 80 0090 0075

Multiple Operating System -- PR/SM (MOSP): For a graduated one-time charge or graduated monthly licence charge, specify the feature number, corresponding to the group that contains the designated machine.

VSE Central Functions (5686-066)

MOSP DSLO MOSP DSLO Graduated Graduated Processor One-time Charge Monthly License Charge Group Feature Number Feature Number

18 0116 0086 20 0117 0087 25 0118 0088 28 0119 0089 29 0120 0090 30 0121 0091 31 0122 0092 32 0123 0093 35 0124 0094 38 0125 0095 40 0126 0096 50 0127 0097 60 0128 0098 70 0129 0099 80 0130 0100

Language Environment for VSE (5686-067)

MOSP DSLO MOSP DSLO Graduated Graduated Processor One-time Charge Monthly License Charge Group Feature Number Feature Number

18 0106 0091 20 0107 0092 25 0108 0093 28 0109 0094 29 0110 0095 30 0111 0096 31 0112 0097 32 0113 0098 35 0114 0099 38 0115 0100 40 0116 0101 50 0117 0102 60 0118 0103 70 0119 0104 80 0120 0105 COBOL for VSE (5686-068)

MOSP DSLO MOSP DSLO Graduated Graduated Processor One-time Charge Monthly License Charge Group Feature Number Feature Number

18 0106 0091 20 0107 0092 25 0108 0093 28 0109 0094 29 0110 0095 30 0111 0096 31 0112 0097 32 0113 0098 35 0114 0099 38 0115 0100 40 0116 0101 50 0117 0102 60 0118 0103 70 0119 0104 80 0120 0105

PL/I for VSE (5686-069)

MOSP DSLO MOSP DSLO Graduated Graduated Processor One-time Charge Monthly License Charge Group Feature Number Feature Number

18 0106 0091 20 0107 0092 25 0108 0093 28 0109 0094 29 0110 0095 30 0111 0096 31 0112 0097 32 0113 0098 35 0114 0099 38 0115 0100 40 0116 0101 50 0117 0102 60 0118 0103 70 0119 0104 80 0120 0105

Ordering a DSLO feature will result in IBM maintaining a record of this customer location as a DSLO user only. All material for the DSLO license must be ordered by the basic licensee. If a user selects DSLO, no other feature numbers are valid for this order and no program materials or updates will be shipped.

Entitled Publications for Licensees of VSE/ESA Version 2.1

IBM first announced its strategy for providing IBM documentation in online (softcopy) format in November 1991 (Software Announcement 291-649). This announcement also stated that as the strategy is implemented, on-line books would become the primary distribution format for IBM product information and the number of printed books distributed at no charge would be reduced.

On July 12, 1994, Software Announcement 294-431 described new implementation support for online books, including delivery of licensed documentation on collection kits (CD-ROM) and improved online print capabilities. The announcement also outlined how the reduction in the number of no-charge printed books would take place, starting in 1994. VSE/ESA Version 2.1 will begin a gradual implementation of this "hardcopy reduction" strategy:

Unlicensed publications automatically delivered with the system
Like with VSE/ESA Version 1, licensees of VSE/ESA Version 2.1 automatically will receive one copy of most unlicensed publications at no additional charge, including those publications necessary to install CICS/VSE 2.3. These will be part of the shipment they receive for VSE/ESA.
One copy of the CD-ROM, Online Library Omnibus Edition: VSE Collection (SK2T-0060) also will be delivered automatically, at no additional charge. It is no longer a separate feature which needs to be ordered separately. Additional copies of these books and the CD-ROM carry a charge.
Unlicensed publications delivered on request
Initial copies of the following publications also are available at no additional charge:
- Unlicensed publications for VSE/ICCF and LANRES/VSE
- The remaining unlicensed publications in the CICS/VSE 2.3 library
To receive initial copies of these unlicensed publications at no additional charge, customers must use a 7XXX feature code when placing their order.
Licensed publications delivered on request
For VSE/ESA Version 2.1 (including CICS/VSE 2.3), printed copies of licensed publications must be ordered using 8XXX feature codes. Printed copies of licensed publications generally will carry a charge and will not be automatically delivered with the system.
Note: The CD-ROM, SK2T-0060, will contain encrypted online versions of the licensed publications as they become available. Licensees of VSE/ESA Version 2.1 will be provided "keys" that enable them to encrypt and use the licensed publications with the rest of the online books on the disc.

In future releases, VSE/ESA will continue to follow the IBM strategy outlined in Software Announcement 294-431 to gradually reduce the number of printed books automatically delivered with the system.

Unlicensed Documentation: For VSE/ESA Version 2.1 a memo, program directory and one copy of the following publications are supplied automatically with the basic machine-readable material:

Publication Title Number

GBOF number - all GIM's and GIM folder GBOF-2300 GIM folder only GC33-6625 VSE/ESA GIM - Introducing the System GC33-6626 VSE/ESA GIM - What's New GC33-6627 VSE/ESA GIM - Planning Aspects GC33-6628

DWF User's Guide and Reference SC33-6538 VSE/ESA Turbo Dispatcher Guide and Reference* SC33-6599 VSE/ESA Licensed Program Specification GC33-6600 VSE/ESA System Upgrade and Service GC33-6602 VSE/ESA Planning SC33-6603 VSE/ESA Installation SC33-6604 VSE/ESA Administration SC33-6605 VSE/ESA Operation SC33-6606 VSE/ESA Messages and Codes SC33-6607 VSE/ESA Networking Support SC33-6608 VSE/ESA Programming and Workstation Guide SC33-6609 VSE/ESA Guide for Solving Problems SC33-6610 VSE/ESA Guide to System Function SC33-6611 VSE/ESA Unattended Node Support SC33-6612 VSE/ESA System Control Statement SC33-6613 Publication Title Number

VSE/ESA Diagnosis Tools SC33-6614 VSE/ESA System Macros User's Guide SC33-6615 VSE/ESA System Macros Reference SC33-6616 VSE/ESA System Utilities SC33-6617 VSE/ESA Library Guide, Poster GC33-6618 VSE/ESA Library Guide GC33-6619 VSE/ESA Master Index SC33-6620 VSE/ESA Quick Reference GX33-9026 VSE/ESA Extended Addressability SC33-6621 VSE/ESA Using the VSE Workdesk SC33-6622 LANRES/VSE Guide and Reference SC33-6623 VSE/ESA SW Vendor Prod.Directory GC33-6525 Online Library Omnibus Edition: VSE Collection SK2T-0060 VSE/VSAM Commands and Macros SC33-6631 VSE/VSAM User's Guide SC33-6632 VSE/POWER Administration + Operator Guide SC33-6633 VSE/POWER Remote Job Entry SC33-6634 VSE/POWER Networking SC33-6635 VSE/POWER Application Programming SC33-6636 REXX/VSE User's Guide SC33-6641 REXX/VSE Reference Guide SC33-6642 EREP User's Guide GC35-0151 EREP Reference GC35-0152 OLTEP Installation and Operations GC33-6156 TNL to: SN33-9363 Diagnosis Reference SY33-9105 ICKDSF User's Guide and Reference GC35-0033 ICKDSF SCP Specifications GC26-3946 ICKDSF Reference Summary GX26-3813

*     This publication becomes available in July 1995

The first copy of the following publication is supplied at no additional charge to licensees of basic material for VSE Central Functions (5686-066) by specifying the 7XXX publications group feature number under the 5690-VSE program number:

Publication Group Publication Feature Title Number Number

VSE/ICCF Primer SC33-6637 7082 VSE/ICCF Admin & Operation SC33-6638 7083 VSE/ICCF User's Guide SC33-6639 7084

The first copy of the following publications is supplied at no additional charge to licensees of basic material for CICS/VSE (5686-026) by specifying the 7XXX publications group feature number under the 5690-VSE program number:

Publication Group Publication Feature Title Number Number

7069 Release Guide GC33-0700 Intercommunication Guide SC33-0701 Reference and Restart Guide SC33-0702 Performance Guide SC33-0703 System Definition and Operations SC33-0706 Customization Guide SC33-0707 Resource Definition (Online) SC33-0708 Resource Definition (Macro) SC33-0709 Supplied Transactions SC33-0710 System Program Reference SC33-0711 Problem Determination Guide SC33-0716 Licensed Programming Specification GC33-0719 Security Migration Tools Guide SC33-1406

The first copy of the following publications is supplied at no additional charge to licensees of basic material for DITTO/ESA Release 1 (5648-099) by specifying the 7XXX publications group feature number under the 5690-VSE program number:

Publication Group Publication Feature Title Number Number

7000 User's Guide and Reference SH19-8221 Introducing GH19-8222 Reference Summary SX11-6110 Licensed Program Specifications GH19-8223

The first copy of the following publications is supplied at no additional charge to licensees of basic material for BTAM/ES (5746-RC5) by specifying the 7XXX publications group feature number under the 5690-VSE program number:

Publication Group Publication Feature Title Number Number

7001 Licensed Program Specifications GC38-0291 Programming Guide SC38-0293

LE for VSE (5686-067): A memo, and one copy of the following publications are supplied automatically with the basic machine-readable material:

Publication Title Number

Licensed Programming Specifications GC26-8061 Installation and Customization Guide SC26-8064 Debugging Guide + Run-Time Messages SC26-8066

Additional copies of unlicensed publications will be available from IBM by April 21, 1995. To order, contact your IBM representative.

The first copy is available at no charge to licensees of basic material by specifying the 7XXX feature number. Use the 8XXX feature number to order additional copies for a fee. Prices will be provided by April 21, 1995.

Single Additional Copy Copies Publication Feature Feature Title Number Number Number

Diagnosis Guide SC26-8060 7162 8142 Language Environment Fact Sheet GC26-4785 7160 8140 Language Environment Concepts Guide GC26-4786 7161 8141 Programming Guide SC26-8065 7163 8143 Reference Summary SX26-3835 7164 8144 Application Domain Collection Kit SK2T-1237 7117 NA

SBOF number with publications as listed below: SBOF-4835 Debugging Guide + Run-Time Messages SC26-8066 Programming Guide SC26-8065 Reference Summary SX26-3835

COBOL for VSE (5686-068): A memo, and one copy of the following publications are supplied automatically with the basic machine-readable material:

Publication Title Number

Licensed Programming Specifications GC26-8069 Installation and Customization SC26-8071

Additional copies of unlicensed publications will be available from IBM by April 21, 1995. To order, contact your IBM representative.

Single Additional Copy Copies Publication Feature Feature Title Number Number Number

General Information Manual GC26-8068 7165 8145 Migration Guide GC26-8070 7168 8148 Programming Guide SC26-8072 7166 8146 Language Reference SC26-8073 7167 8147 Reference Summary SX26-3834 7169 8149 Diagnosis Guide SC26-8528 7170 8150 Application Domain Collection Kit SK2T-1237 7118 NA

PL/I for VSE (5686-069): A memo, and one copy of the following publications are supplied automatically with the basic machine-readable material:

Publication Title Number

Licensed Programming Specifications GC26-8055 Installation and Customization SC26-8057 Compile-Time Messages and Codes SC26-8059

Additional copies of unlicensed publications will be available from IBM by April 21, 1995. To order, contact your IBM representative.

Single Additional Copy Copies Publication Feature Feature Title Number Number Number

Fact Sheet GC26-8052 7171 8151 Programming Guide SC26-8053 7172 8152 Language Reference SC26-8054 7173 8153 Migration Guide SC26-8056 7175 8155 Diagnosis Guide SC26-8058 7174 8154 Reference Summary SX26-3836 7176 8156 Application Domain Collection Kit SK2T-1237 7119 NA

Subsequent updates (technical newsletters or revisions between releases) to the publications shipped with the program will be distributed to the user of record for as long as a license for this software remains in effect. A separate publication order or subscription is not needed.

Displayable Softcopy Publications On CD-ROM for VES/ESA (5690-VSE): The VSE Collection Kit (SK2T-0060) offers a wide range of online books for VSE/ESA. It contains over 350 manuals, and libraries are added as new VSE-related programs are made available.

Besides manuals for VSE/ESA base programs, the CD-ROM also has online books for VSE/ESA optional programs, including VisualGen, PSF/VSE, and SQL/DS. In addition, special versions of READ/2, READ for Windows, and READ/DOS are on the disk. Thus BookManager READ does not need to be acquired separately.

A first "copy" of the CD-ROM is delivered automatically with the system at no additional charge. Additional copies carry a charge.

Form Title Number

Online Library Omnibus Edition: VSE Collection SK2T-0060

Displayable Softcopy Publications on CD-ROM for LE for VSE and COBOL for VSE: If you wish to receive one free copy of IBM Online Books for the Application Domain Collection Kit, please order one of the following optional feature numbers with the applicable program products:

Program Feature Program Name Number Number

LE for VSE 5686-067 7117 COBOL 5686-068 7118

In the United States, you may call the IBM Software Manufacturing and Delivery Field Support number, 800-879-2755 and, select the option for Software Assistance, to request an MES order for your customer. They will add the 7XXX feature to the customer's active license and ship a CD-ROM. Please supply them with the customer number, serial number, program number and feature number. Once your customer is registered for the 7XXX CD-ROM feature, it will guarantee the shipment of all future updates of the Softcopy CD-ROM Collection Kit.

Additional Copies: If you wish to order additional copies of the IBM Online Books for the AD/Cycle Collection Kit on CD-ROM, please place an order for program product 5636-PUB and add the following two feature numbers:

CDROM Annual Publication Charge Feature           2036
CDROM Media Feature                               5036

Additional copies can also be obtained via SLSS or PUBORD on a "bill as shipped" basis by ordering form number, SK2T-1237.

Licensed Documentation for VSE/ESA Version 2 Base Programs: Microfiche material is no longer offered. Viewing Program Listings (VPL) online has replaced the need for microfiche. With the VPL system entitled users all around the world are able to view both Program Temporary Fix (PTF) and base program listings electronically, 24 hours a day. VPL can be accessed via ServiceLink and Dial IBM. For details, ask your IBM representative.

The licensed material listed below will be available from IBM on July 31, 1995. Use the 8XXX feature number to order copies for a fee. To order, contact your IBM representative.

VSE Central Functions (5686-066)

Priced Form Number Title Feature (4)

8135 LY24-5195 VSAM Logic of AMS LN33-9366 TNL to LY24-5195 8109 LY24-5204 VSAM Space Mgmt SAM Logic 8110 LY33-9116 LIOCS Volume 1 8123 LY33-9118 LIOCS Volume 3 8133 LY33-9120 ICCF DRM LN33-9376 TNL to LY33-9120 8124 LY33-9125 VSAM Backup/Restore DRM LN33-9374 TNL to LY33-9125 8134 LY33-9130 VSAM Logic 8118 LY33-9157 LIOCS Volume 2 DRM LN33-9368 TNL to LY33-9157 8119 LY33-9159 LIOCS Volume 4 SAM for DASD DRM LN33-9369 TNL to LY33-9159 8122 LY33-9163 POWER DRM 8111 LY33-9164 Supervisor (external) 8112 LY33-9165 Logical Transients DRM 8113 LY33-9166 IPL and Job Control DRM 8115 LY33-9167 Error Recovery Transients 8116 LY33-9168 Serviceability Aids DRM 8114 LY33-9169 Linkage Editor DRM DRM 8117 LY33-9182 Librarian DRM 8121 LY33-9187 Vendor Guide 8136 LY33-9189 REXX/VSE Diagnosis Reference

(4) The licensed material listed below will be provided on July 31, 1995.

Prices will be provided on July 31, 1995.

Unlicensed Documentation for VSE/ESA Version 2 Optional Programs: Is available as announced with the individual programming announcements.

Licensed Documentation for VSE/ESA Version 2 Optional Programs: Is available as announced with the individual programming announcements.

TERMS AND CONDITIONS

Licensing: The programs in this announcement are licensed under the terms of the IBM Customer Agreement.

VSE Workdesk: The VSE Workdesk consists of a component, which executes on either a Windows 3.1 or OS/2 2.1 equipped programmable workstation. IBM grants licensees of VSE Central Functions (5686-066) permission to download to, and use, this component on all suitably configured programmable workstations connected to the designated machine on which VSE Central Functions is installed.

LANRES/VSE Function: The LANRES/VSE function consists of two components. One executes on the VSE/ESA host, the other one executes on a NetWare 3.12 or NetWare Version 4 equipped programmable workstation.

IBM grants licensees of VSE Central Functions (5686-066), LANRES/VSE function, to install and use the programmable workstation component on the suitably configured workstations connected to the designated machine on which the host component of the LANRES/VSE feature is installed.

Variable Charges Apply: Yes

System/390 Multiple Operating Systems -- PR/SM (MOSP): Charge Option Attachment applies for graduated charge programs licensed to a qualifying machine.

Installation License or Location License Applies: No. A separate license is required for each machine on which the licensed program materials will be used.

Educational Allowance: A 15% educational allowance is applicable toward eligible license charges and is available to qualifying institutions in accordance with the Educational Allowance Attachment.

The educational allowance may not be added to any other discount or allowance.

Volume Discount: Not applicable

Version Upgrades: Version-to-Version Upgrade Credits Apply: Yes.

Single Replaced Program(s) Replacement Program(s) Version Program Program Program Program Charging Number Name Number Name Applies

5686-028 VSE/SP 5686-066 VSE Central Yes Unique Code V5 Functions V6

5686-032 VSE/Advanced 5686-066 VSE Central Yes Functions V5 Functions V6

5686-033 VSE/POWER V5 5686-066 VSE Central Yes Functions V6

5686-034 VSE/Fast Copy V2 5686-066 VSE Central Yes Functions V6

5686-036 VSE/ICCF V3 5686-066 VSE Central Yes Functions V6

5686-037 VSE/VSAM V2 5686-066 VSE Central Yes Functions V6

5686-058 REXX/VSE 5686-066 VSE Central Yes Functions V6

5686-066 VSE Central To follow-on, if any Yes Functions V6

5686-026 CICS/VSE V2 To follow-on, if any Yes

5688-197 SAA AD/Cycle 5686-068 COBOL for VSE V1 Yes COBOL/370 V1

5686-068 COBOL for VSE V1 To follow-on, if any Yes

5688-198 SAA AD/Cycle 5686-067 Language Environment Language for VSE V1 Yes Environment/370 V1

5686-067 Language Environment To follow-on, if any Yes for VSE V1

5688-235 SAA AD/Cycle 5686-069 PL/I for VSE V1 Yes PL/I MVS and VM V1

5686-069 PL/I for VSE V1 To follow-on, if any Yes

Warranted: Yes

Licensed Program Materials Availability: Restricted Materials -- Yes. These licensed programs will be available with source licensed program material for some modules designated as RESTRICTED MATERIALS OF IBM. In addition, some modules will be available without source licensed program materials. These modules will be available in object code. The remaining modules will be available with source licensed program materials.

Please refer to the Licensed Program Specification (LPS) (GC33-6600), available on April 21, 1995 for the identity of those components with some or all modules available without source licensed programs materials.

Testing Period: Basic License -- Two months. DSLO -- Not applicable.

Program Services: Central Service, including the IBM Support Center, will be available until discontinued by IBM upon six months' written notice.

Central Service, including the IBM Support Center, for DSLO licenses will be provided only through the customer location designated for the basic license.

CHARGES

Contact your IBM representative for charges information for this announcement.

+     Trademark of Microsoft Corporation

VSE/ESA Version 2 Release 1 and VSE/ESA Languages -- PL/I, COBOL, LE

Table of Contents: