Feedback

CICS Transaction Server for VSE/ESA Release 1

Software Announcement
September 29, 1998
Announcement Letter Number: 298-373


Table of Contents:

(Corrected on October 7, 1998)

ESL Feature Number was added to the Ordering Information section.

At a Glance

CICS Transaction Server for VSE/ESA is a new version of CICS for the VSE/ESA environment that protects customer investment and delivers significant benefits to enable customers to grow and extend their applications. It includes CICS Server, CICS Universal Client and CICS Transaction Gateway function in a single product at a single price that offers:

  • Improved reliability and availability

  • Extensive virtual storage constraint relief

  • Additional application programming capabilities

  • Improved system management and administration

  • Flexible entry point into network computing and e-business, with a scalable and reliable growth path

  • Support for all models of Client/Server computing

  • Comprehensive client support for IBM and non-IBM platforms

  • A coexistence environment to aid migration from CICS/VSE Version 2 Release 3
-----------------------------------------
For ordering, contact:
  Your IBM representative, an IBM
  Business Partner, or IBM North America
  Sales Centers at
    800-IBM-CALL  Reference: LE010



Overview

CICS (R) Transaction Server for VSE/ESA Release 1 is the latest version of CICS for VSE/ESA.

CICS enables you to implement robust, business-critical e-business and client/server enterprise solutions across multiple hardware platforms and operating systems in a highly available, reliable and scalable manner.

CICS Transaction Server for VSE/ESA contains many new functions. In addition to protecting and extending your current investment in CICS, this new release restructures the CICS code base. This enables CICS Transaction Server for VSE/ESA to meet ever increasing demands on workload and positions it for further extensions in the future. This release also standardizes customization practices, to facilitate smooth migration in future releases.

New functions in this release improve application programming, system programming, system management, network computing and the reliability and integrity of your CICS system today. It also consolidates CICS for VSE into a strong position for the future.

The new product enables growth and access to new CICS functions without requiring customers to migrate to OS/390 (R). If you are currently running CICS/VSE (R) Version 2 Release 3, migrating to this new release will provide many benefits already available with CICS for MVS/ESA (TM). Key benefits include:

  • Exploitation of ESA/390 (TM) subsystem storage protection.

  • Extensive Virtual Storage Constraint Relief.

  • Expanded Application Programming Support including a new External CICS Interface (EXCI) and a Front End Programming Interface (FEPI).

  • System Management enhancements including Resource Definition Online (RDO) for files.

  • Shared data tables for improved performance and availability.

  • The CICS Web Interface (CWI) which provides direct access to CICS applications from the World Wide Web environment. Availability of this function will be announced at a later date.



Intended Customers

This product is primarily intended for existing CICS/VSE customers. This new release enables growth and access to new CICS functions without requiring customers to migrate to OS/390.



Key Prerequisites

CICS Transaction Server for VSE/ESA Release 1 will only work with VSE/ESA Release 2.4. To improve the ordering and installation process, CICS Transaction Server for VSE/ESA Release 1 is now only available as part of the VSE/ESA Version 2 Release 4 system package. The prerequisite software for CICS Transaction Server for VSE/ESA Release 1 is supplied as part of the VSE/ESA 2.4 system package.

CICS Transaction Server for VSE/ESA Release 1 runs on processors capable of supporting VSE/ESA Version 2 Release 4 (or upward compatible releases) only in ESA/390 mode.



Planned Availability Date

June 25, 1999*

*     Availability of the CICS Web Interface and 3270 bridge will be
      announced at a later date.

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

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: http://www.ibm.com



DESCRIPTION

CICS Transaction Server for VSE/ESA Release 1 is a major new version of CICS that incorporates a new code base designed to help VSE/ESA customers meet their ever increasing business demands and to support the associated growth of workload on their systems, both now and for the 21st century. As well as protecting and extending customer investments in CICS, CICS Transaction Server for VSE/ESA Release 1 provides increases in quality, reliability, integrity, serviceability, performance, function, and provides a foundation for future enhancements. This is achieved by using the proven code base restructured from CICS for MVS/ESA Version 4 as the basis of this new version of CICS for the VSE/ESA environment. CICS Transaction Server for VSE/ESA provides benefits in the following main areas:

  • New internal structure
  • Opportunities for growth
  • Investment protection
  • Increased availability
  • Improved system management
  • Improved recovery and restart mechanisms
  • Improved security services
  • Improved programming support
  • Improvements to intersystem communication
  • Additional network computing and e-business support
  • New product packaging



New Internal Structure

The new code base was produced using modern software engineering techniques and CICS code is now restructured to improve quality, reliability, serviceability, and to take advantage of the extended addressing capabilities of VSE/ESA for full 31-bit support. The restructured parts of CICS now consist of a number of domains. Domains are functionally isolated parts of CICS that communicate with the rest of the system, and with external applications, by means of strictly-defined, internal interfaces. This improves the reliability of CICS, makes problem determination easier, and limits the effects of program failures. Another improvement involves changes to the storage management algorithms, reducing the likelihood of "lack of storage" causing CICS to stall. Also, more CICS events are now subject to deadlock detection.



Opportunities for Growth

An important aspect of CICS Transaction Server for VSE/ESA Release 1 is the freeing of large amounts of virtual storage because, as part of the re-engineering of CICS code, most of the CICS nucleus and control blocks, are moved above the 16 MB line. All of this provides extensive virtual storage constraint relief.

Also, the introduction of support for shared data tables, which replaces the previous data tables facility, brings significant advantages in the areas of performance, throughput, and availability for VSAM file sharing and read-only operations. In addition, browse, generic key are now supported by Shared Data Tables. In CICS Transaction Server for VSE/ESA Release 1 there is improved support for multiregion operation (MRO) and intersystem communication (ISC).



Investment Protection

CICS Transaction Server for VSE/ESA Release 1 maintains upward compatibility, at both the object and source level, for applications that use the command-level API. It also provides MRO and ISC connectivity to earlier releases of CICS/VSE as well as continuing to provide connectivity to the other members of the CICS family, including support for the CICS Clients and Gateways.

As CICS Transaction Server for VSE/ESA Release 1 is based upon CICS for MVS/ESA V4.1, there is a high degree of compatibility between CICS for VSE/ESA and CICS for OS/390.

To assist in a smooth migration to this new version, IBM is providing the existing CICS/VSE Version 2 Release 3 as part of the new product package. It will be supported for operation alongside the new version on the same system image (the CICS coexistence environment). In addition, tools such as the Application Migration Aid, the DFHMSCAN utility and the Security Migration Aid will be provided as part of the new product package to assist in migration.



Increased Availability

The following functionality has been introduced into the product to improve availability:

  • CICS storage protection, which exploits ESA/390 subsystem storage protection and prevents CICS application programs from accidentally overwriting CICS code and control blocks.

  • VTAM (R) single-node persistent session support which enables a fast restart and indication to the end-user in the event of a CICS failure This requires the Inter-Enterprise version of VTAM to be installed.

  • Intersystem session queue management which detects that a partner CICS region is under stress and enables an exit program to take action to reduce queueing and maintain performance.

  • APPC LU6.2 persistent verification which enables a single sign-on to a remote host to remain valid over multiple conversations and improves performance.

  • Improvements to tracing facilities, dump facilities, and CICS messages including greater control over what information is traced or dumped, and how it is presented.



Improved System Management

CICS Transaction Server for VSE/ESA provides several improvements to system management as follows:

  • The extension of Resource Definition Online (RDO) to support VSAM files, remote files, local shared resource (LSR) pools, and shared data tables

  • The ability to share one CSD between CICS/VSE 2.3 and CICS Transaction Server for VSE/ESA Release 1.

  • The ability to discard resource definitions dynamically without the need for a cold start before the changes take effect

  • A dynamic transaction routing program to keep track of CICS-initiated transactions, and transactions that abend in an application-owning region (AOR)

  • An extended autoinstall facility to enable CICS to install programs, mapsets, partition sets and LU6.2 parallel sessions without prior definition of each resource

  • Automatic journal archiving, to enable timely copying of journals without operator intervention.

  • Monitoring and statistics enhancements to provide better control and to make it easier to relate resource usage information to transaction monitoring information

  • New utility program to help resolve in-doubt resources

  • Transaction Management enhancements

  • Removal of the need for SYSGEN at installation time



Data Management Facility

Data Management Facility (DMF) is a new facility provided as part of CICS Transaction Server for VSE/ESA Release 1.

DMF provides functions to write records to a data space and to interrogate the status of the data management facility. It also performs several additional functions including the automated off-loading of data from the data space to a VSAM ESDS file and responding to operator commands entered from the VSE/ESA Central console.

DMF may be used by any programs running under the VSE/ESA operating system to record data in a central repository (where data is stored in a predefined format known as SMF format).

DMF is controlled via command line input from a console, and data is written to it using an Assembler macro called DFHEWTM.

DMF runs in its own partition (which may be either a static or dynamic partition).

Please note that DFSORT (TM)/VSE or an equivalent SORT product is required to be able to analyze the statistics captured by DMF.



Improved Recovery and Restart Mechanisms

