IBM CICS Transaction Gateway Version 7.1.0.5 - README for AIX
IBM CICS Transaction Gateway Version 7.1.0.5 - README for AIX
The product documentation is provided as an Eclipse Information Center available
at: http://publib.boulder.ibm.com/infocenter/cicstg/v7r1m0/index.jsp
This file contains important information about the IBM CICS Transaction Gateway
(CICS TG) that might not be available in the Eclipse Information Center.
This readme file is available in plain text and HTML. Both files contain the
same information. After installation the files are included in the
<install_path> directory.
The text version of this file is suitable for use with a screen reader or
braille device.
SUMMARY OF TOPICS
A new -b option is available on the cicsprnt command. By default, cicsprnt does
not print blank lines. A blank line is defined as a line that contains only
null characters or non-displayable fields, or is undefined in the BMS map. This
option causes blank lines in the data stream to be printed, for example enter
the command:
cicsprnt -b
A new -e option is available on the cicsterm command. The -e option specifies
that when extended attributes are included in a 3270 datastream received by
cicsterm and no color attribute is set, the color of a field is determined by
both the intensity and protection attributes. The colors used to display the
field are then determined by the normal_unprotected, intensified_unprotected,
normal_protected and intensified_protected definitions in the color mapping
file. By default, when this option is not specified, the 3270 datastream
contains extended attributes and no color attribute is set, the color of fields
is determined by the default and default_highlight definitions in the color
mapping file. Example command useage:
cicsterm -e
This section applies to running the Fix Pack utility which updates an existing
installation of the product.
The Fix Pack utility runs in console mode and must be run by a user with root
privileges. Before installing or uninstalling the Fix Pack shut down any local
CICS TG applications, the Gateway daemon and then the Client daemon.
After the Client daemon has shut down issue the command:
/usr/sbin/slibclean
It is strongly recommended that you shut down all programs running on your
system before running the Fix Pack utility.
Change to the directory where the Fix Pack has been unpacked and issue the
following command:
ctgfix
The installer will prompt for confirmation before installing. Enter 'y' to
proceed. If you do not wish to be prompted for confirmation, issue the command:
ctgfix -y
During installation, the Fix Pack utility creates a log file named <CICS TG
install path>/ctgfix/ctgfix.log. The log file contains details of each file
that is updated by the Fix Pack, and details of any errors. Further information
about the error messages is available in text file ctgfix.hlp located where the
Fix Pack has been unpacked.
If the CICS TG is using messages that are not in English, issue the ctgmsgs
command to switch to your language of choice:
ctgmsgs XX code_set
For help on the ctgmsgs command, issue the command:
ctgmsgs -?
Change to the <CICS TG install path>/ctgfix directory and issue the following
command:
ctgfix -u
The Fix Pack utility will prompt for confirmation before uninstalling. Enter
'y' to proceed. If you do not wish to be prompted for confirmation, issue the
command:
ctgfix -u -y
During uninstall, the Fix Pack utility appends to the ctgfix.log file. The log
file contains details of each file that is restored by the Fix Pack, and details
of any errors. Further information about the error messages is available in
text file <CICS TG install path>/ctgfix/ctgfix.hlp.
After installing the Fix Pack, determine the product version by issuing the
command:
cicscli -v
Components that have not been updated by this Fix Pack will display the original
version.
The version of IBM CICS Transaction Gateway displayed by SMITTY remains as the
original installed version.
Reference documentation for the statistics API is included in the information
center. The documentation is also included as part of the CICS TG installation,
in <install_path>/docs/ctgstatsdoc.zip. To view the documentation, expand the
contents of the ZIP file into a suitable directory and view file 'index.html'
with a Web browser.
If the ctg.ini configuration file contains server names which have one or more
underscore characters '_' in them, when the server name appears in a ctgadmin
command or statistics API query, any underscore characters will have been
replaced by a minus character '-'.
IPIC connections can be used with all in-support versions of CICS TS and
TXSeries which have IPIC capability. All relevant IPIC maintenance must be
applied to your CICS TS or TXSeries server.
In some Telnet sessions, the screen reader might re-read CICS TG log output or
the command prompt, after the CICS TG has started. This is expected behavior,
and does not mean that the CICS TG has failed to start. To determine if the
CICS TG started correctly, listen for the message:
'CTG6512I CICS Transaction Gateway initialization complete'.
If the CICS TG did not start successfully, one of the following messages is
output:
'CTG8821E The CICS Transaction Gateway was unable to start the Client daemon'.
or
'CTG6513E CICS Transaction Gateway failed to initialize'.
Below is a list of APARs included in this version of the CICS Transaction
Gateway. Full details can be found on the support pages:
http://www.ibm.com/software/htp/cics/ctg/support/
PM54534
Message CCL1048E written to Client log on shutdown
PM53769
CICS TG ends unexpectedly when a connection to a CICS server ends
PM46110
The CICS TG Client daemon can become unresponsive if a network socket error
occurs
PM37312
ESI request over SNA fails to complete because the CICS server is unavailable
PM34809
cicsterm support for additional default colors when using a 3270 datastream with
extended attributes
PM33096
Requests fail to complete when using IPIC
PM32332
Message CCL7060I is displayed incorrectly by cicsterm
PM29332
Screen representations in a Client daemon trace formatted with the detailed
option of cicsftrc might be incorrect
PM28737
The cicsprnt 3270 terminal emulator does not have an option to enable printing
of blank lines
PM24817
Mouse double-clicks in the cicsterm 3270 terminal emulator resend the previous
AID
PM16908
Send() timeout causes delay in CICS TG processing.
PM10467
Extended mode ECI requests over IPIC with large containers fail with abend AXTG
reported to the client and abend AITJ in CICS
PM10466
CICS TG fails to reconnect to CICS using an IPIC connection and the client
application receives an ECI_ERR_NO_CICS
PM10465
When a COMMAREA is returned unchanged by a target CICS program, over an IPIC
connection, it contains only nulls
PM08404
A client application becomes unresponsive after specifying an incorrect mirror
transaction with a large channel over IPIC
PK69017
ECIConnection.close() Javadoc incorrectly states when a ResourceException will
be thrown
PK69840
Client daemon appears to become unresponsive during startup
PK71172
Moving a container between channels in CICS causes the CICS TG to ignore the
modified container
PK72228
The Client daemon terminates unexpectedly with CCL2010E Internal transport error
(Function = 'FaarqPutMsg', Error Code = '-5010')
PK76390
Client daemon issues CCL2012E after CICS abends a transaction
PK76458
Terminal definitions are not released in CICS if an emulator terminates when the
Client daemon is at MAXREQUESTS
PK78293
Modified data tag reset on some EPI screens
PK82305
Improve diagnostic information available when a signal occurs in the Client
daemon
PK82711
IPIC container data corruption at 122750 bytes
PK82718
CICS TG reports errors on TCP/IP connections to CICS servers
PK83549
Short mirror transaction names fail over IPIC
PK85498
Access violation in cclclnt.exe when running an EPI workload and the CICS server
becomes unavailable
PK88549
Improve serviceability of IPIC protocol handler
PK89000
Servername can not contain ':','/' OR '#' characters. Results in error CTG6670E
Invalid chars in APPLID for ISC connection
PK89359
Multiple instances of message CCL1048E written to the Client error log,
reporting error code -4 from FaarqGetMsg.
PK91072
CICS TG fails to start when TCP/IP localhost is not defined.
PK96066
When using IPIC, an ECI request routed to a remote CICS server runs under the
default mirror transaction ID
PK97502
Using the getStats() API causes an access violation if a large number of CICS
servers have been defined
PK98202
CICS TG causes exception in TXSeries when using multiple containers
PM00653
CICS TG attempts to process incorrect TCP/IP data as a normal request
PM01320
ClientLocation missing from all XA flows in request monitoring exits
PM03923
CICS TG returns excess data when using an IPIC connection to CICS
PM03931
CICS TG writes messages CCL3315E and CCL3227E to the client error log after
transactions have timed out or abended
PM03933
Message CCL3102E written to the client error log file when running a heavy
workload
PM06643
Message CCL4406E is written to the client error log when a CICS server becomes
unavailable
PK77334
Cicsterm abends when running the CICS supplied CSTD transaction on a TXSeries
region
PK54463
The exclamation mark in a valid password returns ECI_ERR_SECURITY_ERROR (rc=-27)
PK57381
Backslash in trace filename prevents memory mapped wrapping trace starting
PK57891
AZTI abend following failover when using VTAM generic resources for EPI
applications
PK60170
ECI timeout causes a DFHIE1001 bracket protocol violation message
PK60594
A mixed case protocol definition for ConnectionURL parameter results in a
communication error and IOException
PK60925
The CICS TG information center incorrectly documents the protocol for the IPIC
service as ECI
PK62925
An incorrect CCSID is used when non-ASCII CHAR containers are exchanged with
CICS
PK65133
Update to IPIC transaction flows
PK66998
GetConnection() is returning a null when it should return an exception
PK67318
APPLID value ignored and '*' is used, resulting in an APPLID generated by CICS
being used.
PK67935
Client dameon not reconnecting correctly after third occurrence of send call
failure
PK68109
Network sockets not closed
PK68938
Support for SNA on the HP-UX platform
PK68947
Statistics to identify system information
PK68949
CICS TG Statistics API does not connect to CICS TG using a different TCP/IP
stack
PK68937
Enhancements to request monitoring user exits
PK68962
Fixes to the IPIC protocol driver
PK68968
Fixes to the TCP/IP protocol driver
PK68969
Log message CCL2010 displays incorrectly formatted return code
PK68970
Enabling Client daemon trace causes a stack overflow error
PK68971
Call to getIdQuery() results in segmentation violation
PK68972
Exception generated when loading ctgjni.dll
PK68973
CTGXid class has an incorrect constructor
PK68975
CICS TG log file not written to specified destination
PK68976
Return code incorrect when worker thread allocation times out
PK59674
CICS TG ping processing causes down level client to be unexpectedly disconnected
PK59463
Update to version of ccf2.jar shipped with CICS TG
PK59386
CICS TG does not identify the level of fix pack installed
PK36000
CICS TG hangs when message queues fill on unix operating systems
PK36914
Client daemon stops processing requests under heavy workload
PK45841
SSL protocol handler shuts down after 50 consecutive connection failures
PK48708
The default behaviour of UPPERCASESECURITY in CICS TG is incorrectly documented
PK51302
Allow to set '0' in SRVRETRYINTERVAL
PK51695
MAXCONNECT not logged when hit
PK52648
CICS TG does not use unique network UOW identifiers using the SNA protocol
driver
PK52798
In local mode, CICS ECI resource adapter unable to handle some special
characters in password causing security failure.
PK33952
Client daemon may hang when tracing is enabled.
PK33954
The CICS TG hangs when Client daemon tracing is enabled
PK32530
CICS TG may fail to connect to CICS on iSeries
PK30770
Expired passwords cannot be changed using PEM under CICS TG with the TCP62
protocol
PK36915
After a send() call fails, reconnect attempts are not occurring
PK40853
Duplicate PCID's being sent to VTAM
PK42521
Incoming ATI causes Client daemon abend
PK42522
Multiple ATI transactions through EPI applications fail
PK42524
Client daemon ends when unable to establish a connection to CICS
PK42562
CICS TG uses high CPU during network problems
PK42564
CICS TG trace outputs data lengths incorrectly
PK45302
CICS TG Client daemon hangs intermittently on multi-processor machines
PK47041
CICS TG receives an out of memory error from pthread_create()
PK47051
CICS TG J2EE samples give warnings when compiling
PK11029
CTG8404I message is not documented in the CICS TG messages book
PK20438
CICS TG Administration manual is unclear with respect to use of IKEYMAN and
validity of X509 V3 certificates
PK26886
Connection logging messages appearing in stderr
PK16738
Client driver triggers bracket protocol error on CICS host.
PK23200
CICS TG and CICS UC fail to reconnect to CICS after a network outage.
PK27139
Socket send() hangs due to hardware problem. Added timeout to call in the
cclclnt.
PK27140
Client daemon log message CCL2010 does not always contain full diagnostic
information and appears corrupt
Contact your IBM Support organization for service and updates to the product.
The Program includes "UnZipSFX stub" software from the Info-Zip group which is
Copyright (c) 1999-2002, Info-ZIP. All rights reserved. IBM did not modify the
UnZipSFX software. There are no extra charges or costs due to the use of this
code, and the original compression sources are freely available from
http://www.info-zip.org/pub/infozip/ or ftp://ftp.info-zip.org/pub/infozip/ on
the Internet.
© Copyright IBM Corporation 2011. All rights reserved.
For legal information, see http://www.ibm.com/legal/copytrade.shtml