Software Announcement

September 21, 1999

IBM CICS Universal Clients Version 3.1 and CICS

Transaction Gateway Version 3.1 Offer Significant
Programming and Operational Enhancements

Overview Key Prerequisites At a Glance

CICS Universal Clients
Version 3.1 and CICS Transaction
Gateway Version 3.1 deliver new
functions with added support for new
hardware:
• IBM Network Stations
• IBM Netfinity  Servers
• Sun Sparc Ultra 5 and Sun Sparc
Ultra 10
CICS Universal Clients Version 3.1
is available for download from the
Internet and also available as a
program package.
The CICS Transaction Gateway
Version 3.1 is available for download
from the Internet for those with a
license entitlement for it.
CICS Universal Clients Version 3.1
requires one of the following: The CICS Universal Clients
Version 3.1 enhancements include:
• OS/2
• Windows NT • Support for new hardware
• Windows 98 (including • Programming enhancements
Windows 95) − Enhancements to C++ and
• AIX COM programming
• Solaris interfaces
− EPI extensions to support
Planned Availability Date extended terminal attributes
and signon capable
• October 29, 1999,for download terminals
from the Internet − Improved supplied sample
programs, including support
• November 5, 1999, for the
for IBM PL/I for Windows
program package
(NT)
• Operations support
− Improvements to installation
-- Integrated file for

The CICS Transaction Gateway configuration used by

Version 3.1 includes all the CICS Clients and Load
Universal Clients enhancements plus Manager
-- Graphical utility to aid
the following additions:
configuration of Universal
• Enhancement to Java  Clients
programming interfaces − Support for SNA transport
• Enhancements to the Common for Solaris Clients
Connector Framework classes for − Improved serviceability
CICS (trace) facilities
• Enable Gateway to run as an − Client control for
Windows NT service controlled/immediate restart
• Support for the OS/390 UNIX − Improvements to the Load
Systems Services (OS/390 UNIX) Manager for Windows
environment with enhanced
security and performance EXTRA! EXTRA! . . .
• Support for Transactional EXCI in Subscribe to IBM iSource, your electronic
the OS/390 environment source for customized IBM information!
Go to our Web site at
http://www.ibm.com/isource
or send an e-mail to
info@isource.ibm.com
with the word SUBSCRIBE in the body.

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.

IBM United States IBM is a registered trademark of International Business Machines Corporation. 299-277