CICS Transaction Server for VSE/ESA introduces improvements to CICS recovery and restart as follows:

  • Recovery from failures that are detected during dynamic transaction backout (DTB)

  • Assured VSAM file integrity in the event of a DTB failure

  • A new automatic journal archiving mechanism

  • New options to control the logging of journal records that are used by forward recovery utilities

  • Simplified restart procedures



Improved Security Services

In CICS Transaction Server for VSE/ESA Release 1, security services are significantly redesigned and improved. The most significant change is that use is now made of external security managers (ESMs), and that CICS internal security is no longer supported. Security operations, such as definition of operator information and performing security checking are now delegated to an ESM that conforms to the RACROUTE interface. In addition to the introduction of support for ESMs, resource security checking for transactions started without a terminal and CICS command security checking is supported.



Improved Programming Support

The most significant change introduced is that the macro-level interface is discontinued to enable provision of a more robust environment for the strategic command-level API. Provided as part of the CICS Transaction Server for VSE/ESA Release 1, IBM provides tools to help convert existing macro-level application programs to command-level; the DFHMSCAN utility helps detect the presence of CICS macro calls and detects the use of ADDRESS CSA commands in load modules and the Application Migration Aid (AMA) helps convert your macro-level application programs to command-level.

In addition, the following main application and system programming enhancements are also provided:

  • Support for the Common Programming Interface for Communications (CPI-C) for use with distributed transaction processing

  • A Front End Programming Interface (FEPI) that enables a CICS application to be written to access other CICS applications without needing any changes to the latter

  • An External CICS Interface (EXCI) that permits a non-CICS program such as a VSE batch program, to call a CICS application using the CICS Distributed Program Link (DPL) model

  • The ability to cancel start requests

  • New shared data tables (SDT) support for CICS file control with associated API extensions. This provides several important advantages over the obsolete data tables facility, including performance, and the ability to share data between CICS regions

  • Extensions to EXEC CICS INQUIRE, SET, and PERFORM commands

  • An extension to EDF to make it easier to debug remote transactions

  • Enhancements to Basic Mapping Support (BMS) map definition macros for improved support for double-byte character sets

  • Improved access to CICS state data

  • New global user exits that allow user modification of commands including transient data control, interval control and temporary storage control

  • A new Exit Programming Interface (XPI) for use in extending the functions of CICS in ways not provided as part of the standard CICS system
Extensions to the command-level API offer:
  • Better security

  • The opportunity to use powerful testing and debugging facilities,

  • Reduced risk of overwriting CICS storage,

  • Application portability via the CICS family API.
In addition, access to the significant function provided by the command level API will enable new and extended applications to be developed to meet ever increasing business demands, both today and into the 21st century.



Improvements to Intersystem Communication

APPC support for the LU6.2 and CICS MRO have been improved as follows:

  • Dynamic Transaction Routing APPC enhancements

  • APPC (LU6.2) Transaction Routing enhancements

  • LU6.2 session security

  • Conversation state determination

  • MRO enhancements including, queuing performance, duplicate logon names for EXCI support, and ESM support for MRO link security



Additional Network Computing and e-business Support

Support for CICS Universal Clients and CICS Transaction Gateway: Refer to the Supplemental Information section for a detailed description of this function.

CICS Web Interface*: The CICS Web Interface allows web browsers to call programs in a CICS system using the hypertext transfer protocol (HTTP).

A web browser is an HTTP client. The web browser constructs an HTTP request, which is passed across the network to TCP/IP for VSE/ESA in the server. TCP/IP for VSE/ESA relays the request to the CICS Web Interface, which calls a CICS program to service the request. The output from the CICS program is sent back to the web browser in an HTTP response.

The CICS Web Interface can be used:

  • To allow web browsers to use existing CICS programs and the transaction processing services they provide.

  • To allow web browsers to use newly-created CICS programs that exploit the facilities of HTTP, and of the hypertext markup language (HTML).
The HTTP request is subject to the limitations of the remote procedure call model of distributed computing:
  • It is not possible to coordinate changes to recoverable resources in successive requests to the same CICS system.

  • Committing changes to recoverable resources is under the control of the CICS system, not the web browser.
The called program executes under a CICS transaction that has no principal facility. It is therefore not allowed to use some commands of the CICS application programming interface:
  • Terminal control commands that refer to the principal facility

  • Options of EXEC CICS ASSIGN that return terminal attributes

  • BMS commands

  • Signon and signoff commands
In addition the CICS Web Interface, in conjunction with the 3270 bridge, can be used to provide Web Browser access to existing 3270-based transactions without requiring any application changes.

3270 Bridge*: The 3270 bridge provides an interface to run 3270-based CICS transactions without a 3270 terminal. Commands for the 3270 terminal are intercepted by CICS and replaced by a messaging mechanism that provides a bridge between the end user and the CICS transaction.

With the bridge feature, an end-user application that may be executing outside the CICS environment can use transport mechanisms such as MQSeries (R) or the Internet to access and run a CICS 3270-based user transaction.

The end-user application can also be a CICS transaction, using, for example, a temporary storage queue to pass 3270 requests and data to a user transaction executing in the same CICS region. This provides an alternative to FEPI.

The user transaction can be an existing 3270 or BMS-based CICS transaction. It runs unchanged as if it were interfacing a real terminal.

*     Availability of the CICS Web Interface and 3270 bridge will be
      announced at a later date.



New Product Packaging

CICS Transaction Server for VSE/ESA provides a new version of CICS for VSE/ESA, CICS/VSE 2.3, CICS Universal Clients and CICS Gateway function in a single product, with one program number and one price.

Included in the CICS Transaction Server for VSE/ESA are the following components:

CICS/VSE Version 2 Release 3: During the transition to CICS Transaction Server for VSE/ESA Release 1, customers may want to have both CICS TS and CICS/VSE 2.3 active at the same time. VSE/ESA Version 2.4 accommodates that requirement. CICS/VSE version 2 Release 3 may be optionally selected in addition to CICS TS and there is no charge beyond the price of CICS Transaction Server for VSE/ESA Release 1. CICS TS and CICS/VSE Version 2 Release 3 may run independently, or be connected by MRO.

CICS Universal Clients Version 3.0: The IBM CICS Universal Clients Version 3.0 are developed from the CICS Clients Version 2. They are an all 32-bit product, delivered for the OS/2 (R), Windows NT (R), Windows (TM) 98, AIX (R) and Solaris platforms. They bring the any-to-any communication capabilities previously available only on Intel-based platforms also to AIX and Solaris.

The CICS Universal Clients also provide a range of functional enhancements, including a Security API, improvements to installation, and an application for workload management.

For more information refer to the Supplemental Information section.

CICS Transaction Gateway Version 3.0: The IBM CICS Transaction Gateway provides powerful mechanisms for enabling access from the Internet to the tried and trusted transactional capabilities of IBM CICS servers (including CICS Transaction Servers and TXSeries (TM) servers). The CICS Transaction Gateway uses the latest technologies, both HTTP and Java (TM) based, to link the open, object-oriented world of Web browsers on the Internet or an Intranet to the power, flexibility, integrity and robustness of CICS enterprise computing.

The CICS Transaction Gateway is provided for the OS/2 , Windows NT, AIXand Solaris platforms; it also supports Windows 98 for application development. It runs on the same system as the Web Server, and is capable of supporting a large number of concurrent users. It is an integrated product which incorporates the functions provided by the CICS Universal Clients Version 3.0, enabling communication with a wide range of CICS Servers.

The CICS Transaction Gateway enables any Internet-connected desktop workstation or Network Computer to provide access for your customers, your business partners, or your distributed sales force to your business-critical core corporate applications on CICS.

For information refer to the Supplemental Information section.

Report Controller Facility (RCF): Both the Report Controller Facility for CICS/VSE 2.3 and the Report Controller Facility for CICS Transaction Server for VSE/ESA are included in the product package for no additional fee.

RCF provides distributed control over printing and printer devices. It is designed so that anyone, with data processing skill and with no previous knowledge of CICS can control the printing of reports. By reports, we mean spool files managed by RCF via VSE/POWER.

End-user departments, operations staff, and programmers can use RCF in different ways to manage report production. Control over when, where, and how reports are printed, and by which printers, can be given to the people concerned with those reports and printers. Printers may be owned by CICS, or by VSE/POWER.

RCF provides:

  • Special options of the EXEC CICS SPOOL... commands, for writing programs to create reports.

  • An online tool for managing reports created either by using these commands, or by batch programs.

  • An interface that transfers reports to CICS printers.
As part of the VSE/ESA Version 2 Release 4 Limited Availability, CICS Transaction Server for VSE/ESA Release 1 will run an Early Support Program (ESP) in US and EMEA, from December 11, 1998, until General Availability (June 25, 1999).

Eligible customers who order the VSE/ESA Version 2 Release 4 product prior to GA will be invited to participate in the CICS Transaction Server for VSE/ESA Release 1 ESP.

It should be noted that the CICS Web Interface, 3270 Bridge, CICS Universal Clients Version 3 and CICS Transaction Gateway Version 3 will not be available as part of this ESP.



