This readme file contains important information about the IBM CICS Transaction Gateway for Multiplatforms (CICS TG) that might not be available in the information center.
The product documentation is provided in the information center at: http://publib.boulder.ibm.com/infocenter/cicstgmp/v8r0/index.jsp
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 term <install_path> is used in file paths to represent the directory where you installed the product.
The text version of this file is suitable for use with a screen reader or braille device.
Installation and uninstallation must be done by a user with Administrator authority. Before you install CICS TG it is recommended that you quit all programs.
Ensure that 460 MB of temporary storage is available to successfully complete installation.
It is recommended that at least 100 MB of additional storage is available in the location where CICS TG is installed to allow diagnostic information to be collected if required.
Install can be run in GUI, console or unattended mode. The default mode is GUI.
GUI mode installation can be launched using the following command:
installer
Console mode installation can be launched using the following command:
installer -i console
Unattended installations can be launched using the following command:
installer -i silent -DLICENSE_ACCEPTED=true
Using the unattended installation can result in the machine restarting without warning.
Use the command:
ctguninst
By default the CICS TG uninstall command matches the mode used at installation. You can override the default mode to run in GUI, console or unattended mode.
If uninstall is started from the Add/Remove programs panel it will run in GUI mode.
GUI mode uninstall can be launched using the following command:
ctguninst -i swing
Console mode uninstall can be launched using the following command:
ctguninst -i console
Unattended uninstall can be launched using the following command:
ctguninst -i silent
This section applies to running the Fix Pack utility which updates an existing installation of the product.
The Fix Pack utility must be run in a command prompt window by a user with administrator privileges. Before installing or uninstalling the Fix Pack shutdown any local CICS TG applications, the Gateway daemon and then the Client daemon.
To install, change to the directory to which the Fix Pack has been unpacked and issue the following command:
ctgfix
The installer will prompt for confirmation before installing. Enter 'y' to proceed. To perform an unattended install, issue the command:
ctgfix -y
During installation, the Fix Pack installer creates a log file named <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 was originally installed in a language other than English, now issue the ctgmsgs command to switch back to that language:
ctgmsgs XX
where XX is the two character message language
To uninstall, change to the <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. To perform an unattended uninstall, 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 <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 for Multiplatforms displayed by Windows in the list of currently installed programs, remains as the original installed version.
By default CICS TG will use the Java Runtime Environment supplied in the <install_path>\jvm16\bin directory
Configuration files that worked with previous releases might not work after upgrade; configuration checking has been improved to ensure that the values used by CICS TG are the intended ones. For more information refer to the "Upgrading" section of the information center.
IPIC is supported to CICS TS version 3.2 and later, and TXSeries version 7.1 and later. Ensure that your CICS server has the latest IPIC maintenance applied.
Outside a J2EE environment, you must ensure that the following Java extensions are available:
* Java Authentication and Authorization Service (JAAS), required for the EPI resource adapter. * J2EE Connector Architecture (JCA) 1.5 Connector class file, required for the ECI resource adapter. * Java Transaction API (JTA), required for XA transactions.
Note: JAAS is included with IBM JREs and JDKs by default. The JCA 1.5 Connector class file and the JTA libraries are available for download from the Sun Java Web site.
To view Client daemon log files correctly, use the 'type' command from a Windows command prompt, or view the log file using a text editor that can display the log file in the correct code page. The Client daemon log files are written in the following code page for each language:
German (de) - 850 English (en) - 850 Spanish (es) - 850 French (fr) - 850 Italian (it) - 850 Japanese (ja) - 943C Korean (ko) - 943C Turkish (tr) - 857 Simplified Chinese (zh) - 1381
Using the configuration tool to open a configuration file with an extension of 'ini' you must set the filter in the open file dialog to 'All Files'.
When installing or uninstalling you need to use uppercase parameters to control the mode. For example:
installer -i SILENT -DLICENSE_ACCEPTED=true
Below is a list of APARs included in this version of the CICS Transaction Gateway for Multiplatforms. Full details can be found on the support pages: http://www.ibm.com/software/htp/cics/ctg/support/
CICS Transaction Gateway for Multiplatforms V8 includes all fixes previously shipped in fix pack V7.2.0.2. Details of this fix pack can be found in the following document: http://www.ibm.com/support/docview.wss?uid=swg21386563
Future service and updates to CICS TG will be made available on Fix Central at http://www.ibm.com/support/fixcentral/
© Copyright IBM Corporation 2010. All rights reserved.
For legal information, see http://www.ibm.com/legal/copytrade.shtml