Description
CICS Universal Clients
New functions in this release are:
• New hardware support for:
− IBM Network Stations
− IBM Netfinity Servers
− Sun Sparc Ultra 5 and Sun Sparc Ultra 10
• Programming enhancements
− Enhancements t o C + + a n d COM programming
interfaces. All functions supported by ECI, EPI and
ESI are now available through these interfaces.
− EPI extensions to support extended terminal
attributes and signon capable terminals, plus
Return Immediate processing
− Improved supplied sample programs, including
support for IBM PL/I for Windows NT
• Operations support
− Improvements to installation
-- Integrated file for configuration used by Clients
and Load Manager
-- Graphical utility to aid configuration of Universal
Clients (Configuration Wizard)
− Support for SNA transport for Solaris Clients
− Improved serviceability, with improved trace
facilities. These include additional trace points,
support for millisecond tracing and faster tracing.
− Client controls for controlled/immediate restart
− Improvements to the Load Manager for Windows
CICS Universal Clients Version 3.1 are also supplied with
various IBM transaction products and can be downloaded
over the Internet (subject to licensing restrictions). Refer
to the Licensing section.
CICS Transaction Gateway
The CICS Transaction Gateway Version 3.1 is for
customers who want a server-based integration solution
for CICS. It includes identical functional enhancements
to those in the CICS Universal Clients, plus the following
additions:
• Enhancement to Java programming interfaces
• Enhancements to the Common Connector Framework
classes for CICS
• Gateway enabled to run as an Windows NT service
• Support for the OS/390 UNIX Systems Services
(OS/390 UNIX) environment with enhanced security
and performance. This includes support for OS/390
System Secure Sockets Layer (SSL), user
authentication via an X.509 client certificate, and
mapping of client certificates to RACF  user ids.
• Support for the Transactional EXCI function of CICS
Transaction Server Version 1.3 in the OS/390
environment. This enables client ECI applications to
use extended units of work. Updates to other
resources within the OS/390 environment will be
coordinated by OS/390 Resource Recovery
Management Services (RRMS).
299-277
CICS Transaction Gateway for OS/390 Version 3.1: The
CICS Transaction Gateway for OS/390 Version 3.1, which
runs directly on OS/390 Version 2.5, or higher, using
OS/390 UNIX services, is included with the CICS
Transaction Gateway Version 3.1. It enables customers
to provide support for end users at Web browsers in a
two-tier configuration.
CICS Transaction Gateway for OS/390 Version 3.1 was
developed from, and replaces, the CICS Gateway for Java
(MVS ), which was shipped as a component of the CICS
Transaction Server for OS/390 1.2. It provides an API
which enables Java applets and Java servlets to
communicate using the CICS ECI interface. The CICS
Transaction Gateway for OS/390 converts this ECI
communication to access the CICS Transaction Server for
OS/390 using the External CICS Interface (EXCI).
The CICS Transaction Gateway for OS/390 Version 3.1
offers improved performance compared to the CICS
Gateway for Java (MVS).
The CICS Transaction Gateway is not available as a
separate product. It is delivered with (same) IBM
products, including:
• CICS Transaction Server for OS/390 Version 1
Release 3
• CICS Transaction Server for VSE Version 1
Release 1
• TXSeries Version 4.2 servers
• WebSphere Application Server Enterprise or Advanced
Edition V2.02, or later
• VisualAge  for Java Professional or Enterprise Edition
V2.0 or V3.0
• CICS Transaction Server for OS/2 Warp Version 4.1
These products give a license entitlement for the CICS
Transaction Gateway. If you want to license the CICS
Transaction Gateway for use with another supported CICS
server, it is recommended, as an economical way of doing
this, that you purchase a license for TXSeries Version 4.2
for Windows NT, AIX, Solaris, or HP-UX, or CICS
Transaction Server for OS/2 Warp, Version 4.1. Whatever
the platform supported by this product, the CICS
Transaction Gateway is provided for all its supported
platforms, including OS/390.
The CICS Transaction Gateway can also be downloaded
over the Internet by those who have a license entitlement
via the Web site below.
Additional information is available on the CICS Clients
and Gateways at the Internet Web site at:
http://www.ibm.com/software/ts/cics/platforms/
desktop/
Related Products
When the program package for CICS Universal Clients
Version 3.1 becomes available in November 1999, CICS
Transaction Server for OS/2 Warp Version 4.1 will ship
CICS Universal Clients Version 3.1 and CICS Transaction
Gateway Version 3.1 instead of the CICS Clients
Version 2.
For more information, refer to announcement material on
the products with which it is shipped, or to Web site:
http://www.ibm.com/software/ts/cics/platforms/
desktop/
-2-
 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 twentieth and
twenty-first centuries, provided that all products (for
example, hardware, software, and firmware) used with the
product properly exchange accurate date data with it.
The service end date for this Year-2000-ready product is
January 31, 2002.

Product Positioning
CICS Universal Clients Version 3.1 provides the basis for
IBM′s very successful Application Mining initiative. It
enables significant value to be brought to new desktop
applications by tapping the hidden assets existing in your
core enterprise applications.
It provides an easy and low-cost mechanism to enable
access to CICS applications for users at desktop
workstations. It can be used with CICS servers on all
platforms.
CICS Universal Clients provides support for a single user
at a desktop workstation. Where multiple users are
required, and in particular for access by multiple users
at Web browsers, the CICS Transaction Gateway
Version 3.1 should be used.
CICS Universal Clients Version 3.1 is the latest IBM
product for accessing CICS from desktop environments,
and should be used by those who are new to CICS Clients.
If you are already using CICS Clients Version 2.0 you may
prefer to use CICS Clients Version 2.0.8 while continuing
to roll out an existing installation. Migration to CICS
Universal Clients Version 3.1 is recommended in the
longer term.
The CICS Transaction Gateway is the latest IBM product
supporting e-business configurations with CICS. It
replaces and extends the functions previously provided
by the CICS Internet Gateway and the CICS Gateway for
Java
Customers using the CICS Internet Gateway or the CICS
Gateway for Java, which are not supported by CICS
Universal Clients Version 3.1, should continue to use
CICS Clients Version 2.0, but should consider migrating
to the CICS Transaction Gateway Version 3.1 at the
earliest opportunity.

