Preparing the systems running TXSeries
Preventive Service Planning
This document lists recommendations on preparing systems running TXSeries. In addition to installing TXSeries, there is additional software that is suggested to be present in the machine such as dbx, to collect documents for investigating issues.
The dumpcicsthreads command output, which is part of MustGather documents for TXSeries, uses the <CICS INSTALL DIRECTORY>/etc/showProcInfo command internally to collect stack of the region processes.
|AIX||The showProcInfo required for taking stack of process uses dbx to take stack. If dbx is not installed, it uses procstack. It is recommended that you ensure either dbx or procstack is present in the server in /usr/bin directory of the operating system.|
|Solaris||The showProcInfo required for taking stack of process, uses /opt/SUNWspro/bin/dbx to take stack. If dbx is not installed, it uses /usr/bin/pstack. It is recommended that you ensure either dbx or pstack is installed in the operating system.|
|HP-UX||The showProcInfo required for taking stack of the process uses /opt/langtools/bin/gdb to take stack. If gdb is not installed, the stack will not be taken,|
Scripts and utilities
The showProcInfo script requires Perl to be available on the server. The showProcInfo is used to take stack of processes under hang conditions. The script will fail if Perl is not available on server.
Some scripts in TXSeries uses the korn shell. It is required that you have korn shell on the server.
TXSeries requires root user permission for executing most of the administrative commands. As an alternative, the Sudo freeware tool can be used to execute administrative functions. Information on configuring sudo with TXSeries is available in the Information center, at:
Operating Systems configuration
Ensure that the required locale is installed in the server. The locale command can be run to ensure if the locale is correctly set in the environment. The locale command displays supported locale for all parameters.
NLSPATH must be properly set to ensure that CICS messages are properly displayed. For information on NLSPATH related settings, see:
On HPUX or HPIA, the following kernel parameters require changes:
- Default value of semmsl needs to be increased to 2048 or above and default 128 is not sufficient to run the TXSeries regions.
- semmns must be increased to 10000 or above.
- Any CICS process (region process or sfs or ppc gateway or sarpcd) can generate core during fatal termination. The full core is required to investigate the root cause of the problem in such cases. It is suggested to enable full core in the system for root and cics user. The 'ulimit -a' and 'ulimit -aH' commands can be used to verify if the full core is enabled.
- Users can monitor the file descriptor usage in the system (For example ,lsof command in AIX)and set the value appropriately. Usually, the value of 4000 for nofiles is sufficient in most of the cases.
The following users are created during installation: cics , cicssm
The following groups are created during installation: cics, cicsterm, cicssm
The installer does not apply any prerequisite setting for users or groups created during TXSeries installation. They are created with default settings set by the Operating System. The users can set login=false,admin=false,su=false,rlogin=false for these users if they are not a part of default settings from the operating system . Modifying these parameters does not affect the product functionality.