Year 2000

This product is Year 2000 ready. When used in accordance with its associated documentation, it is capable of correctly processing, providing, and/or receiving date data within and between the 20th and 21st centuries, provided all other products (for example, software, hardware, and firmware) used with the product properly exchange accurate date data with it.



PRODUCT POSITIONING

CICS Transaction Server for VSE/ESA Release 1, the latest version of CICS for VSE/ESA, is a member of the CICS family of application servers.

CICS enables customers to implement robust business-critical e-business and client/server enterprise solutions across multiple hardware platforms and operating systems in a highly available, reliable and scalable manner.

The CICS application server family provides:

  • Proven reliability, integrity, scalability, flexibility and performance

  • Application access from the World Wide Web over the Internet or Intranet

  • Desktop connection via comprehensive client support, including Lotus Notes (R)

  • Application portability across IBM and many non-IBM platforms

  • Management from a single point of control, even in complex configurations

  • A flexible entry point into e-business with a scalable and reliable growth path
Found at the heart of online networks, from small to very large, CICS opens the door for Internet/Intranet exploitation. CICS, is available on OS/390, MVS/ESA, MVS (TM), VSE/ESA, AIX, OS/2 and OS/400 (R), as well as non-IBM environments such as Windows NT, HP-UX, Solaris and Digital Unix. This provides an easy route to e-business and the ability to develop and implement applications on whichever platforms make the most business sense.

CICS Transaction Server for VSE/ESA Release 1 is a new version of CICS designed primarily to meet the needs of small and medium size enterprises. It is the successor to previous releases of CICS/VSE and CICS/DOS/VS, and is delivered with the VSE/ESA Operating System.

CICS Transaction Server for VSE/ESA Release 1 provides the benefits of the CICS family in a cost effective solution for customers who have chosen the VSE/ESA environment. It is a new version based on the proven strengths of CICS for MVS/ESA Version 4 Release 1 and offers increased quality, reliability, performance, functionality and growth capabilities over previous CICS/VSE versions.

With this new version, network computing and e-business enablement is now extended via provision of the CICS Web Interface (CWI)*. This option offers direct access from Web Browsers to CICS applications without the need for a separate web server, nor the need to change applications. The CICS Clients also provide network access to CICS applications from all popular workstations, and from Web Browsers via the CICS Transaction Gateway.

*     Availability of the CICS Web Interface will be announced at a
      later date.



HARDWARE AND SOFTWARE SUPPORT SERVICES



SmoothStart (TM)/Installation Services

Details of any SmoothStart or Installation Services will be announced before June 1999.

Trademarks

      MVS/ESA, ESA/390, DFSORT, TXSeries, MVS, and SmoothStart are
      trademarks of International Business Machines Corporation in
      the United States or other countries or both.
      CICS, OS/390, CICS/VSE, VTAM, MQSeries, AIX, OS/2, and OS/400
      are registered trademarks of International Business Machines
      Corporation in the United States or other countries or both.
      Windows is a trademark of Microsoft Corporation.
      Windows NT is a registered trademark of Microsoft Corporation.
      Java is a trademark of Sun Microsystems, Inc.
      Lotus Notes is a registered trademark of Lotus Development
      Corporation.
      Other company, product, and service names may be trademarks or
      service marks of others.



SUPPLEMENTAL INFORMATION

Also included with this product are the CICS (R) Transaction Gateway Version 3 and the CICS Universal Clients Version 3. Descriptions of both products follow.



CICS TRANSACTION GATEWAY VERSION 3



Description

The IBM CICS Transaction Gateway Version 3 is a key e-business enabling feature. It provides a robust, scalable, easy-to-use and secure complement to a Web Server, enabling multiple users at Web browsers or Network Computers to access business critical applications running on IBM CICS servers, including CICS Transaction Servers and TXSeries (TM) servers, using standard Internet protocols, in a range of configurations.

The CICS Transaction Gateway Version 3 incorporates, in a single integrated product, the CICS Universal Clients Version 3, which provide its functions for communication with CICS servers. There is no requirement for the separate installation of the CICS Universal Clients. All CICS Universal Client functions are available at a machine running the CICS Transaction Gateway.

The CICS Transaction Gateway also replaces and integrates two previous gateway functions: the CICS Internet Gateway (delivered, for the OS/2 (R) and Windows NT (R) platforms, as part of the CICS Clients Version 2); and the CICS Gateway for Java (TM) (available for download from the Internet, for use with the respective CICS Clients Version 2 or CICS for UNIX (R) Clients). The CICS Transaction Gateway is based on many years of experience with CICS Clients and Gateways in large numbers of demanding customer applications, and represents a streamlined and efficient implementation of the gateway functions.

The CICS Transaction Gateway Version 3 is provided for the OS/2, Windows NT, AIX (R), and Solaris platforms.

  • In addition, the CICS Transaction Gateway supports the Windows (TM) 98 platform (also Windows 95), for application development only; it is not supported for production use on this platform.
The CICS Transaction Gateway Version 3:
  • Provides the widest possible access to CICS business applications

    CICS Transaction gateway enables any Web browser, Network Computer or Internet-enabled consumer device to access business applications running on CICS servers. using one of three possible methods:

    1. All Web browsers support HTTP. The CICS Transaction Gateway will render existing CICS 3270 applications into HTML automatically, and transmit to the browser using HTTP. Customers can also create their own Java servlets which present information from CICS applications in HTML forms, customized as required.

    2. Java-enabled Web browsers can run Java applets. The CICS Transaction Gateway enables customer applets to access CICS 3270 applications and CICS programs using supplied Java classes and Java beans.

    3. ORB-enabled Web browsers can run Java beans which interoperate with server-side Java beans (running on the CICS Transaction Gateway) via the CORBA IIOP protocol. The server-side beans can then invoke CICS 3270 applications and CICS programs using supplied Java classes.
  • Supports easy development of customer solutions

    CICS Transaction Gateway provides a straightforward installation process that enables developers to set up and administer a gateway server easily. In the Windows NT environment, installation is performed using InstallShield.

    CICS Transaction Gateway provides an implementation of IBM's Common Connector Facility as a set of Java beans which integrate well into an Integrated Development Environment (IDE) such as IBM VisualAge (R) for Java. VisualAge provides a visual construction facility which allows beans to be connected together to rapidly create working solutions.

    It also provides implementations of IBM's well proven ECI (External Call Interface) and EPI (External Presentation Interface) programming interfaces in C, C++, and COBOL, and as COM objects.

  • Provides high performance and scalability

    The CICS Transaction Gateway is a highly optimized, multi-threaded Java application that can concurrently support large numbers of connected browsers with sub-second response times. It exploits the capabilities of the embedded CICS Universal Clients Version 3 for efficient communication with CICS servers, and can exploit the capabilities of SMP (Symmetric Multi-Processor) hardware for high transaction throughput. It also incorporates a sophisticated workload balancing facility which allows the transaction workload from a large population of browsers to be distributed across multiple CICS regions or CICS servers.

  • Provides comprehensive security capabilities

    The CICS Transaction Gateway provides comprehensive support for multiple aspects of security, which are critical to successful Internet operation. These are:

    1. Privacy, via implementations of SSL (Secure Sockets Layer), and of HTTP-S (HTTP over SSL). These encrypt data flowing between the browser and the Gateway server.

    2. Authentication, via built-in support for userids and passwords that are authenticated by CICS application servers. In addition, it provides an External Security Interface (ESI), which enables customer applications to verify userids and passwords and to change expired passwords.

    3. Authorization, which is provided as a standard function of each CICS server, enabling customers to control what transactions a given end user can run and what data that user can access.
  • Provides robust, multi-platform implementation

    The CICS Transaction Gateway provides a single, consistent Java implementation across multiple server platforms, exploiting the "write once, run anywhere" capability of Java, and based upon the new CICS Universal Clients Version 3, with their common 32-bit implementation running on multiple operating systems and communications protocols.

The CICS Transaction Gateway includes a set of Java EPI Beans for creating Java front ends for existing CICS 3270 applications, without any programming. This enables Java applications or applets to be created, simply by the use of a tool such as VisualAge for Java, which enable existing CICS applications designed for the use of 3270 terminals to interface with the Web browser or Java enabled environment.

A CICS Transaction Gateway (MVS (TM)) will be made available that provides direct access from a web server to CICS Transaction Server for OS/390 (R) Release 3 using the external CICS interface (EXCI).

CICS Universal Clients Version 3: The CICS Universal Clients, which are integrated into the CICS Transaction Gateway, are also available for separate installation. A description of the CICS Universal Clients Version 3 is included later in this section.

CICS Gateway for Java: The CICS Gateway for Java Version 2.0.1 remains available for download from the Internet, but it is only supported with the CICS Clients Version 2 and the CICS for UNIX Clients for the respective platforms, which also remain available. It is not supported with the CICS Universal Clients Version 3.

CICS Internet Gateway: The CICS Internet Gateway remains available for the OS/2 and Windows NT platforms in the CICS Clients Version 2, and for AIX in the Transaction Server for AIX, Version 4.1, the TXSeries, Version 4.2 for AIX, and on the CICS Clients Version 2.0.2 CD-ROM. It is not supported for use with the CICS Universal Clients Version 3.

