IBM United States
Software Announcement 201-187
June 26, 2001
CICS Transaction Gateway Version 4.0 A WebSphere Connector
(Corrected on October 19, 2001)
Change made in the sixth bullet in the beginning of the Description
At a Glance
The CICS® Transaction Gateway (CTG) V4.0 enhancements include:
CTG Version 4 incorporates the major functions of CICS Universal Clients V3 and CICS Transaction Gateway V3, and combines them into one priced program package. Key new features:
CTG V4 is the latest version of IBM's connector product that runs on the following platforms:
HP-UX and Linux on S/390 are new platforms now supported by the CICS Transaction Gateway.
CTG V4 enables Java, JavaBean, C++, COM and C applications to connect to CICS applications running on any CICS server easily and efficiently. The CICS applications may be written in any supported language as LINKable programs or as 3270 transactions.
V4 enables gateway/server communication over TCP/IP, TCP62, SNA LU6.2, and memory-based protocols. It supports transactional interoperation where the invoking application may initiate a recoverable unit of work which is coordinated with the actions of the target CICS application and the resources it accesses.
Version 4 supports JVM 1.3 on all platforms, but will still tolerate JVM 1.2.2 on platforms where this is available.
New Java sample programs are also provided.
A new implementation of the TCP62 protocol is now supported on all platforms, except on OS/390. It is integrated with the base product and it is not a separately installable feature. Configurations and definitions used with the previous implementation will work with the new implementation transparently.
CTG V4 incorporates the major functions of CICS Transaction Gateway V3 and CICS Universal Client V3, and replaces these products. It provides bindings for the ECI, EPI, and ESI programming interfaces in Java, C++, C, and VisualBasic, and may be used with both IBM and non-IBM application servers. Various RAS enhancements are also included in V4.
The terminal servlet now supports signon-capable terminals on all platforms except OS/390.
The following functions of CICS Transaction Gateway V3 are no longer supported:
Platform-specific information for CICS Transaction Gateway is described below.
CTG on Windows
CTG V4.0 will run on the following Windows platforms:
For development purposes, the following platforms are also supported:
A single new install package is provided for Windows NT and Windows 2000, with Roaming User support.
On Windows 2000, support is included for the Terminal Services feature, which enables support for multiple attached terminal devices.
Support for the following is not included in Version 4:
CTG on Sun Solaris
CTG Version 4 will run on both Sun Solaris 7 (32 bit mode and 64 bit mode) and Sun Solaris 8 (32 bit mode and 64 bit mode).
The SunLink (SNA) protocol on Sun Solaris is not supported, but TCP62 support provides equivalent function to SunLink and should be used as the alternative to SNA.
CTG on Linux for S/390
CTG on Linux for S/390 V3.1.2 was made available for free Internet download on December 22, 2000. This version will be withdrawn from download on June 30, 2001, and will be withdrawn from service on July 31, 2001. It is replaced by CTG V4.0.
CTG V4.0 provides support for TCP62 on the Linux for S/390 platform. This brings CTG on Linux up to the same level as the other UNIX® platforms that CTG supports.
Support has also been added for Turbo Linux.
CTG on Linux for S/390 runs with JDK 1.2.2. It is our intention to support JDK 1.3 in a future release of CTG.
CTG on OS/390
The following are the functional changes that have been made for CTG for OS/390 Version 4.0:
CTG on OS/390 Version 4 has been available to customers via a Beta Program since March 2001.
CTG on HP-UX
The SNA protocol on HP-UX is not supported, but TCP62 support provides equivalent function.
HP-UK SDK 1.3 does not supply the True Type fonts required for Japanese, Korean, and Simplified Chinese. Customers are advised to either purchase their own True Type fonts from a third-party vendor, or run CTG in English.
CTG on AIX
CTG on AIX requires AIX V4.3.3 with SP25. AIX Communications Server Version 5 is no longer supported.
Beta of the J2EE Support
CTG V4 will provide beta support for J2EE Connector Architecture (JCA). It is the draft industry standard interface which enables Enterprise JavaBeans and Servlets running on a Java application server, and supports the J2EE Connector Architecture to access a variety of Enterprise Information Systems (EIS) with a uniform programming model. These beans and servlets can exploit the connection pooling and transaction management facilities provided by compliant application servers, together with security services provided by the target EIS. The JCA is derived from IBM's Common Connector Framework (CCF) which was introduced with VisualAge for Java, and is supported by VisualAge for Java V3.5.3.
Customers who order CTG V4 may register for the CTG J2EE beta program to obtain early versions of the following two J2EE CICS Connectors:
Note: CTG V4 on OS/390 only has support for the ECI connector. These connectors are IBM's preferred J2EE connectors for CICS.
To register your interest in this beta program, which runs from July 3, 2001, go to:
Accessibility by People with Disabilities
For CTG on Windows:
The following features support use by people with disabilities:
This program is EuroReady.
For more information on the implications of the euro, visit the IBM euro Web site at:
IBM considers an IBM product to be EuroReady if the product, when used in accordance with its associated documentation, is capable of correctly processing monetary data in the euro denomination and of respecting the euro currency formatting conventions (including the euro sign). This assumes that all other products (for example, hardware, software, and firmware) that are used with this product are also EuroReady. IBM hardware products that are EuroReady may or may not have an engraved euro sign key on their keyboards.
Currently, EuroReady status applies primarily to IBM products specific to the EMU countries. Products that are not specific to these countries are deemed to be "not ready" for euro unless otherwise stated in the product's country-specific specifications.
IBM Hardware Ready
IBM supplies certain IBM products which include third-party software (pre-loaded or not) and/or third-party attached hardware. In these instances, IBM is not in a position to assert that these third-party products are, in themselves, EuroReady. Therefore, such IBM products will be designated as Hardware ready.
IBM considers a solution to be EuroReady when the solution providers have:
and can clearly demonstrate this by:
The euro capabilities of a EuroReady solution will be clearly identified as features of the solution specification, as described in the contracts document.
Many enterprises use multi-tiered configurations to implement e-business applications which serve their customers as end users. These configurations typically consist of three physical tiers made up of the end-user browser, a Web server/Web application server, and a back-end EIS, although sometimes additional tiers are also used. The purpose of CTG is to provide efficient integration of middle-tier application servers with CICS-based EISs. It achieves this by providing a multi-user gateway which supports programming interfaces on the same tier as the Web application server, for use by Web applications in Java and other languages. Customers may, therefore, use existing assets and skills in building middle-tier solutions, in combination with their enterprise CICS systems, to achieve effective e-business solutions. CTG also provides an excellent environment for customers wishing to gain familiarity with Java programming, prior to using this in the host CICS environment.
CTG V4 enables customers to implement robust and efficient end-to-end configurations and, by supporting major server platforms, provides considerable flexibility in the configurations which may be adopted. It also enables customers to change configurations without modifying applications when operational reasons require this or make it desirable, for example to increase the scalability of a solution. The option to deploy CTG V4 on OS/390 or z/OS, supporting Web applications locally on OS/390 or z/OS, or remotely on a physical middle-tier server, provides a configuration which enables high scalability to be achieved and has been tested at transaction rates in excess of 1,000 transactions per second.
CTG V4 contains a superset of the functions offered in CICS Universal Clients V3.1 and may be used to support multi-user integration applications written in C, C++, Visual Basic, and as COM objects.
It may be deployed in non-Java environments, on distributed platforms, and offers transparent migration for customer applications which are currently using CICS Universal Clients V3.1.
Universal Clients V3.1
As previously announced, central service will be provided by IBM for Version 3.1 of CTG and CICS Universal Clients, until January 31, 2002. Beyond that date, IBM intends to offer fee-based service until January 31, 2003.
Program Services Extension
Program Services for TXSeries Version 4.2 HP-UX 11.0 (5697-F12) have been extended until December 31, 2002.
Program Services for TXSeriesTM Version 4.2 HP-UX 10.20 (5697-D22)
are not changed by this announcement. For details, refer to Software
, dated October 17, 2000.
Product information will be available on day of announcement through Offering Information (OITOOL) at:
The manuals that accompany the CTG are provided in Acrobat Portable Document format (filetype .PDF), for viewing and printing using the Adobe Acrobat reader, included with the product.
The English .PDF books are provided in a single, platform-specific, library, with search facility.
This library, along with the current Adobe Acrobat Reader, with search, is an installable option.
Translated .PDFs are available on the Web and can be downloaded from:
Follow the library link.
In addition, hardcopy of these books are available for immediate purchase. To order, contact your IBM representative or your dealer. However, the hardcopy books may be at a lower level than the .PDFs available from the referenced Web site.
Although the CICS Universal Client function is now integrated with the CICS Transaction Server, information about using the client is still documented in separate manuals. It is IBM's intention to combine the Client and Gateway information into new manuals in a future release of the product.
The books are:
Order Title Number CICS Transaction Gateway for SC34-5940 Windows(R)-Client Administration CICS Transaction Gateway for SC34-5941 AIX(R) -- Client Administration CICS Transaction Gateway for SC34-5942 Solaris-Client Administration CICS Transaction Gateway for SC34-5944 Linux -- Client Administration CICS Transaction Gateway for SC34-5943 HP-UX -- Client Administration CICS Universal Clients C++ SC34-5945 Programming CICS Universal Clients COM SC34-5946 Automation Programming CICS Transaction Gateway for SC34-5932 Windows Administration CICS Transaction Gateway for SC34-5933 AIX Administration CICS Transaction Gateway for SC34-5934 Solaris Administration CICS Transaction Gateway for SC34-5937 Linux Administration CICS Transaction Gateway for SC34-5935 OS/390(R) Administration CICS Transaction Gateway for SC34-5936 HPUX Administration CICS Transaction Gateway SC34-5938 Programming CICS Transaction Gateway SC34-5947 Client/Server Programming
The Publication Notification System (PNS) is available by order number/product number. Customers currently subscribing to PNS will automatically receive notifications by e-mail. Customers who wish to subscribe, can visit the PNS Web site location at:
The IBM Publications Center Portal:
The Publications Center is a worldwide central repository for IBM product publications and marketing material with a catalog of 70,000 items. Extensive search facilities are provided, as well as payment options via credit card. Furthermore, a large number of publications are available online in various file formats, which can currently be downloaded free of charge.
Note that PNS subscribers most often order their publications via the Publication Center.
Specified Operating Environment
CTG Version 4 will run, and has been tested, on the following operating systems:
CTG V4 supports the following JDK levels:
Note: CTG V4.0 supports applets running in a JDK 1.1 compliant Web browser.
CTG V4.0 has been tested with:
CTG V4.0 has been tested with:
Note: By tested, it means that the servlet sample has been run on all the above application servers and that the Terminal Servlet has been run on all of the non OS/390 application servers.
Customers wishing to use SNA communications should install the following products.
For Windows NT and Windows 2000:
The required TCP/IP function is contained within the operating system.
TCP62 Communication: In all cases, the TCP62 function is contained within the CTG product.
CTG V4.0 has been tested with the following servers:
Compilers/Application Development Tools
CTG V4.0 has been tested with the following compilers and application development tools:
On Windows NT and Windows 2000:
On Sun Solaris:
On Linux for S/390:
Note: CTG V4 does not support using the COM libraries with MTS or the MTS component of COM+.
CTG Version 4 supports the following tools:
Note: The Java Run-time Environment (JRE) for the Solaris platform is supported by Sun Microsystems, Inc. The Solaris JRE is installed with the CICS Transaction Gateway. This improves the installation process as well as run-time checking. Customers using this JRE can keep up to date with the Sun upgrades by accessing the Sun Web site (for the 1.1.x level).
This program, when downloaded from a Web site, contains the applicable
IBM license agreement, and License Information (LI), if appropriate, and
will be presented for acceptance at the time of installation of the
program. The license and LI will be stored in a directory such as
LICENSE.TXT for future reference.
Security, Auditability, and Control
The customer is responsible for evaluation, selection, and implementation of security features, administrative procedures, and appropriate controls in application systems and communication facilities.
Previous versions of the CTG were available to download from the Web, at no additional charge, to those customers with an existing license entitlement.
CTG V4.0 is a priced offering with a charge unit based on processor installs. A program package will be required for the first processor install. One install entitlement is required for each subsequent processor install beyond the first.
CTG Version 4 can be ordered for use on S/390 (including Linux on S/390) or for use on Windows, AIX, Sun Solaris, and HP-UX (multiplatform use).
There are two sets of product numbers that should be entered depending on which platform the product will be used.
The product which is supplied is identical, no matter which set of part numbers is used, and the price is the same.
CTG V4 includes the CICS Universal Client function on the same CD-ROM. There is no separately orderable CUC V4. CICS Universal Clients at the Version 3 level is still available to download (for those who have a license entitlement) or to purchase, via Passport Advantage, until January 31, 2002.
When there is a known intention to purchase for deployment on S/390, use part number 29P4340 which will alert IBM support staff of the customer's intention.
Program Name/ Part Description Number CICS Transaction Gateway V4.0 0792033 (for Multiplatform use) Program Package CICS Transaction Gateway V4.0 0792034 (for Multiplatform use) 1 install CICS Transaction Gateway V4.0 29P4340 (for S/390 use) Program Package CICS Transaction Gateway V4.0 29P4342 (for S/390 use) 1 install
Passport Advantage Customers can download ESD images from the following Web site:
Business Partners can download the above image from the following Web site:
Use the following set of numbers when ordering CTG V4 for use on Windows, AIX, Sun Solaris, and HP-UX (Multiplatform use):
Program Name/ Part Description Number CICS Transaction Gateway V4 0792035 Media Package English VPO Instl CICS Transaction D58DLML Gateway V4 VPO Instl/SW Sub CICS D58DMML Transaction Gateway V4 1 Year VPO Instl/SW Sub CICS D58DQML Transaction Gateway V4 2 Years VPO SW Sub Rnwl CICS Transaction E18DRML Gateway V4 VPO SW Sub CICS Transaction D58DSML Gateway V4 1 Year VPO SW Sub CICS Transaction D58DTML Gateway V4 2 Years CO Instl/SW Sub CICS Transaction D58DUML Gateway V4 1st Anniv CO Instl/SW Sub CICS Transaction D58DVML Gateway V4 2nd Anniv CO SW Sub Rnwl CICS Transaction E18DWML Gateway V4 CO SW Sub CICS Transaction D58DXML Gateway V4 1st Anniv CO SW Sub CICS Transaction D58DYML Gateway V4 2nd Anniv CO Supt CICS Transaction Gateway V4 AT8DZML CO Instl/SW Sub/Supt CICS Transaction D58EOML Gateway V4 1st Anniv CO Instl/SW Sub/Supt CICS Transaction D58E1ML Gateway V4 2nd Anniv CO SW Sub/Supt CICS Transaction D58E2ML Gateway V4 1st Anniv CO SW Sub/Spt Rnwl CICS Transaction E18E3ML Gateway V4 1st Anniv
When there is a known intention to purchase for deployment on S/390, use these part numbers which will alert IBM support staff of the customer's intention.
Program Name/ Part Description Number CICS Transaction Gateway V4 0792035 Media Package English VPO Instl CICS Transaction Gateway V4 D50E4LL VPO Instl/SW Sub CICS Transaction D50E5LL Gateway V4 1 Year VPO Instl/SW Sub CICS Transaction D50E6LL Gateway V4 2 Years VPO SW Sub Rnwl CICS Transaction E0036LL Gateway V4 VPO SW Sub CICS Transaction D50E7LL Gateway V4 1 Year VPO SW Sub CICS Transaction D50E8LL Gateway V4 2 Years CO Instl/SW Sub CICS Transaction D50E9LL Gateway V4 1st Anniv CO Instl/SW Sub CICS Transaction D50F0LL Gateway V4 2nd Anniv CO SW Sub Rnwl CICS Transaction E0037LL Gateway V4 CO SW Sub CICS Transaction D50F1LL Gateway V4 1st Anniv CO SW Sub CICS Transaction D50F2LL Gateway V4 2nd Anniv CO Supt CICS Transaction D50F3LL Gateway V4 Program Name/ Part Description Number CO Instl/SW Sub/Supt CICS Transaction D50F4LL Gateway V4 1st Anniv CO Instl/SW Sub/Supt CICS Transaction D50F5LL Gateway V4 2nd Anniv CO SW Sub/Supt CICS Transaction D50F6LL Gateway V4 1st Anniv CO SW Sub/Spt Rnwl CICS Transaction E0038LL Gateway V4 1st Anniv
Most product media is shipped only via Customized Offerings (that is, CBPDO, ServerPac, Systempac®). Non-customized items (CDs, diskettes, source media, media kits) will continue to be shipped via the stand-alone product.
Terms and Conditions
The prices provided in this announcement are suggested retail prices for the U.S. only and are provided for your information only. Dealer prices may vary, and prices may also vary by country. Prices are subject to change without notice. For additional information and current prices, contact your local IBM representative.
When there is a known intention to purchase for deployment on S/390, use part number 29P4340, which will alert IBM support staff of the customer's intention.
Program Name/ Part Description Number OTC CICS Transaction Gateway V4.0 0792033 $6,550 (for Multiplatform use) Program Package CICS Transaction Gateway V4.0 0792034 6,500 (for multiplatform use) 1 install CICS Transaction Gateway V4.0 29P4340 6,550 (for S/390 use) Program Package CICS Transaction Gateway V4.0 29P4342 6,500 (for S/390 use) 1 install
OTC = One-time Charge
Customer Financing: IBM Global Financing offers attractive financing to credit-qualified commercial and government customers and Business Partners in more than 40 countries around the world. IBM Global Financing is provided by the IBM Credit Corporation in the United States. Offerings, rates, terms, and availability may vary by country. Contact your local IBM Global Financing organization. Country organizations are listed on the Web at: