The product documentation is provided as an Eclipse Information Center available at: http://publib.boulder.ibm.com/infocenter/cicsuc/v7r1m0/index.jsp
This file contains important information about the IBM CICS Universal Client (CICS UC) 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.
See the product documentation for further information on this feature.
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 full product installer which either installs the product or replaces an existing version of the product.
Before running the CICS UC installer the Korn shell must be installed on your system.
Installation and uninstallation must be done by the root user.
Before you install the product, check the root user's umask to ensure that files created during the installation are readable by the user IDs that will run the CICS UC. A umask of 077 restricts access to the root user that installed the CICS UC; a umask of 022 allows all users to run the CICS UC.
Before running the CICS UC installer it is strongly recommended that you shut down all programs running on your system.
To install the CICS UC launch the InstallShield wizard:
installer
To install the CICS UC in console mode launch the InstallShield wizard with the -console option:
installer -console
To install the CICS UC with no user interaction launch the InstallShield wizard with the -silent and -V licenseAccepted options:
installer -silent -V licenseAccepted=true
Further information on how to use the installer can be found in the the Eclipse Information Center. Known issues are documented in this readme file.
Use the command:
ctguninst
GUI mode uninstall can be launched using the following command:
ctguninst -swing
Console mode uninstall can be launched using the following command:
ctguninst -console
Unattended uninstall can be launched using the following command:
ctguninst -silent
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 CICS UC applications and the Client daemon.
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 UC 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 UC 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 UC 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 UC 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 supplied version of Java is IBM 32-bit Runtime Environment for Solaris, Java 2 Technology Edition, Version 5 Service Release 7.
Create a directory for the Java Runtime Environment files to be extracted to. Expand and extract the Java Runtime Environment from the package file into this new directory. The following example uses the Java default location:
mkdir /usr/java5 cd /usr/java5 gzip -cd <package_path>/soldevhybridifx-20080403-jre.tar.Z | tar -xvf -
After installing the Java Runtime Environment read the Java documentation for guidance on how to define the PATH and other environment variables.
When installing with the graphical user interface the installer program may stop responding. If this problem occurs, issue "Ctrl C" to end the installer program and retry the installation using the "-console" option.
When upgrading from earlier versions of the CICS UC the installer program does not display progress correctly; ignore the progress display. The installation is unaffected by the incorrect progress display.
Below is a list of APARs included in this version of the CICS Universal Client. Full details can be found on the support pages: http://www.ibm.com/software/htp/cics/cuc/support/
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