************************************************************************
* IBM CICS Transaction Gateway for OS/390 - README              v3.1.2 *
************************************************************************

Welcome to the IBM CICS Transaction Gateway ...

This file contains important information about the IBM CICS Transaction
Gateway that may not be available in the printed documentation.

In the following information  refers to the directory in which
you installed the Transaction Gateway.

Summary of Topics
=================
- Installation issues
  - Java Development Kit
  - CICS Transaction Server v1.2 and v1.3 - APARS
- EXCI version 2 exploitation   *** NEW FEATURE ***
- Connection reuse   *** NEW FEATURE ***
- ECI_ERR_RESOURCE_SHORTAGE errors
- Increase the CPUTIME timeout when high volume of traffic
- Using the CICS Transaction Gateway through a local gateway
- IBM NetStation support
- Data Conversion
- Making ECI calls
- Documentation
- Request classes and string truncation
- JNI Tracing
- CICS Connectors
  - Use of the CICSELUW flag in the ECI Connector
- v3.04 Client Restriction
- Configuration Tool update
- Trace filesize parameter
- Service and Updates


Installation issues
===================
Java Development Kit
--------------------
The Java Development Kit is required.
Version 1.1.8 PTF1 is recommended. See http://www.s390.ibm.com/java
for details.
Please ensure that you are have applied PTF UW63221/63262/63281.


CICS Transaction Server v1.2 and v1.3 - APARS
---------------------------------------------
CTS v1.2 users require PQ31270 to be applied to the product before
CICS Transaction Gateway v3.1 can be used.

CTS v1.3 users require PQ25809 to be applied to the product before
CICS Transaction Gateway v3.1 can be used.


EXCI version 2 exploitation
===========================
This version of the CTG supports version 2 of the EXCI which provides support
for eci_transid and resolves problems with ASCII / EBCDIC conversion.
Support for EXCI version 2 on CTS for OS/390 v1.3 is provided by APAR PQ38644.

If using EXCI version 2 and eci_tpn is specified on the ECI request, then the
definition of the user mirror transaction should now specify PROGRAM(DFHMIRS),
regardless of whether the transacton is defined as local or remote.


Connection reuse
================
This version of the CTG now implements EXCI connection reuse, which provides
performance benefits.

As there is a limit of 100 pipes per MVS address space, it is recommended
that you set the CTG maximum worker threads to (100 divided by the number
of CTS regions in direct communication with the CTG) as a pipe is allocated
per thread per CICS server.


ECI_ERR_RESOURCE_SHORTAGE errors
================================
If you experience intermittant ECI_ERR_RESOURCE_SHORTAGE errors, you may
need to increase the RECEIVECOUNT value on the SESSIONS resource definition
on the CICS server to a value substantially greater than is theoretically
necessary, i.e. 100.


Increase the CPUTIME timeout when high volume of traffic
========================================================
It may be necessary to change the MAXCPUTIME value in the BPXPRMxx member
in SYS1.PARMLIB if there is a high volume of traffic.
This value determines the maximum amout of CPU time in seconds that a process
may use. BPXPRMxx is used to set an initial value at IPL, which can be modified
using the SETOMVS command.

From OS/390 2.8 onwards, this value can be set on a userid basis using the
CPUTIMEMAX value in the RACF userid profile's OMVS segment.
For more information, see OS/390 UNIX System Services Planning.


Using the CICS Transaction Gateway through a local gateway
==========================================================
When using the CICS Transaction Gateway as a local gateway the STEPLIB
environment variable must be set to the library containing the default EXCI
options and the EXCI load modules.  This will be the same as specified for
EXCI_LOADLIB in the ctgstart script.  For more information on environment
variables refer to Chapter 4 - Configuring the CICS Transaction Gateway for
OS/390 in the CICS Transaction Gateway for OS/390 Administration guide.


IBM NetStation support
======================
Applets running within the JVM supplied with the NC browser fail to
make successful connections with the CICS Transaction Gateway. Message
number CCL6652E is returned to the Applet. Currently there is no solution
to this problem.


Data Conversion
===============
All data conversion from ASCII to EBCDIC and vice versa is performed by the
CICS Transaction Server, not the CICS Transaction Gateway.


