ctmrasget (acquire and output troubleshooting information)

Format

ctmrasget { [-h] | [-p] [-s] [-CTMSpool CTM-spool-directory | 
          -CTMDomain CTM-domain-name]
          [-PRFSpool PRF-daemon-execution-environment-directory] output-destination-directory}

To Page Top

Function

This command acquires troubleshooting information (to a file) required by CTM on the host on which the ctmrasget command is executed, and then outputs a list of acquired information to the standard output or standard error output.

To Page Top

Arguments

-h

Displays how to use the command.

-p

Outputs troubleshooting information about TPBroker to the output destination directory. You need to specify the TPBroker environment variable VBROKER_ADM in advance.

-s

Suppresses the acquisition of common messages (eventlog or syslog).

-CTMSpool CTM-spool-directory

Specifies the CTM spool directory to which troubleshooting information is to be acquired.

-CTMDomain CTM-domain-name

Specifies the CTM domain name for which troubleshooting information is to be acquired. You can specify 1 to 31 alphanumeric characters and underscores (_).

If this argument is omitted, troubleshooting information will be acquired from all CTM domains registered in the CTM environment on the host.

-PRFSpool PRF-daemon-execution-environment-directory

Specifies the PRF-daemon execution environment directory to which troubleshooting information is to be acquired. If this argument is omitted, the value of the environment variable PRFSPOOL is set. If both this option and the environment variable PRFSPOOL are omitted, PRF daemon information is not acquired.

output-destination-directory

Specifies the directory name (absolute or relative path) of the file to which troubleshooting information is to be output.

To Page Top

Return values

0:

The command is terminated normally.

Other than 0:

The command terminated abnormally because an error occurred during command processing. Take the corrective action indicated in the output message, and then re-execute the command.

To Page Top

Output format

Component Transaction Monitor: RAS completed collection of aa...aa

Legend:

aa...aa: Collected information and file name

To Page Top

Notes

• If a file with the specified name already exists in the output destination directory, the existing file is overwritten. Therefore, if you want to retain troubleshooting information, copy the file or specify a new directory as the output destination directory.

• Do not start or terminate CTM during execution of the ctmrasget command.

To Page Top