IBM CICS/VSE Version 2 Release 3

September 13, 1994
Announcement Number: 294-520


Document's Table of Contents:


Abstract

CICS/VSE(R) is a member of the CICS(TM) family of transaction processing monitors that includes a common application programming interface (EXEC CICS API) and inter-system communication between the CICS family of products.

CICS/VSE Version 2 Release 3 provides enhanced functionality to CICS users in the VSE environment and is a major base product component of VSE/ESA(TM) Version 2 Release 1.

This new release provides a platform that has enhanced programmer interfaces and support for LE for VSE/ESA and associated languages. In addition, it provides a tool to aid in the migration of customers from the use of internal CICS security to an external security manager (ESM) that will be required in subsequent versions.

The LE for VSE/ESA support makes COBOL and PL/1 compilers more affordable and enables other LE conforming language products to be made available on the VSE/ESA platform.

The CICS family is available on MVS, VSE, AS/400(R), OS/2(R) and on AIX(R) for the RISC System/6000(R) platforms.

Planned Availability Date: April 21, 1995

(R)   Registered trademark of International Business Machines
      Corporation
(TM)  Trademark of International Business Machines Corporation
IN BRIEF . . .

+-------------------------------------------------------------------+
|                                                                   |
| o  Common application programming interface (EXEC CICS API)       |
|                                                                   |
| o  Major base product component of VSE/ESA Version 2 Release 1    |
|                                                                   |
| o  Enhanced programmer interfaces                                 |
|                                                                   |
| o  Support for LE for VSE/ESA                                     |
|                                                                   |
| o  31-bit PL/1                                                    |
|                                                                   |
| o  Tool for migration from internal CICS security to external     |
|    security manager                                               |
|                                                                   |
| o  LE for VSE/ESA support makes 31-bit COBOL compiler more        |
|    affordable                                                     |
|                                                                   |
+-------------------------------------------------------------------+
DESCRIPTION

This release enables customers to position themselves to take advantage of the follow-on version (as stated in Software Announcement 294-160, dated April 6, 1994). Preparatory work can be performed, spreading the migration work that will be required to move to the follow-on version. This will be the long-term coexistence base for those customers or applications that cannot migrate to the following releases. No quantification of these benefits and individual functions is given.

LE For VSE/ESA Support

This is the implementation of support for LE for VSE/ESA. Business solution capability is enhanced by the provision of LE for VSE/ESA (5686-067) support. This enables a more affordable 31-bit COBOL (5686-069) and PL/1 (5686-069) to be implemented on the VSE/ESA Version 2 platform in the high level language environment available to the VSE/ESA customer. The provision of improvements to the API allows for the replacement of macro level calls with services previously unsupported in the command level interface.

CICS API and SPI Enhancements

To smooth the transition between CICS/VSE Version 2 and subsequent versions of CICS/VSE, additional application programming commands have been introduced to provide:

  • Command-level equivalents of functions that, until now, have been available as part of the macro-level programming interface only
  • Function equivalent to that in CICS/ESA
New options, RESP2 and CVDA, will be introduced on existing EXEC CICS commands. Customers will have more time to plan for migration to a command-level-only version of CICS/VSE.

Business solution potential is facilitated by these API and SPI enhancements. Customers will be able to develop applications using the command-level interface, which previously would have required the macro interface. Once done, these applications will then be able to run on subsequent versions of CICS/VSE and benefit from the increased functionality provided.

Investment protection is safeguarded by the continued affinity with CICS/ESA(R) and CICS/MVS(R), which was re-enforced in the recent statement of direction in Software Announcement 294-160, dated April 6, 1994. This direction is supported by the inclusion of an aid to the migration away from CICS internal security to an external security manager. Changes to the SPI, like those made to the API, allow customers to change over to the enhanced command level interface.

CICS Internal/External Security Migration Aid

CICS/VSE Version 2 is the last version of CICS/VSE to support internal security. In the future, customers requiring security will need to utilize an external security manager.

A utility is provided to extract all security related information from the control blocks of the customers CICS system and from the IUI control file.

Investment protection is provided by this utility as it provides help with the migration away from CICS internal security towards the use of an ESM replacement. This enables customers to move to the follow-on version.

Associated CICS Products

CICSPlex System Manager/ESA V1.1.1: CICS/VSE Version 2 Releases 2 and 3 can be managed remotely from CICSPlex SM running on CICS/ESA. The function provided gives access to most indications of CICS/VSE health and extends the concept of the single system image to this member of the CICS family. All major CICSPlex SM functions are provided:

  • Operations
  • Monitoring
  • Real-time analysis
  • Workload management