Statement of Direction
Support for the HP-UX 11 environment will be made
available at a future date.
Trademarks

MVS and TXSeries are trademarks of International Business

Machines Corporation in the United States or other countries
or both.
CICS, Netfinity, OS/2, AIX, OS/390, RACF, and VisualAge are
registered trademarks of International Business Machines
Corporation in the United States or other countries or both.
Windows NT and Windows are trademarks of Microsoft
Corporation.
Java is a trademark of Sun Microsystems, Inc.
UNIX is a registered trademark in the United States and
other countries exclusively through X/Open Company
Limited.
Other company, product, and service names may be
trademarks or service marks of others.

-3- 299-277
 IBM US
Announcement
Supplemental Information
September 21, 1999

Publications Technical Information

All the books applicable to CICS Universal Clients and
CICS Transaction Gateway are provided in Acrobat
Specified Operating Environment
Portable Document format (filetype .PDF), for viewing and
printing using the Adobe Acrobat reader. Hardware Requirements: CICS Universal Clients
Version 3.1 will run on any hardware capable of running
The English .PDF books are provided in a single, the appropriate operating system and other prerequisite
platform-specific library, with search, covering both CICS software.
Universal Clients and CICS Transaction Gateway. This
library, along with the current Adobe Acrobat Reader, The support for the CICS Universal Clients Version 3.1 for
with search, is an installable option. Translated .PDFs are OS/2, Windows NT , and Windows 98 is for any
available on the product CD-ROM, but these are IBM-compatible machine.
stand-alone books and are not part of the library. Requirements for hard disk space for the CICS Universal
Language versions of the reader are not provided for Clients Version 3.1 are in the region of:
these, but may be obtained from the Adobe Acrobat Web
site. ┌──────────────────────┬──────────────────────────┐
│ Platform │ Hard File Space │
The .PDF library and individual English .PDFs can also be ├──────────────────────┼──────────────────────────┤
downloaded from the Web. For more information, refer │OS/2 │ 8 MB │
├──────────────────────┼──────────────────────────┤
to: │Windows NT │ 8 MB │
│ │ +5 MB for TCP62 │
http://www.ibm.com/software/ts/cics/ ├──────────────────────┼──────────────────────────┤
│Windows 98/95 │ 8 MB │
and follow the library link. │ │ +5 MB for TCP62 │
├──────────────────────┼──────────────────────────┤
In addition, hardcopy of these books (except CICS │AIX │ 4 MB │
Universal Clients Version 3.1: Messages and CICS ├──────────────────────┼──────────────────────────┤
│Solaris │ 4 MB │
Transaction Gateway Version 3.1: Messages) are └──────────────────────┴──────────────────────────┘
available for purchase. To order, contact your IBM
representative or your dealer. However, the hardcopy
books may be at a lower level than the .PDFs available Software Requirements: Information on software
from the referenced Web site. requirements previously announced for Version 3.0
The books are: remains valid, except as described below. For this
information, refer to Software Announcement 299-058,
┌──────────────────────────────────────────────┬────────────┐ dated March 9, 1999, and to Software Announcement
│ Title │Order Number│ 298-378, dated September 29, 1998.
├──────────────────────────────────────────────┼────────────┤
│CICS Universal Clients V3.1 │ │ For SNA communications with the CICS Universal Clients
│ Administration for Windows (TM) │SC34─5449 │
│ Administration for OS/2 (R) │SC34─5450 │ for Windows 98, IntranetWare for SAA, Version 3 is
│ Administration for AIX (R) │SC34─5348 │ supported.
│ Administration for Solaris │SC34─5451 │
│ Messages │ │ For SNA communications with the CICS Universal Clients
│ C++ Programming** │SC33─1923 │ for Windows NT and Windows 95, NetWare for SAA
│ COM Automation Programming** │SC33─1924 │ Version 2.20, with APAR JP10793, or later, or
├──────────────────────────────────────────────┼────────────┤
│CICS Family: Client/Server Programming │SC33─1435 │ IntranetWare for SAA, Version 3, are supported. The
├──────────────────────────────────────────────┼────────────┤ support for eNetwork  Personal Communications
│CICS Transaction Clients V3.1 │ │ includes Version 4.3.
│ Administration for Windows │SC34─5589 │
│ Administration for OS/2 │SC34─5590 │ For use of DCE with the CICS Universal Client for
│ Administration for AIX │SC34─5591 │
│ Administration for Solaris │SC34─5592 │ Windows NT, DCE Runtime Services are required. The
│ Administration for OS/390 (R) │SC34─5528 │ DCE products supported are:
│ Messages │ │
│ Programming │SC34─5594 │ • IBM DCE for Windows NT Version 2.2
├──────────────────────────────────────────────┴────────────│ • Gradient PC-DCE Version 2.2 for Windows NT/95, or
│**CICS Clients Version 2 users need the (─00) level of │ later
│ these books: │
│ CICS Family: OO Programming in C++ for CICS Clients │
│ CICS Family: OO Programming in BASIC for CICS Clients │
└───────────────────────────────────────────────────────────┘

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.

IBM United States IBM is a registered trademark of International Business Machines Corporation. 299-277
The following compilers and application development http://www.sun.com/solaris/jre/index.html
tools are supported:
This program when downloaded from a Web site, contains
┌────────────────────┬──────────────────────────────────────┐ the applicable IBM license agreement, and License
│ Client Platforms│Software Supported │ Information (LI), if appropriate, and will be presented for
├────────────────────┼──────────────────────────────────────┤
│OS/2 │VisualAge (R) C++ Version 3.0, │ acceptance at the time of installation of the program. The
│ │ or later │ license and LI will be stored in a directory for future
│ │VisualAge PL/I Version 2.1 │ reference.
│ │IBM REXX for OS/2 │
│ │WebSphere (TM) Application Server │
│ │ Advanced │ Security, Auditability, and Control
│ │Edition V2.02 or later │
├────────────────────┼──────────────────────────────────────┤ The customer is responsible for evaluation, selection, and
│OS/2, Windows NT, │VisualAge COBOL Version 2.1, or later │
│ Windows 95, │ │ implementation of security features, administrative
│ Windows 98 │ │ procedures, and appropriate controls in application
├────────────────────┼──────────────────────────────────────┤ systems and communication facilities.
│OS/390, OS/2, │VisualAge for Java (TM) Professional │
│ Windows NT, AIX │or Enterprise Edition V2.0 and V3.0 │
├────────────────────┼──────────────────────────────────────┤ Ordering Information
│Windows NT, │VisualAge C++ Version 3.5, or later │
│ Windows 98, │Microsoft (TM) Visual C++ Version 5.0,│
│ Windows 95 │ or later │ CICS Universal Clients Version 3.1 is a product with a
│ │Microsoft Visual Basic Version 5.0, │ single charge unit of “Installs”. It is ordered as a program
│ │ or later │
│ │Microsoft Visual Basic Script │ package, and as use authorizations without program
│ │ Version 5.0 for Windows │ supply.
│ │ (Part of Scripting Host) │
│ │IBM Object REXX Version 1.0.2 │ CICS Universal Clients Version 3.1 is available at an
│ │IBM WebSphere Application Server │ upgrade price for those customers currently licensed for
│ │ Advanced Edition 2.02 or later │ the following qualifying programs:
│ │IBM VisualAge Interspace │
│ │ Version 5.2, 6.0 │
│ │ (Refer to note below) │ • CICS Clients Version 1.0
├────────────────────┼──────────────────────────────────────┤ • CICS Clients Version 2.0 (any modification level)
│AIX │IBM C for AIX Version 4.4 │
│ │IBM C Set++ for AIX Version 3.1 │ Licensed customers of CICS Clients Version 3.1 can
│ │ or later 3.1, or later │ upgrade at no charge by downloading from the Internet
│ │ 3.1, or later │ site or obtaining a service upgrade for the qualifying
│ │IBM COBOL Set for AIX Version 1.1, │
│ │ or later │ program.
│ │IBM WebSphere Application Server │
│ │Advanced Edition V2.02 or later │ Order Feature Part
├────────────────────┼──────────────────────────────────────┤ Description Type Number Number
│Solaris │Sun WorkShop C++ Version 3.0.0 │
│ │IBM WebSphere Application Server │
│ │Advanced Edition 2.02 or later │ CICS Universal Clients Version 3.1
├────────────────────┴──────────────────────────────────────┤
│Note: IBM VisualAge Interspace Version 5.2 can only be │ Program Package 5801-AAR 5288 0704642
│used for development under NT, │ — CD-ROM
│and supports the CICS Universal Clients at run─time. │
│However, for production it can also be used for AIX and │ 1 Install 5802-AAR 2896 0704644
│Solaris, but only supports the CICS for UNIX (R) Clients. │
│VisualAge Interspace Version 6.0 supports the │ Upgrades
│CICS Universal Clients at run─time for AIX and Solaris. │
│For application development VisualAge Interspace │
│Version 6.0 only supports Windows NT 4.0 and │ Order Feature Part
│Windows 98, 95. │ Description Type Number Number
└───────────────────────────────────────────────────────────┘
CICS Universal Clients