CICS and Lotus Notes (R): The CICS Gateway for Lotus Notes (also referred to as the CICS Link for Lotus (R)), remains available in the CICS Clients Version 2. It is not included in the CICS Transaction Gateway. For interoperation of CICS and Lotus Notes, you are recommended to use the MQSeries (R) Enterprise Integrator, which has functional enhancements above the CICS Gateway for Lotus Notes. It offers a common API that can be used to integrate Lotus Notes with IMS (TM) or MQSeries as well CICS; it supports the EPI as well as the ECI; and it can be driven directly from a Web browser connected to Domino (TM). (Note that the CICS Transaction Gateway does not require the use of MQSeries in order to access CICS.) MQSeries Enterprise Integrator 1.0 is included in MQSeries and CICS Connections for Domino, part of the Lotus Domino.Connect (TM) family. For more information and to order, access:



Table 1: CICS Universal Clients V3 and CICS Transaction Gateway

Communication Support

The following table shows the communication capabilities with CICS servers for the CICS Universal Clients Version 3 and CICS Transaction Gateway Version 3.

For the licensing of the CICS Transaction Gateway for use with different CICS servers, refer to the Terms and Conditions section.

.------------+---------+---------+---------------------------.
|   CICS     |Platform |Commns.  |         Functions         |
|   Server   |  (1)    |Protocol |----+----+------+----+-----|
|            |         |T=TCP/IP |ECI |EPI | CICS | TN |Auto-|
|            |         |A=SNA    |    |    | 3270 |3270|In-  |
|            |         |X=TCP62  |    |    |Emuln.|    |stall|
|            |         |N=NetBIOS|    |    |      |    |     |
|            |         |D=DCE RPC|    |    |      |    |     |
|------------+---------+---------+----+----+------+----+-----|
|CICS/       |OS/2     |   A, X  | Y  |Y(2)| Y(2) |  Y |  Y  |
|ESAV4R1;    |         |         |    |    |      |    |     |
|CICS        +---------+---------+----+----+------+----+-----|
|Transaction |WindowsNT| A(4), X | Y  |Y(2)| Y(2) |  Y |  Y  |
|Server      |Windows98|         |    |    |      |    |     |
|for OS/390  +---------+---------+----+----+------+----+-----|
|V1R1 and    |AIX      |    A    | Y  |Y(2)| Y(2) |  Y |  Y  |
|later       +---------+---------+----+----+------+----+-----|
|            |Solaris  |   --    | -- | -- | --   | -- | --  |
|------------+---------+---------+----+----+------+----+-----|
|CICS        |OS/2     |   A     | Y  |  Y |   Y  |  Y |  Y  |
|Transaction +---------+---------+----+----+------+----+-----|
|Server for  |WindowsNT| A(4)    | Y  |  Y |   Y  |  Y |  Y  |
|VSE/ESA R1  |Windows98|         |    |    |      |    |     |
|            +---------+---------+----+----+------+----+-----|
|            |AIX      |    A    | Y  |  Y |   Y  |  Y |  Y  |
|            +---------+---------+----+----+------+----+-----|
|            |Solaris  |   --    | -- | -- | --   | -- | --  |
|------------+---------+---------+----+----+------+----+-----|
|CICS/VSE(R) |OS/2     |    A    | Y  |Y(3)| Y(3) |Y(3)| Y(5)|
|V2R3        +---------+---------+----+----+------+----+-----|
|            |WindowsNT|   A(4)  | Y  |Y(3)| Y(3) |Y(3)| Y(5)|
|            |Windows98|         |    |    |      |    |     |
|            +---------+---------+----+----+------+----+-----|
|            |AIX      |    A    | Y  |Y(3)| Y(3) |Y(3)| Y(5)|
|            +---------+---------+----+----+------+----+-----|
|            |Solaris  |   --    | -- | -- | --   | -- | --  |
|------------+---------+---------+----+----+------+----+-----|
|CICS/400(R) |OS/2     |    A    | Y  |  Y |   Y  |  Y |  Y  |
|and V3R1    +---------+---------+----+----+------+----+-----|
|later       |WindowsNT|   A(4)  | Y  |  Y |   Y  |  Y |  Y  |
|            |Windows98|         |    |    |      |    |     |
|            +---------+---------+----+----+------+----+-----|
|            |AIX      |    A    | Y  |  Y |   Y  |  Y |  Y  |
|            +---------+---------+----+----+------+----+-----|
|            |Solaris  |   --    | -- | -- | --   | -- | --  |
|------------+---------+---------+----+----+------+----+-----|
|Trans Server|OS/2     | T, A(6) | Y  |  Y |   Y  | Y  |   Y |
|for AIX V4  |Windows98|         |    |    |      |    |     |
|(7);CICS for+---------+---------+----+----+------+----+-----|
|Solaris     |WindowsNT|T, A(6), |    |    |      |    |     |
|V2.1.1;     |         |  D(12)  |    |    |      |    |     |
|CICS        +---------+---------+----+----+------+----+-----|
|for HP-UX   |AIX      | T, A(6) | Y  |  Y |   Y  | Y  |  Y  |
|V2.1.1;     +---------+---------+----+----+------+----+-----|
|Trans       |Solaris  |    T    | Y  |  Y |   Y  |  Y |   Y |
|Server for  |         |         |    |    |      |    |     |
|Windows NT  |         |         |    |    |      |    |     |
|V4(8);      |         |         |    |    |      |    |     |
|TXSeries    |         |         |    |    |      |    |     |
|V4.2 for    |         |         |    |    |      |    |     |
|Windows NT, |         |         |    |    |      |    |     |
|AIX,        |         |         |    |    |      |    |     |
|Solaris     |         |         |    |    |      |    |     |
|and HP-UX   |         |         |    |    |      |    |     |
'------------+---------+---------+----+----+------+----+-----'
.------------+---------+---------+---------------------------.
|   CICS     |Platform |Commns.  |         Functions         |
|   Server   |  (1)    |Protocol |----+----+------+----+-----|
|            |         |T=TCP/IP |ECI |EPI | CICS | TN |Auto-|
|            |         |A=SNA    |    |    | 3270 |3270|In-  |
|            |         |X=TCP62  |    |    |Emuln.|    |stall|
|            |         |N=NetBIOS|    |    |      |    |     |
|            |         |D=DCE RPC|    |    |      |    |     |
|------------+---------+---------+----+----+------+----+-----|
|Transaction |OS/2     | N.T, A  | Y  |  Y |   Y  |  Y |  Y  |
|Server      |WindowsNT|         |    |    |      |    |     |
|for OS/2    |Windows98|         |    |    |      |    |     |
|Warp V4     |---------+---------+----+----+------+----+-----|
|(9); CICS   |AIX      |  T, A   | Y  |  Y |   Y  |  Y |  Y  |
|Transaction |---------+---------+----+----+------+----+-----|
|Server      |Solaris  |    T    | Y  |  Y |   Y  |  Y |  Y  |
|for OS/2    |         |         |    |    |      |    |     |
|Warp V4.1   |         |         |    |    |      |    |     |
|(10);       |         |         |    |    |      |    |     |
|VisualAge   |         |         |    |    |      |    |     |
|CICS        |         |         |    |    |      |    |     |
|Enterprise  |         |         |    |    |      |    |     |
|Application |         |         |    |    |      |    |     |
|Development |         |         |    |    |      |    |     |
|for         |         |         |    |    |      |    |     |
|OS/2 and    |         |         |    |    |      |    |     |
|for Windows |         |         |    |    |      |    |     |
|NT (11)     |         |         |    |    |      |    |     |
'------------+---------+---------+----+----+------+----+-----'

Note: (1) The CICS Transaction Gateway for Windows 98 is supported for application development only and covers Windows 95 as well. (2) The CICS/ESA (R) V4R1 host requires PTFs UN90142 and UN90143. (3) The CICS/VSE V2R3 host requires PTFs UN90168 and UN90169. (4) Including via NetWare for SAA. (5) Only for dependent LU6.2 sessions. (6) Only with Transaction Server for Windows NT V4.0, TXSeries for Windows NT V4.2, Transaction Server for AIX V4.0, or TXSeries for AIX V4.2. (7) Transaction Server for AIX V4.0 contains CICS for AIX V2.1.1. (8) Transaction Server for Windows NT V4.0 contains CICS for Windows NT V4.0. (9) Transaction Server for OS/2 Warp V4.0 contains CICS for OS/2 V3. (10) CICS Transaction Server for OS/2 Warp V4.1 contains CICS for OS/2 V3.1. (11) In VisualAge COBOL V2.2 and VisualAge PL/I V2.1 (12) Only with TXSeries Version 4.2 for Windows NT, AIX, Solaris and HP-UX.



PUBLICATIONS

The following publications relate to the CICS Transaction Gateway Version 3:

                                                  Order
Book                                              Number

CICS Transaction Gateway SC34-5448 Version 3: Administration CICS Universal Clients SC34-5450 Version 3 for OS/2: Administration CICS Universal Clients SC34-5449 Version 3 for Windows: Administration Order Book Number