As with remotely managed systems on MVS, a CICS/VSE region can participate in workload management only as an application-owning region, not as a terminal-owning region (refer to Software Announcement 294-515, dated September 6, 1994).

PRODUCT POSITIONING

CICS/VSE is a member of the CICS family of application servers that enable customers to implement client/server solutions across multiple hardware platforms and operating systems, managing all the systems resources needed by business applications. The family members include a common application programming interface (EXEC CICS API) and inter-system communication between the family members. The CICS family is available on MVS, VSE, AS/400, OS/2 and AIX for the RISC System/6000 platform and is available on a number of non-IBM platforms.

These offerings enable many applications written in the common CICS API to be re-compiled to run on any of these platforms. This flexibility enhances customer and vendor ability to:

  • Place application and function in the optimal structure for their business
  • Use CICS trained programmers to write CICS applications for any of the above platforms
  • More quickly and reliably implement distributed and online transaction processing (OLTP) client/server business applications
CICS/VSE Version 2 Release 3 is the successor to previous releases of CICS/VSE and CICS/DOS/VS transaction processing in the VSE environment and is an integral part of VSE/ESA Version 2 Release 1.

VSE/ESA is a member of the ESA/390(TM) family of operating systems. It offers full-function transaction processing and batch capabilities. Alone, or in combination with VM/ESA(R), it is the primary system for small and intermediate data centers. VSE/ESA is also the ESA/390 offering for centrally managed, remote unattended systems.

Major subsystems such as ACF/VTAM(TM) and CICS/VSE are essentially common to VSE/ESA and MVS/ESA(TM). Combined with enabling products, VS COBOL II, LE for VSE/ESA languages, High Level Assembler, Cross System Product, VisualGen(TM) V1 and SQL/DS(TM), these allow the customer to develop applications that exploit capabilities common to both VSE/ESA and MVS/ESA environments, facilitating portability and protection of customer investment. For further information about VSE/ESA Version 2 Release 1 refer to Software Announcement 294-519, dated September 13, 1994.

Major enhancements, such as LE for VSE/ESA support, demonstrate IBM's commitment to continued investment in VSE.

STATEMENT OF GENERAL DIRECTION

A statement of direction covering the future of VSE/ESA and CICS/VSE was released on April 6, 1994 (refer to Software Announcement 294-160). The following CICS/VSE element of that statement of direction is reiterated here to take another opportunity of making customers aware of the changes planned and the fundamental nature of some of the adjustments that must be made to their systems.

Support for New Software Capabilities

CICS/VSE: The CICS family of products provides for robust transaction processing, client/server, or distributed applications. One of the traditional strengths of VSE has been a full function "industrial strength" CICS component with close affinity to the CICS on MVS. The current version of CICS/VSE is based on the CICS/MVS product.

CICS/ESA is the flagship of the CICS family and is designed to work with large System/390(R) systems. It provides increased capacity, improved integrity and serviceability, new function and usability, and provides a foundation for ongoing enhancements. Significantly, CICS/ESA exploits ESA/390 features such as subsystem storage protection and increased isolation of CICS application programs.

IBM intends to offer a new version of CICS on the VSE/ESA platform that is based on CICS/ESA and that will be functionally equivalent to it, with the exception of a small number of features not appropriate for the VSE/ESA platform. VSE/ESA and MVS/ESA will share a "common CICS base" that is the cornerstone of the CICS family.

The CICS/ESA product on which a new CICS/VSE version will be based was extensively re-engineered internally to improve its functionality and reliability. A consequence of this was that support for some old functions were dropped. Like CICS/ESA, a new version of CICS on the VSE/ESA platform will no longer provide support for:

  • The CICS macro-level application programming interface (API) or direct addressing of CICS control block fields
  • BTAM attached devices and controllers
  • CICS internal security
Customers should develop all new CICS applications using the command-level interface and ACF/VTAM(R) only. Migration of selected programs to these preferred interfaces should begin as well. In advance of the availability of the new version of CICS for the VSE/ESA platform, IBM intends to offer aids and/or services to assist users in migrating.

The current CICS/VSE Version 2 provides significant functional advantages over CICS/DOS/VS Version 1, and will be the platform for co-existence with the new version described in this statement for those applications using discontinued functions such as macro level interface and BTAM.

In addition, CICS/VSE Version 2 will be enhanced to improve the command-level interface to remove the need for customers to use the macro-level interface. This, together with the planned aids and services, will make CICS/VSE V2 the natural migration platform to the new CICS version for the VSE/ESA platform.