Planning Information Version 3.1 Program 5803-AAR 2321 0704643

Package Upgrade
Packaging: CICS Universal Clients Version 3.1 is shipped — CD-ROM
in a shrink-wrapped box, delivering the Universal Clients Version 3.0 — 1 Install 5804-AAR 1112 0704645
for all supported platforms. The box contains the for Upgrade
following:
Passport Advantage
• One CD-ROM
• International Program License Agreement (IPLA) in Part
multilanguage booklet Description Number
• IPLA Pointer Sheet
• License Information for CICS Universal Clients CICS Universal Clients Media Package English 84H6616
Version 3.1 CICS Universal Clients Documentation 84H6615
• Proof of Entitlement (PoE) Package English
• Publications Pointer Sheet VPO Instl CICS Universal Clients 1 client D2686ML
VPO Instl/SW Sub CICS Universal Clients D2688ML
Note: The Java Run-time environment (JRE) for the 1 client 1 Year
Solaris platform is supported by Sun Microsystems, Inc. VPO Instl/SW Sub CICS Universal Clients D2689ML
The Solaris JRE is installed with the CICS Transaction 1 client 2 Years
Gateway This improves the installation process as well VPO SW Sub Rnwl CICS Universal Clients E168AML
as run-time checking. Customers using this JRE can keep 1 client
up to date with the Sun upgrades by accessing the Sun VPO SW Sub CICS Universal Clients 1 client D268CML
Web site (for the 1.1.x level).

299-277 -2-
 1 Year
VPO SW Sub CICS Universal Clients 1 client
2 Years
CO Instl/SW Sub CICS Universal Clients
1 client 1st Anniversary
CO Instl/SW Sub CICS Universal Clients
1 client 2nd Anniversary
CO SW Sub Rnwl CICS Universal Clients
1 client
CO SW Sub CICS Universal Clients 1 client
1st Anniversary
CO SW Sub CICS Universal Clients 1 client
2nd Anniversary
CO SUPT CICS CLIENT FLAT 1 ANNIV
CO SUPT CICS CLIENT FLAT 2 ANNIV
Limited Warranty Applies: Yes
D268DML
Program Services: Available until January 31, 2002
D268EML
To obtain the latest service level, contact the Service
D268FML Support Center for your country. Alternatively, you can
obtain information about service levels and download the
E168HML latest service level from the Internet at:
http://www.ibm.com/software/ts/cics/support/details/
D268KML
Money-back Guarantee: 30-day, money-back guarantee
D268MML
Copy and Use on Home/Portable Computer: Yes
AR7UWML
AR633ML
Support Line: Yes

