8.6.1 acmcapture (AdvancedCopy Manager's Agent Troubleshooting Data Collection Command)

NAME

acmcapture - Collection of AdvancedCopy Manager's agent troubleshooting data

SYNOPSIS

/opt/FJSVswstf/bin/acmcapture dirname

DESCRIPTION

This command collects the AdvancedCopy Manager's agent troubleshooting data. Data is collected for AdvancedCopy Manager's agent installed on the Managed Server where this command is executed.

Only the root user can execute this command.

Troubleshooting Data File Name: The collected data is stored in a file with the "acmcapture_HOSTNAME_YYYYMMDD_ttmmss.tar.Z" format under the directory specified for "dirname".

The name of the host where the command is executed is used for HOSTNAME. If characters other than alphanumerics and hyphens are used in the host name, then "NOHOSTNAME" is used as the host name. Values are truncated to 15 characters.

For YYYYMMDD, YYYY is the year, MM is the month, and DD is the day.
For ttmmss, tt is the hour, mm is minutes, and ss is seconds.

OPERANDS

dirname: Directory where the troubleshooting data is stored.
Specify a directory with plenty free space (500 MB or more) is recommended. Regard 500 MB as a rough guide, since the size of the troubleshooting data varies depending on the system environment and conditions. If there is not enough free space, then this command terminates abnormally without collecting troubleshooting data.
Specify an existing directory, otherwise this command terminates abnormally without collecting troubleshooting data.

EXIT STATUS

=0: Completed successfully
>0: Terminated abnormally

EXAMPLES

Collecting the troubleshooting information on the "/tmp" directory:

# /opt/FJSVswstf/bin/acmcapture /tmp
Executing.........................................
Completed.
OUTPUT=/tmp/acmcapture_srv01_20090323_094614.tar.Z

NOTES

Execute this command when other AdvancedCopy Manager commands are in the stopped state. Data collection may not be performed correctly if other AdvancedCopy Manager commands are running.