CICS Universal Clients SC34-5348 Version 3 for AIX: Administration CICS Universal Clients SC34-5451 Version 3 for Solaris: Administration CICS Universal Clients Softcopy Only Version 3: Messages CICS Family: Client/Server SC33-1435 Programming CICS Family: OO Programming SC33-1923 in C++ for CICS Clients CICS Family: OO Programming SC33-1924 in BASIC for CICS Clients

Hardcopy of these books (except CICS Universal Clients Version 3: Messages) is available for purchase. To order, contact your IBM representative or your dealer.

Displayable Softcopy Publications: All the books that are applicable to CICS Transaction Gateway will be shipped as part of the product in HTML format (filetype .HTM) for viewing using a Web browser; and in Acrobat format (filetype .PDF), for viewing and printing using an Adobe Acrobat reader. The Adobe Acrobat reader is shipped with the product.

In addition, programming reference information is supplied with the product in HTML format.

Softcopy publications in IPF format (filetype .INF) will not be provided.



Specified Operating Environment -- Hardware Requirements

The CICS Transaction Gateway Version 3, will run on any hardware capable of running the appropriate operating system and other prerequisite software.

Requirements for hard-file space for the CICS Transaction Gateway version 3 are in the region of:

CICS Transaction Gateway

OS/2 11 MB +5 MB for TCP62 Windows NT (also Windows 98/95) 11 MB +5 MB for TCP62 AIX 8 MB Solaris 8 MB



Specified Operating Environment -- Software Requirements

The CICS Transaction Gateway Version 3 supports the following Operating Systems:

For the CICS Transaction Gateway for OS/2:

  • OS/2 Warp Version 4
  • OS/2 Warp Server Version 4
For the CICS Transaction Gateway for Windows NT:
  • Windows NT Workstation Version 4.0, or later
  • Windows NT Server Version 4.0, or later
  • (Including versions for DBCS languages)
For the CICS Transaction Gateway for Windows 98 (for application development only):
  • Windows 98
  • Windows 95
  • (Including versions for DBCS languages)
For the CICS Transaction Gateway for AIX:
  • AIX Version 4.2.1, or later
  • AIX Version 4.3.1, or later
For the CICS Transaction Gateway for Solaris:
  • Solaris Version 2.5.1, or later
The CICS Transaction Gateway Version 3 runs on a Java-enabled platform, and requires the following minimum levels of Java Development Toolkit (JDK) installed:
  • OS/2: JDK 1.1.6, or later

  • Windows NT: JDK 1.1.6, or later, with JIT update

  • Windows 98/95: JDK 1.1.6, or later, with JIT update

  • AIX: JDK 1.1.6, or later

  • Solaris: JDK/JIT V1.1.6 for SPARC-based machines, or later, with native threads support for Solaris Version 2.5.1, or later
The CICS Transaction Gateway requires, for servlet functions, a Web Server that supports servlets. It has been tested with the following Web Servers:
  • Lotus Domino Go WebServer Release 4.6.2 (for OS/2 Warp, Windows NT, AIX, or Solaris)

  • Microsoft (TM) Internet Information Server (IIS) Version 4.0 (for Windows NT and Windows 98/95)

  • IBM Websphere Version 1.0 (for Windows NT, AIX, or Solaris)

  • Apache Version 1.3 (for AIX and Solaris)

  • Sun WebServer Version 1.0 (for Solaris)
The CICS Transaction Gateway may be used for HTML/HTTP functions with any Web Browser that supports HTML version 3. For use with Java functions, a JDK 1.1 compliant Java-enabled Web Browser is required; it has been tested with the following:
  • OS/2: Netscape Navigator Version 2.0.2 with 1.1 patch

  • Windows NT, 98,95: Internet Explorer Version 4.0.1

  • Windows NT, 98,95: Netscape Version 4.0.3 with 1.1 patch

  • AIX: Netscape Navigator Version 4.0.4

  • Sun: Sun HotJava (TM) Browser Version 1.1
The data for CICS Transaction Gateway for supporting products for communications, and for supported compilers and application development tools, is the same as that for Universal Clients. Refer to the CICS Universal Clients section for this information.



Technical Information -- Migration and Compatibility

Sample HTML pages are supplied to assist customers in getting started in using a Web Browser as an emulator for a 3270 CICS application. These may also be used to assist in migrating from the CICS Internet Gateway to the CICS Transaction Gateway.

Applications and applets written for use with any level of the CICS Gateway for Java will work with the CICS Transaction Gateway Version 3.

EPI and ECI applications written for the CICS Clients Version 2 for OS/2 or Windows NT, or for the CICS for UNIX Clients for AIX or Solaris, will work with the CICS Transaction Gateway Version 3.



Planning Information -- Availability

The CICS Transaction Gateway is not available separately. It is delivered as part of certain CICS server products, including the CICS Transaction Server for OS/390 Version 1 Release 3 and the CICS Transaction Server for VSE/ESA Release 1.

For use for application development, it is available in IBM VisualAge for Java Version 2.0.



Terms and Conditions

The CICS Transaction Gateway Version 3 may be copied to any number of workstations, without additional charge, for use only with the CICS Transaction Server for VSE/ESA Release 1. Copies of the CICS Transaction Gateway Version 3 obtained with CICS Transaction Server for VSE/ESA Release 1 are not licensed for use with any other CICS server.

Customers wishing to develop applications using the CICS Transaction Gateway should license IBM VisualAge for Java Version 2.0. For further information on VisualAge for Java Version 2.0, refer to Software Announcement 298-277 dated August 11, 1998.

Program Services: Available until January 31, 2001

These program services apply to the CICS Transaction Gateway Version 3, as delivered by any means.

To obtain the latest service level, contact the Service Support Center for your country. Alternatively, information on service support status and service levels can be obtained and the latest service levels can be downloaded from the Internet at:



CICS UNIVERSAL CLIENTS VERSION 3



Description

The new IBM CICS Universal Clients Version 3 replace the previous CICS Clients Version 2. They are for 32 bit platforms only. They add support for Windows 98, and introduce CICS Universal Clients on the AIX and Solaris platforms. This means that Clients on the AIX and Solaris platforms, like those on Intel platforms, may now communicate directly with the wide range of CICS servers supported by the CICS Universal Clients.

The CICS Universal Clients Version 3 for AIX and Solaris provide most of the same CICS Universal Client functions as are provided on the OS/2, Windows NT and Windows 98/95 platforms. Supported functions include:

  • Support for concurrent ECI and EPI

  • Provision of ECI and EPI System Management exits

  • Support for API tracing

  • The ability to link, to connect and to disconnect from multiple CICS servers concurrently, using one or more transport protocols for these connections.
For differences in supported functions, refer to the Migration and Compatibility section.

The CICS Universal Clients Version 3 introduce a security API. The External Security Interface (ESI) provides a client interface to APPC password expiration management (PEM).

The ESI is intended for use by CICS client applications that need to verify and change the password recorded by an external security manager for a specified userid. The external security manager is assumed to be accessible from a CICS server to which the CICS client is connected. The functions are:

    CICS_VerifyPassWord
    CICS_ChangePassWord
Use of the ESI eliminates the need for client application programmers to understand PEM data formats and communications server interfaces. These interfaces are described in detail in the CICS TS CICS RACF (R) Security Guide (SC33-1701).

CICS Universal Clients Version 3 for Windows NT and Windows 98/95 have moved to industry-standard installation by InstallShield. Benefits include installation in national languages. The CICS Universal Clients for AIX and Solaris are delivered as compressed tar files.

Enhancements to the function of the CICS Universal Client for Windows NT as a Windows NT service allow: (a) the entry of start-up parameters when started from the Service Control Panel; (b) the sending of CICS Client controls when running, where these do not have a default parameter.

The CICS Universal Clients for Windows NT and Windows 98 introduce a client program for workload management and failure handling between multiple CICS servers and CICS regions. The workload management program is driven by ECI and EPI user applications as well as CICSTERM and CICSPRNT.

The CICS Universal Clients Version 3 are supported for a single user only, at an end-user workstation connected to a CICS server in a configuration of two or more tiers. For functions involving multiple users, the CICS Transaction Gateway Version 3 should be used. The CICS Transaction Gateway incorporates the CICS Universal Clients for the respective platforms.

CICS Clients Version 2: The CICS Clients Version 2 continue to be available as a program package, for download from the Internet, and packaged with certain Transaction Servers, CICS Transaction Servers, and TXSeries servers. In particular, they are the only source of CICS Clients for the 16-bit platforms Windows 3.1 and DOS.



PUBLICATIONS

The following publications relate to the CICS Universal Clients Version 3:

                                                  Order
Book                                              Number

CICS Universal Clients SC34-5450 Version 3 for OS/2: Administration CICS Universal Clients SC34-5449 Version 3 for Windows: Administration Order Book Number

CICS Universal Clients SC34-5348 Version 3 for AIX: Administration CICS Universal Clients SC34-5451 Version 3 for Solaris: Administration CICS Universal Clients Softcopy Only Version 3: Messages CICS Family: Client/Server SC33-1435 Programming CICS Family: OO Programming SC33-1923 in C++ for CICS Clients CICS Family: OO Programming SC33-1924 in BASIC for CICS Clients