Making ECI calls
================
When making ECI calls, the length of the communication area (COMMAREA)
passed to the ECI must not exceed 32500 bytes.


Documentation
=============
To view the PDF documentation you need to install the PDF library on a
workstation that can run the Adobe Acrobat Reader. Currently there is
no Abobe Acrobat Reader available for OS/390.

Adobe Acrobat Readers are provided on the CD-ROM, you will find them
in a subdirectory for each platform under the Adobe directory. Choose
your platform and run the Reader install program.

Later versions of these Readers may be available, see http://www.adobe.com

The PDF library for this product is located in the /ctg/docs directory.
This library (cclha60i.tar.Z) is a compressed TAR archive format, this can
be transferred (in binary format) to a number of platforms and extracted.
TAR archives are standard for UNIX platforms, however, Windows/OS-2 have a
number of tools available which can extract this archive format.

If you have the product CD-ROM, you will also find individual PDF books
in the PDF directory.


Request Classes and string truncation
=====================================
the ECI and EPI Request classes take strings for various parameters, eg
Server, Userid, Password and so forth. If you specify a string that is
too long, when the request is flowed, the string will be truncated to the
maximum length.


JNI Tracing
===========
JNI tracing is NOT enabled through the normal Gateway tracing options. To
enable it all you do is set an environment variable CTG_JNI_TRACE to the path
and file where you want the information stored. For example
export CTG_JNI_TRACE=/tmp/ctgjni.trc


CICS Connectors
===============

Use of the CICSELUW flag in the ECI Connector
---------------------------------------------
If you are using the ECI connector with a real Co-ordinator, you MUST set the
CICSELUW flag on the ECIInteractionSpec to TRUE. The default is FALSE. If you
don't then the ECI Resource will NOT be registered with the co-ordinator and
you will not extend logical units of work as expected.


v3.04 Client Restriction
========================
Connecting a v3.04 client java application to a v3.1x, or later, gateway over
SSL or HTTPS is not supported.


Configuration Tool update
=========================
To clarify the 'Require Security' option on the HTTP, HTTPS, TCP and SSL panels,
it has been renamed to 'Require clients to use security classes'.


Trace filesize parameter
========================
To specify the maximum size of the trace textfile, use the -tfilesize
option on ctgstart. The parameter is the size in kilobytes.


Service and Updates
===================
Service and updates will be made available via the Internet.
See:
   http://www.software.ibm.com/ts/cics/support/details

APAR Fixes in v3.1.0
--------------------
PQ27201 The Comma (,) is not allowed as a decimal point

APAR Fixes in v3.1.1
--------------------
PQ31837 Jgate -time does not produce timestamps in jgate log
PQ33058 Commarea not returned in ASCII by CTG
PQ33193 CTG using Local: protocol loses data
PQ34159 Config tool clears domain name suffix
PQ34553 Eci_state_sync general query fails with RC -9
PQ35123 During ATI processing, message 'CCL3227 Conversation (1) is not in send state' is intermittently received.
PQ35228 MAXSERVERS gets reset to 10 by CTGCFG utility
PQ35333 DFHJVPIPE = 'x00' instead of blank 'x40'

APAR Fixes in v3.1.2
--------------------
PQ37626 Extended LUW's can result in occasional AITD abends
PQ39377 CTG trace shows misleading messages for terminal indexes
PQ39725 Ability to produce wrapping trace for CTGSTART tracing


************************************************************************

IBM, OS/390, and CICS are trademarks of the IBM Corporation in
the United States or other countries.

Sun, Java and JavaBeans are a trademark of Sun Microsystems, Inc. in
the United States or other countries.

Microsoft, Windows, Windows 95, Windows 98 and Windows NT are trademarks
of Microsoft Corporation in the United States or other countries.

Adobe and Acrobat are trademarks of Adobe Systems, Inc. in the United
States or other countries.

Other company, product, and service names may be trademarks or service
marks of others.

************************************************************************
* (C) Copyright IBM Corporation 1999.  All rights reserved.            *
************************************************************************
************************************************************************
* End of file                                                          *
************************************************************************