An announcement of a version of CICS/VSE based on CICS/ESA will not be made this year.

EDUCATION SUPPORT

Call IBM Education and Training at 800-IBM-TEACH (426-8322), for catalogs, schedules, and enrollments.

TECHNICAL INFORMATION

Specified Operating Environment

This product uses only existing attachment interfaces.

Hardware Requirements: CICS/VSE Version 2 Release 3 will run on any IBM processor supported by VSE/ESA Version 2 Release 1. (For further information refer to the VSE/ESA Version 2 Release 1 Software Announcement 294-519, dated September 13, 1994). A complete list of IBM processors supported by VSE/ESA Version 2 Release 1 can be found in the VSE/ESA Planning Manual (SC33-6603-00), available April 21, 1995. This manual also provides a list of devices supported including those devices newly added or removed.

Software Requirements: Operating systems required: all the prerequisite software required by CICS/VSE Version 2 Release 3 is in the VSE/ESA Version 2 Release 1 package. Of the required base software products available within VSE/ESA Version 2 Release 1, the user must have installed one of the following two teleprocessing access methods:

  • BTAM/ES Version 1 Release 1 (5746-RC5).
  • VTAM's new product offerings available with VSE/ESA 2.1. Details of these offerings will be provided at a later date.
Database Products: CICS/VSE Version 2 Release 3 can be run with any of the following database products:
  • DB2(R) for VSE and VM Version 3 release 2 or later (5688-103). Refer to the IBM Software Announcement 290-524 for SQL/DS direction for VSE/ESA.
  • DL/I DOS/VS 1.10 or later (5746-XX1).
Compilers and Tools: CICS/VSE Version 2 Release 3 applications can be compiled with any of the following compilers or application generators:
  • COBOL Compilers
    • VS COBOL II. For information relating to the support of VS COBOL II refer to VSE/ESA Version 2 Release 1 (Software Announcement 294-519, dated September 13, 1994)
    • DOS/VS COBOL Version 1 Release 3 (5746-CB1)
    • COBOL/VSE Version 1 (5686-068)
  • C/370(TM) Version 2 Compiler (5688-187) and Library (5688-188)
  • High Level Assembler for VSE R1.
  • DOS PL/I Optimizing Compiler and Library 1.6 (5736-PL3)
  • PL/1 VSE Version 1 (5686-069)
  • DOS/VS RPG II Compiler Version 1 Release 3 (5746-RG1). This function has been stabilized at CICS/DOS/VS Version 1 Release 5 level.
DP and Business Professional Support:
  • CSP/AD 3.3 (5668-813)
  • CSP/AE 3.3 (5668-814)
  • VisualGen V1 (refer to Software Announcements 294-335 and 294-336)
Other VSE Components and Optional Products:
  • VSE/POWER 6.1 for System Spool Interface support and for XRF support (5686-033)
  • SDF/CICS 1.5 for online definition of BMS map sets (5746-XXT)
  • CICSPARS/VSE 1.1.1 for analysis of CICS Monitoring Facility data (5666-329)
  • CICS VSAM Recovery/VSE (CICSVR/VSE) (5686-011), provides forward recovery of VSAM data sets used by CICS/VSE Version 2, and is upwardly compatible with CICS/DOS/VS Version 1 Release 7.
CICS/VSE Version 2 Release 3 has been assembled and verified with base and optional products of VSE only at the level supplied with VSE/ESA Version 1 Release 3, and is supported with these products at subsequent levels.

Distributed Program Link (DPL): Servers to a CICS/VSE Version 2 Release 3 client using DPL can be any of the following:

  • CICS/VSE Version 2
  • CICS/DOS/VS Version 1.7
  • CICS/ESA Version 3 and 4
  • CICS/MVS Version 2.1
  • CICS OS/2(TM) Version 1.20 and 2.0
  • CICS/400(TM)
  • CICS/6000(TM)
Clients to a CICS/VSE Version 2 Release 3 server using DPL can be any of the following:
  • CICS/VSE Version 2.2 and 2.3
  • CICS/ESA Version 3.3 and V4.1
  • CICS OS/2 Version 1.20 and 2.0
  • CICS/400
  • CICS/6000
Note that a PTF may be required for some of the above for compatibility.

ISC: CICS/VSE Version 2 Release 3 can communicate with any of the following CICS systems via Inter-System Communication (ISC):

  • CICS/DOS/VS Version 1.7
  • CICS/VSE Version 2
  • CICS/ESA Version 3and 4
  • CICS/MVS Version 2.1
  • CICS/OS/VS Version 1.7
  • CICS OS/2 Version 1.2 and 2.0
  • CICS/400
  • CICS/6000