Hardcopy of these books (except CICS Universal Clients Version 3: Messages) is available for purchase. To order, contact your IBM representative or your dealer.

Displayable Softcopy Publications: All the books that are applicable to CICS Universal Clients are shipped as part of the product in HTML format (filetype .HTM) for viewing using a Web browser; and in Acrobat format (filetype .PDF), for viewing and printing using an Adobe Acrobat reader. The Adobe Acrobat reader is shipped with the product.

Softcopy publications in IPF format (filetype .INF) are not provided.



Specified Operating Environment -- Hardware Requirements

The CICS Universal Clients Version 3 will run on any hardware capable of running the appropriate operating system and other prerequisite software.

The support for the CICS Universal Clients Version 3 for OS/2, Windows NT, and windows 98 is for any IBM compatible machine. NEC PC 98 series hardware is also supported.

Requirements for hard-file space for the CICS Universal Clients Version 3 are in the region of:

OS/2                                8 MB
                                    + 5 MB for TCP62
Windows NT                          8 MB
                                    + 5 MB for TCP62
Windows 98/95                       8 MB
                                    + 5 MB for TCP62
AIX                                 4 MB
Solaris                             4 MB



Specified Operating Environment -- Software Requirements

The CICS Universal Clients Version 3 support the following Operating Systems:

For the CICS Universal Client for OS/2:

  • OS/2 Warp Version 4
  • OS/2 Warp Server Version 4
For the CICS Universal Client for Windows NT:
  • Windows NT Workstation Version 4.0 with Service Pack 3 applied, or later

  • Windows NT Server Version 4.0 with Service Pack 3 applied, or later

  • (Including versions for DBCS languages)
For the CICS Universal Client for Windows 98:
  • Windows 95
  • Windows 98
For the CICS Universal Client for AIX:
  • AIX Version 4.2.1, or later
  • AIX Version 4.3.1, or later
For the CICS Universal Client for Solaris:
  • Solaris Version 2.5.1, or later
For SNA Communications from CICS Universal Clients Version 3, the following communications products are required:
Universal
Client
Platform          Supporting products -- one of:

OS/2 IBM Communications Server for OS/2 Warp, Version 4.0, or later (including eNetwork (TM) Communications Server for OS/2 Warp, Version 5.0)

Windows NT Microsoft SNA Server Version 3 or later

IBM Communications Server for Windows NT, Version 5.0, or later (including IBM eNetwork Communications Server for Windows NT, Version 5.01)

IBM Personal Communications AS/400 (R) and 3270 for Windows NT, Version 4.11 with APAR IC16672, or eNetwork Personal Communications Version 4.2

Windows 98/95 Microsoft SNA Server Version 3, or later IBM Personal Communications AS/400 and 3270 for Windows 95, Version 4.11 with APAR IC17000, or eNetwork Personal Communications Version 4.2

AIX IBM Communications Server for AIX, Version 4.

For TCP/IP communication from CICS Universal Clients Version 3 on all platforms, support is included in the Operating System.

For NetBIOS communication from CICS Universal Clients Version 3 for OS/2, Windows NT, or Windows 98/95, support is included in the Operating System.

TCP62 support for the CICS Universal Client for OS/2 requires IBM eNetwork Communications Server for OS/2 Warp, Version 5.0; APAR JR11589 must be applied (which is part of fixpack csa5028)

With the CICS Universal Clients Version 3 for Windows NT and Windows 98, if SNA communications are required as well as TCP62, IBM eNetwork Personal Communications, Version 4.2 should be used.

For use of DCE with the CICS Universal Client for Windows NT, DCE Runtime Services are required. The DCE products supported are:

  • IBM DCE for Windows NT Versions 1.1.1 or 2.0

  • Digital DCE for Windows NT Version 1.1c

  • Gradient PC-DCE Version 2.0 for Windows NT/95, or later
Products with which LU alias names may be used are:
.----------------------------------+----+------+------.
|                                  |    |      |WIN98/|
|    Product                       |OS/2|WIN NT|  95  |
|----------------------------------+----+------+------|
| IBM Personal Communications      |    |   X  |  X   |
|----------------------------------+----+------+------|
| Microsoft SNA Server -- Client   |    |   X  |  X   |
|----------------------------------+----+------+------|
| Microsoft SNA Server             |    |   X  |      |
|----------------------------------+----+------+------|
| IBM Communications Server for    |    |   X  |  X   |
|  Windows NT -- Client            |    |      |      |
|----------------------------------+----+------+------|
| IBM Communications Server for    |    |   X  |      |
|  Windows NT                      |    |      |      |
|----------------------------------+----+------+------|
| IBM Communications Server for    | X  |      |      |
|  OS/2 Warp, Version 4, or later  |    |      |      |
|----------------------------------+----+------+------|
| NetWare for SAA Client (Note that|    |   X  |  X   |
|  with NetWare for SAA, LU names  |    |      |      |
|  can only be aliases)            |    |      |      |
'----------------------------------+----+------+------'

Password management using the PEM service transaction is supported using the following protocol drivers:

.-------------------------+-----------+-----------.
|    Client Platform      |   TCP62   |    SNA    |
|-------------------------+-----------+-----------|
|    OS/2                 |  CCLTCP62 |  CCLIBMSN |
|-------------------------+-----------+-----------|
|    Windows NT           |  CCLTCP62 |  CCLWNTSN |
|    Windows 98/95        |           |           |
'-------------------------+-----------+-----------'

The following compilers and application development tools are supported:

.-----------------+--------------------------------------.
|Client Platforms |                                      |
|-----------------+--------------------------------------|
|OS/2             | VisualAge C++ Version 3, or later    |
|                 | VisualAge PL/I Version 2.0, or later |
|                 | IBM REXX for OS/2                    |
|-----------------+--------------------------------------|
|OS/2, Windows NT,| VisualAge COBOL Version 2.1, or later|
|Windows 98/95    |                                      |
|-----------------+--------------------------------------|
|OS/2, Windows NT,| VisualAge for Java Version 2.0       |
|AIX              |                                      |
|-----------------+--------------------------------------|
|Windows NT,      | VisualAge C++ Version 3.5, or later  |
|Windows 98/95    | Microsoft Visual C++ Version 5.0,    |
|                 |  or later                            |
|                 | Micro Focus COBOL Version 4.0.26     |
|                 | Microsoft Visual Basic Version 4.0,  |
|                 | or later                             |
|-----------------+--------------------------------------|
|AIX              | IBM C for AIX and C Set++            |
|                 |  for AIX Version                     |
|                 |  3.1, or later                       |
|                 | IBM COBOL Set for AIX                |
|                 |  Version 1.1, or later               |
|                 | Micro Focus COBOL  Version 4.1.10    |
|-----------------+--------------------------------------|
|Solaris          | Sun WorkShop C++ Version 3.0         |
|                 | Micro Focus COBOL Version 4.0.05     |
'-----------------+--------------------------------------'



Technical Information -- Migration and Compatibility

ECI and EPI applications written for the CICS Clients on Intel platforms can be ported to the CICS Universal Clients for AIX and Solaris.

Application code written for the CICS for UNIX Clients for the AIX and Solaris platforms can be easily ported to the CICS Universal Clients for those platforms, but will usually require some minor recoding to allow for differences in names and return codes.

The CICS Universal Clients for AIX and Solaris, unlike the CICS for UNIX Clients for those platforms, do not have the Local Client interface for operating with the CICS servers on these platforms; they can only operate as local clients by using the TCP/IP interface.

Unlike the CICS for UNIX Clients for AIX and Solaris, the CICS Universal Clients for AIX and Solaris neither require nor support DCE.

The following are some of the principal differences between the CICS Universal Clients for AIX and Solaris, and those for Intel platforms:

  • The CICS 3270 emulators in the CICS Universal Clients for AIX and Solaris are 24x80 alphanumeric screens. There is no GUI support.

  • The CICS 3270 emulator in the CICS Universal Clients for AIX and Solaris does not support keyboard remapping for Alt shifted keys, Ctr/Act, Print Screen, Scroll Lock, or Pause; nor does it support field outlining.

  • The CICS Universal Clients for AIX and Solaris do not support NetBIOS or TCP62 communication.

  • At present the CICS Universal Client for Solaris Version 3 does not support SNA communication.

  • The CICS Universal Client for AIX uses the AIX SNA Side Information Profile to provide partner LU information.

  • The CICS Universal Clients for AIX and Solaris have a command line interface only.

  • The CICS Universal Clients for AIX and Solaris do not support REXX.

  • The CICS Universal Clients for AIX and Solaris do not have field outlining on CICSTERM.



Terms and Conditions

The CICS Universal Clients Version 3 may be copied free of charge to enable communication with any supported IBM CICS server, Transaction Server, CICS Transaction Server, or TXSeries server, with the exception of the servers listed below. Provided the CICS Universal Clients are used only with servers which are not on the exceptions list, customers are authorized to make copies of the CICS Universal Clients as program features.