Terms and Conditions Other Support: Passport Advantage

Volume Orders: Yes, contact your IBM representative.

Licensing: IBM IPLA. PoE are required for all authorized
use, except as described below.
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 CICS Universal Clients is
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.
Passport Advantage Applies: Yes
Passport Advantage Subscription Applies: Yes
Upgrades: Customers can acquire upgrades up to the
currently authorized level of use of the qualifying
programs.
AIX/UNIX Upgrade Protection Applies: No

The exceptions are: Entitled Upgrade for Current AIX/UNIX Upgrade

Protection Licensees: No
• CICS/ESA Version 4.1
• CICS/VSE Version 2.3 AS/400 Software Subscription Applies: No
Note: Earlier versions of these two servers are not Variable Charges Apply: No
supported with CICS Universal Clients Version 3.
If they are used to enable communication with either of Charges
these servers, a license is required for every copy made
of CICS Universal Clients.
Part
Note: When the CICS Universal Clients Version 3 Description Number OTC1
program is connected to a server that has use-based
pricing, the appropriate number of use-based features for CICS Universal Clients
that server must be licensed. Version 3.1 Program 0704642 $115
Package — CD-ROM
A license entitlement (subject to the Terms and Version 3.1 — 1 Install 0704644 95
Conditions of the IBM IPLA) to use the CICS Transaction
1
Gateway Version 3 is included at no additional charge One-time charge
with a license for any of the following products:
Upgrades: Contact your sales channel for Support Line
• TXSeries, Version 4.2, for AIX, Solaris, Windows NT, pricing information.
or HP-UX
Part
• CICS Transaction Server for OS/2 Warp, Version 4.1 Description Number OTC
• CICS Transaction Server for OS/390 Version 1.1, or
later CICS Universal Clients
Version 3.1 Program Package 0704643 $46
• CICS Transaction Server for VSE Version 1.1 Upgrade — CD-ROM
Version 3.1 — 1 Install 0704645 38
• VisualAge for Java Professional or Enterprise Edition
for Upgrade
Version 2.0 and Version 3.0 (Application Development
use only — not production)
Passport Advantage
• WebSphere Application Server Advanced or Enterprise
Edition Version 2.02, or later Note: For Passport Advantage ordering information and
charges, contact your IBM Lotus representative or
Note: in the event that you cease to be authorized to use authorized IBM Lotus Business Partner. Additional
this program then you are no longer authorized to use the information is also available on the Passport Advantage
CICS Transaction Gateway Version 3. URL:

License Information Form Number http://www.lotus.com/passportadvantage

• CICS Universal Clients V3.1 — GC34-5465 Customer Financing: IBM Global Financing offers
• CICS Transaction Gateway V3.1 — GC34-5466 attractive financing to credit-qualified commercial and

-3- 299-277
government customers and Business Partners in more
than 40 countries around the world. IBM Global Financing
is provided by the IBM Credit Corporation in the United
States. Offerings, rates, terms, and availability may vary
by country. Contact your local IBM Global Financing
organization. Country organizations are listed on the Web
at:
http://www.financing.ibm.com
Trademarks

eNetwork, WebSphere, and TXSeries are trademarks of

International Business Machines Corporation in the United
States or other countries or both.
CICS, OS/2, AIX, OS/390, VisualAge, CICS/ESA, CICS/VSE,
and AS/400 are registered trademarks of International
Business Machines Corporation in the United States or other
countries or both.
Windows, Windows NT, and Microsoft are trademarks of
Microsoft Corporation.
Java is a trademark of Sun Microsystems, Inc.
UNIX is a registered trademark in the United States and
other countries exclusively through X/Open Company
Limited.
Lotus is a registered trademark of Lotus Development
Corporation.
Other company, product, and service names may be
trademarks or service marks of others.

Year 2000 Readiness Disclosure

Statements made in this announcement regarding Year 2000 are

“ Year 2000 Readiness Disclosures” under the Year 2000
Information and Readiness Disclosure Act of 1998, a U.S. statute
enacted on October 19, 1998.

299-277 -4-