Only CICS/VSE Version 2 Release 3 is recognized by a VSE/ESA 2.1 system. It is the only version of CICS that can be used for Multi-Region Operation (MRO).

Compatibility: For command- and macro-level application programs CICS/VSE Version 2 Release 3 is upwardly compatible with CICS/DOS/VS Version 1, CICS/VSE Version 2 Release 1 and CICS/VSE Version 2 Release 2 at both the source and object program level. Upward compatibility is also provided for basic mapping support (BMS) maps and mapsets unless stated otherwise in the release guides. To take full advantage of the enhancements provided in CICS/VSE Version 2 Release 3 customers are encouraged to convert existing macro-level programs to command level.

Limitations: For a full description of VSE/ESA Version 2 Release 1 limitations refer to Software Announcement 294-519, dated September 13, 1994. The following items are particularly relevant to CICS/VSE Version 2 Release 3.

VSE/ESA Turbo Dispatcher limits the maximum throughput for a single CICS partition to 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 multi-processors using the same central storage. Parallel Sysplex and the coupling link facility are not supported.

Performance Considerations: There are no new factors affecting CICS/VSE performance in this release.

User Group Requirements: The principal customer requirement answered by this release is that of LE for VSE/ESA support. However, the main significance of this release is to position customers so that the transition to the subsequent version of CICS/VSE is made easier.

Planning Information

Customer Responsibilities: Customers should read the CICS/VSE Version 2 Release 3 Release Guide for planning and evaluation purposes.

Installability: CICS/VSE Version 2 Release 3 is installed as part of VSE/ESA Version 2 Release 1. A complete installation must be done. VSE/ESA Version 2 Release 1 can be upgraded using Fast Service Upgrade (FSU) from VSE/ESA Version 1 Release 3.

Packaging: For details of packaging refer to VSE/ESA Version 2 Release 1 announced in Software Announcement 294-519, dated September 13, 1994.

Security, Auditability, and Control

The security and auditability features of CICS/VSE Version 2 Release 3 are:

  • Support for an external security management program
  • User exit authorization
  • Resource level access security
  • Terminal operator signon identification
  • Transaction initiation security
  • Journal, trace and monitoring facilities.
CICS/VSE Version 2 Release 3 supports Advanced Program-to-Program Communications (APPC) security architecture. A local CICS/VSE system can verify which other APPC system is binding sessions to it. Similarly, the remote user can be verified locally, and have control exercised over access to transactions and resources. APPC security also operates between one or more CICS systems.

If sensitive data is sent over external communication facilities, user management may wish to apply cryptography.

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 CICS/VSE Release Guide (GC33-0700) will be available April 21, 1995. To order, contact your IBM representative.

License Information

CICS/VSE Version 2 Release 3 is ordered as a part of VSE/ESA Version 2 Release 1. Refer to the VSE/ESA Version 2 Release 1 Software Announcement 294-519, dated September 13, 1994, for ordering information.

CICS/VSE Version 2 Release 2 will remain orderable as part of VSE/ESA Version 1 Release 3.

TERMS AND CONDITIONS

The terms for CICS/VSE Version 2 are licensed under the IBM Customer Agreement are unaffected by this announcement.

CHARGES

Refer to the VSE/ESA Version 2 Software Announcement 294-519, dated September 13, 1994, for pricing details.

One-Time Charge: Customers who pay a one-time charge for a licensed program receive enhancements and future releases, if any, at no additional charge. Significant new function may be offered as an optional feature and charged for separately. If a replacement program is announced and the customer elects to license the replacement program, a time-based upgrade credit may apply.

Variable Charges: The applicable graduated one-time charge or graduated monthly license charge will be based on the group of the designated machine on which the licensed program is licensed for use. If the program is designated to a processor in a group for which no charge is listed above, the charge of the next higher group listed applies.

For upgrades of one-time license charge licenses to a machine in a higher group, the upgrade charge will be the difference in the then current charges between the two groups. For downgrades of one-time license charge licenses to a machine in a lower group, there will be no adjustment or refund of one-time license charges paid.

For upgrades or downgrades of monthly license charge licenses, the monthly license charge applicable to the higher or lower group will apply.

Entry Support License/License to Use One-Time Charge: One-Time charge authorizes use only on IBM Entry End User/370 Machines.

For additional product information, refer to Software Announcement 290-513, dated September 5, 1990.