The exceptions are:

  • CICS/ESA Version 4.1
  • CICS/VSE Version 2.3
If they are used to enable communication with either of these servers, a license is required for every copy made of the CICS Universal Clients. (Note: these licenses are not available at the present time).

When the CICS Universal Clients Version 3 are connected to a server that has use-based pricing, the appropriate number of use-based features for that server must be licensed.

Program Services: Available until January 31, 2001

These program services apply to the CICS Universal Clients Version 3 as delivered by any means.

To obtain the latest service level, contact the Service Support Center for your country. Alternatively, information on service support status and service levels can be obtained and the latest service levels can be downloaded from the Internet at:



EDUCATION SUPPORT

Descriptions of all classroom and self-study courses are contained in the Catalog of IBM Education and Training catalogs.

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

Open Enterprise: CICS Transaction Server for VSE/ESA provides the capability for distributed parts of an application to "converse" with one another.

It provides the Common Programming Interface for Communications (CPI-C) industry-standard interface from X/Open and supports the Advanced Program-to-Program Communication (APPC) protocol from IBM



TECHNICAL INFORMATION



Specified Operating Environment

Hardware Requirements: CICS Transaction Server for VSE/ESA will run on any IBM processor supported by VSE/ESA Version 2 Release 4, which runs in ESA mode only. These processors include Enterprise Systems Architecture/390 (R) (ESA/390 (TM)) processors that meet the requirements of the host operating system, CICS access methods and user application programs. System 370, System 370/XA and ESA/370 processors are not supported.

Software Requirements: All the prerequisite software required by CICS Transaction Server for VSE/ESA is in the VSE/ESA Version 2 Release 4 package.

DFSORT (TM)/VSE or an equivalent SORT product is a prerequisite of the statistics formatting utility.

Access Methods: CICS Transaction Server for VSE/ESA can only be run if the following access method is installed:

  • VTAM (R) Version 4 Release 2 (Program Number 5686-065)
Note: The Inter-Enterprise variant of VTAM is required if using Persistent Session Support. CICS Transaction Server for VSE/ESA does not support BTAM networks.

Database Products: CICS Transaction Server for VSE/ESA can be run with any of the following data base products:

  • DL/I for VSE Version 1 Release 11 (program number 5746-XX1)
  • DB2 (R) for VSE/ESA Version 5 Release 1 (program number 5648-158)
Programming Languages: CICS Transaction Server for VSE/ESA supports application programs that use the CICS command-level application programming interface (API) only, written in the following languages:
  • Assembler
  • C
  • COBOL
  • PL/I
Macro-level application programs must be converted to command-level using the tools and services provided, such as DFHMSCAN and the CICS/AMA utility.

CICS Transaction Server for VSE/ESA does not support RPG II.

Below is a list of compilers that are supported by CICS Transaction Server for VSE/ESA:

  • High-level Assembler Version 1 Release 3 (product number 5696-234)

  • IBM C for VSE/ESA Version 1 Release 1 (Product Number 5686-A01)

  • IBM COBOL for VSE/ESA Version 1 Release 1 (Product Number 5686-068)

  • IBM PL/I for VSE/ESA Version 1 Release 1 (Product Number 5686-069)

  • Language Environment for VSE/ESA Version 1 Release 4 (Product Number 5686-094)
Compatibility: CICS Transaction Server for VSE/ESA provides upward compatibility at source and phase level for command-level programs written in high assembler language, COBOL, and languages supported by Language Environment for VSE/ESA (LE/VSE) that executed correctly under CICS/VSE Version 2, subject to the constraints listed below:
  1. CICS Transaction Server for VSE/ESA does not support C/370 (TM) application programs compiled using the C/370 compiler. All such application programs must be recompiled using the IBM C for VSE/ESA compiler.

  2. CICS Transaction Server for VSE/ESA does not support PL/I application programs compiled using the DOS PL/I compiler. All such application programs must be recompiled using the IBM PL/I for VSE/ESA compiler.

  3. DOS/VS COBOL and VS COBOL II application programs are supported using LE/VSE compatibility support.
Performance Considerations: The overall performance of CICS Transaction Server for VSE/ESA R1 depends on the CICS workload characteristics and on its usage within the total system environment.

By moving many storage areas above the 16M line and by the introduction of more self-managed DSAs within an overall user specified limit, significant VSCR has been provided which increases the potential capacity of a CICS partition in VSE/ESA.

Total CPU-time per transaction versus CICS/VSE 2.3 is expected to increase by about 5% to 10% overall, depending on the type of transactions and CICS functions used.

However, new performance related enhancements (for example, separate VSAM LSR buffers for data and index, and shared Data Tables) may at least partly compensate for the required CPU-time to do online work.

For more information, visit the VSE/ESA homepage:

which will refer you to updated performance information after December 1998.

Disclaimer: The performance figures quoted here will need to be validated and updated (if required) as changes are still going into the product and therefore final performance is not presented here.

User Group Requirements: This announcement satisfies or partially satisfies nine 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 American (LAG), SHARE EUROPE, and SHARE Incorporated. Requirements satisfied include:

    REQ0061931
    REQ0061470
    REQ0058775
    REQ0057517
    REQ0054695
    REQ0046890-1
    REQ0046526
    REQ0045231
    REQ0049209
Since June 1998, CICS Transaction Server for VSE/ESA Release 1 hs participated in a Product Introduction Program (PIP). Two customer requirements raised during this beta test have also been satisfied by this release.



Planning Information

Packaging: CICS Transaction Server for VSE/ESA is shipped as part of the VSE operating system, on tape, in MSHP format.

Included in the CICS Transaction Server for VSE/ESA Release 1 are the following components:

  • CICS/VSE 4.1 -- the base CICS element of the CICS Transaction Server for VSE/ESA Release 1.
  • CICS/VSE Version 2.3
  • CICS Universal Clients Version 3.0
  • CICS Transaction Gateway Version 3.0
  • Report Controller Facility for CICS/VSE 2.3
  • Report Controller Facility for CICS Transaction Server for VSE/ESA
The Report Controller Facility was a priced feature on the previous release of CICS. It is now included in the price of the CICS Transaction Server for VSE/ESA Release 1.



Security, Auditability, and Control

The security and auditability features of the announced program include support for:

  • An external security management program
  • User exit authorization
  • Resource-level security
  • Command-level security
  • Terminal operator identification
  • Intersystem communication security
  • Journaling
  • Monitoring
  • Trace facilities
If sensitive data is sent over external communication facilities, user management may wish to consider the application of cryptography. The customer is responsible for evaluation, selection, and implementation of security features, administrative procedures, and appropriate controls in application systems and communication facilities.



ORDERING INFORMATION

The following advance publications will be available as indicated. To order, contact your IBM representative.

                     Order      Available
Title                Number     After

CICS Transaction GC34-5467 September 29, 1998 Server for VSE/ESA Brochure



New Licensees

Orders for new licenses will be accepted now.

Shipment will begin on the planned availability date.

Existing Customers who place orders prior to the planned availability date may be eligible to participate in an Early Support Program.

Orders that ship after the planned availability date will receive CICS Transaction Server for VSE/ESA Release 1.

New users of CICS Transaction Server for VSE/ESA Release 1 should specify:

         Type           Model

5648 054

Basic License

Table A: To order a basic license, specify the program number and feature number 9001 for asset registration. For graduated monthly license charge, specify the feature number below that corresponds to the group that contains the designated machine.

Also, specify the feature number of the desired distribution medium.

                           Basic
                     Graduated Monthly
                       License Charge
Group                  Feature Number

18 1402 20 1403 25 1404 28 1405 29 1406 30 1407 31 1408 32 1409 35 1410 38 1411 40 1412 50 1413 60 1414 70 1415 80 1416

Table C

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

                         MOSP Basic
                     Graduated Monthly
                       License Charge
Group                  Feature Number

18 1468 20 1469 25 1470 28 1471 29 1472 30 1473 31 1474 32 1475 35 1476 38 1477 40 1478 50 1479 60 1480 70 1481 80 1482

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

Entry Support License

                                                     ESL
                                Program          One-Time Charge
Description                     Number          Feature Number

CICS Transaction Server 5648-054 1528 for VSE/ESA Release 1

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: To order, select the feature number of the desired distribution medium.

The Basic Machine-Readable Material is only available as part of the VSE/ESA Version 2 Release 4 system product (5690-VSE). The feature number selected for the distribution media of VSE/ESA 2.4 also determines the media that CICS Transaction Server for VSE/ESA Release 1 is shipped on. For information the VSE/ESA 2.4 media feature codes are listed below.

                    Feature
Environment         Number         Distribution Medium

VSE/ESA 2200 Magnetic Tape 9/6250 bpi VSE/ESA 2201 3480 Tape Cartridge VSE/ESA 2202 4-mm DAT

Customization Options: Select the appropriate feature numbers to customize your order to specify the delivery options desired. These features can be specified on the initial or MES orders.

Example: If publications are not desired for the initial order, specify feature number 3470 to ship media only. For future updates, specify feature number 3480 to ship media updates only. If, in the future, publication updates are required, order an MES to remove feature number 3480; then, the publications will ship with the next release of the program.

                                                    Feature
Description                                         Number

Initial Shipments

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

Ship Media Only (suppresses initial 3470 shipment of documentation)

Ship Documentation Only (suppresses 3471 initial shipment of media)

Update Shipments

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

Ship Documentation Only (suppresses 3481 update shipment of media)

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

Expedite Shipments

Local IBM Office Expedite 3445 (for IBM use only)

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

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

Optional Machine-Readable Material: To order, select the feature number for the desired distribution medium:

                    Feature
Environment         Number         Distribution Medium

VSE/ESA 5210 4 MM-DAT-CRT VSE/ESA 6148 1/2CST-34BPI VSE/ESA 6149 1/4CRT-120M VSE/ESA 6147 TAPE-6250BPI

Optional material for CICS/VSE 2.3 can also be ordered quoting program number 5686-026 and the feature numbers listed below:

                    Feature
Environment         Number         Distribution Medium

VSE/ESA 5210 4 MM-DAT-CRT VSE/ESA 6147 TAPE-6250BPI VSE/ESA 6148 1/2CST-34BPI VSE/ESA 6149 1/4CRT-120M

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

                            DSLO
                     Graduated Monthly
                       License Charge
Group                  Feature Number

18 1436 20 1437 25 1438 28 1439 29 1440 30 1441 31 1442 32 1443 35 1444 38 1445 40 1446 50 1447 60 1448 70 1449 80 1450

Multiple Operating System -- PR/SM (TM) (MOSP): For a graduated monthly license charge, specify the following feature number below that corresponds to the group that contains the designated machine.

                         MOSP DSLO
                     Graduated Monthly
                       License Charge
Group                  Feature Number

18 1483 20 1484 25 1485 28 1486 29 1487 30 1488 31 1489 32 1490 35 1491 38 1492 40 1493 50 1494 60 1495 70 1496 80 1497

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 will be provided through the basic license location. If a user selects DSLO, no other feature numbers are valid for this order and no program materials or updates will be shipped.

Unlicensed Documentation: A memo, program directory and one printed copy of the following publications are supplied automatically with the basic machine-readable material:

                                                  Order
Title                                             Number

Release Guide GC33-1645 Messages and Codes VSE/ESA publication Customization Guide SC33-1652 Resource Definition Guide SC33-1653 Problem Determination Guide GC33-1663 CICS-Supplied Transactions SC33-1655 Application Programming Reference SC33-1658 Licensed Programming Specifications GC34-5464 System Programming Reference SC33-1659 Application Programming Guide SC33-1657 Security Guide SC33-1942 Migration Guide GC33-1646 Operations and Utilities Guide SC33-1654 System Definition Guide SC33-1651 Program Directory GI10-2508 Trace Entries Handbook SX33-6108

These publications are also available in softcopy format on the CD-ROM provided with the product.

Additional printed copies of unlicensed publications will be available for a fee immediately after availability.

Displayable Softcopy Publications: The following manuals are provided in displayable softcopy form on the licensed CD-ROM supplied with the product.

These displayable manuals can be used with the BookManager (R) READ licensed programs in any of the supported environments. Terms and conditions for use of the machine-readable files are shipped with the files. The files are also provided in PDF format which can be read and printed using Adobe Acrobat.

                                                  Order
Title                                             Number

External CICS Interface SC33-1669 Front-end Programming Interface SC33-1662 Intercommunication Guide SC33-1665 Application Migration Aid Guide SC33-1943 Recovery and Restart Guide SC33-1666 Performance Guide SC33-1667 Report Controller Planning Guide GC33-1941 Report Controller User's Guide GC33-1940 XRF Guide SC33-1671 CICS Family: Interproduct Communication SC33-0824 CICS Family Communicating from CICS on SC33-1697 System/390 Shared Data Tables Guide SC33-1668 Distributed Transaction Programming Guide SC33-1661 CICS Glossary (softcopy) GC33-1649 Master Index SC33-1648 User's Handbook SX33-6101 Sample Applications Guide SC33-1713 CICS CLients: Administration SC33-1792

If hardcopy versions of this set of manuals are required these can be obtained for a fee of $570 immediately after availability by quoting feature number 8013.

Licensed Documentation: The following licensed material will be available from IBM by June 25, 1999, and carry a cost when ordered in printed form. To order, contact your IBM representative.

The Diagnosis Reference and Data Areas are provided in softcopy format on the licensed CD-ROM supplied with the product.

                                          Price
                     Order       Feature  (in US
Title                Number      Number   dollars)

Diagnosis Reference LY33-6085 8011 $ 40.00 Data Areas LY33-6086 8012 38.50 Supplemental Data LY33-6085 8014 104.00 Areas

Subsequent updates (technical newsletters or revisions between releases) to the publications shipped with the product 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. The following publications will be available by July 23, 1999.

                                        Order
Title                                   Number       Language

Release Guide SD88-7171 Japanese Migration Guide SD88-7172 Japanese System Definition Guide SD88-7173 Japanese Customization Guide SD88-7174 Japanese Resource Definition Guide SD88-7175 Japanese Operations and SD88-7176 Japanese Utilities Guide CICS-supplied Transactions SD88-7177 Japanese Application Programming Guide SD88-7178 Japanese Application Programming SD88-7179 Japanese Reference System Programming Reference SD88-7180 Japanese Distributed Transaction SD88-7181 Japanese Programming Guide FEPI Guide SD88-7182 Japanese Problem Determination Guide SD88-7183 Japanese Intercommunication Guide SD88-7184 Japanese Recovery & Restart Guide SD88-7185 Japanese Performance Guide SD88-7186 Japanese Shared Data Tables Guide SD88-7187 Japanese External CICS SD88-7188 Japanese Interface Guide Report Controller User's Guide SD88-7189 Japanese Report Controller Planning Guide SD88-7190 Japanese Security Guide SD88-7191 Japanese CICS Application Migration Aid SD88-7192 Japanese Guide



TERMS AND CONDITIONS

Licensing: IBM Customer Agreement

Designated Machine: Not required

Variable Charges Apply: Yes

Indexed Monthly License Charge (IMLC) Applies: No

Installation License or Location License Applies: No

Usage Restriction Applies: No

Educational Allowance: Yes, to qualified education customers.

Volume Discount: Not applicable

Version-To-Version Upgrade Credits Apply: Yes

                                                      Single
Replaced Programs           Replacement Programs     Version
Program     Program         Program     Program      Charging
Number      Name            Number      Name         Applies

5746-XX3 CICS DOS/VS 5648-054 CICS Yes Transaction Server for VSE/ESA

5686-026 CICS/VSE V2 5648-054 CICS Yes Transaction Server for VSE/ESA

5648-054 CICS To a Yes Transaction follow-on, Server if any for VSE/ESA

Warranted: Yes

Licensed Program Materials Availability

  • Restricted Materials of IBM: Some
  • Non-Restricted Source Materials: Some
  • Object Code Only (OCO): Some
Publication that identifies
  • Supplementary Data Areas: LY33-6087
  • Availability Date: June 25, 1999
Testing Period: None. Two months for Basic License only

Program Services

Support Center applies:          Yes Access is available
                                  through the IBM Support
                                  Center

Available until discontinued: Six months written notice

Services for DSLO Licenses: Provided through Basic License location

Support Line: S/390 (R)



CALL NOW TO ORDER

To order, contact the IBM North America Sales Centers, your local IBM representative, or your IBM Business Partner.

IBM North America Sales Centers, our national direct marketing organization, can add your name to the mailing list for catalogs of IBM products.

 Phone:     800-IBM-CALL
 Fax:       800-2IBM-FAX
 Internet:  ibm_direct@vnet.ibm.com
 Mail:      IBM North America Sales Centers
            Dept. LE010
            P.O. Box 2690
            Atlanta, GA  30301-2690
 Reference: LE010

To identify your local IBM Business Partner or IBM representative, call 800-IBM-4YOU.

Note: Shipments will begin after the planned availability date.

Trademarks

      TXSeries, MVS, IMS, eNetwork, ESA/390, DFSORT, C/370, PR/SM,
      and PR/SM are trademarks of International Business Machines
      Corporation in the United States or other countries or both.
      CICS, OS/2, AIX, VisualAge, OS/390, MQSeries, CICS/VSE,
      CICS/400, CICS/ESA, RACF, AS/400, Enterprise Systems
      Architecture/390, VTAM, DB2, System/390, BookManager, and S/390
      are registered trademarks of International Business Machines
      Corporation in the United States or other countries or both.
      Windows and Microsoft are trademarks of Microsoft Corporation.
      Windows NT is a registered trademark of Microsoft Corporation.
      Java and HotJava are trademarks of Sun Microsystems, Inc.
      UNIX is a registered trademark in the United States and other
      countries exclusively through X/Open Company Limited.
      Domino and Domino.Connect are trademarks of Lotus Development
      Corporation.
      Lotus Notes and Lotus are registered trademarks of Lotus
      Development Corporation.
      Other company, product, and service names may be trademarks or
      service marks of others.