OpenTP1 Version 7 Operation

[Contents][Index][Back][Next]

dcrasget (Acquire maintenance data)

Format

dcrasget [-c] [-g] [-l] storage-directory

Function

The dcrasget command acquires the maintenance data required for troubleshooting OpenTP1 and stores it in the specified directory.

This command must be executed by users with OpenTP1 administrator permissions when they are operating OpenTP1. Confirm that the environment variables required for OpenTP1 operation are correctly set.

When this command is entered, the system displays the information about the target directory before acquiring maintenance data, and asks the user whether to continue the processing.

The storage directory needs to have a sufficient empty area to store maintenance data. This command acquires mainly the information under the $DCDIR/spool directory and the $DCDIR/tmp directory. The storage directory is also used as a temporary working area for acquiring maintenance data. Before you execute this command, check the size of the information under the $DCDIR/spool directory or the $DCDIR/tmp directory and specify a directory with sufficient space as the storage directory.

If there is an executable file ($DCCONFPATH/usrrasget) such as a shell script, the file is also executed when the command is executed. If you want to execute some processing in synchronization with the execution of the dcrasget command, create an executable file.

Options

-c

Compresses the file that contains the acquired maintenance data.

-g

Executes the command without displaying information about the target directory before maintenance data is acquired, and without asking the user whether to continue processing.

-l

Does not acquire large amounts of information such as $DCDIR/spool, and acquires only information such as command execution results.

Command arguments

storage-directory ~<path name>

Specifies a full path for the directory that will store the acquired maintenance data.

Since users with the OpenTP1 administrator permissions execute this command, set an appropriate access permission for the directory to be specified so that the user who executes the command can create files and directories.

A data file with the following name is created in the specified directory:

dcrasget.HOSTNAME.mmddHHMMSS.AAA.tar[.BB]

HOSTNAME: Standard host name

mmddHHMMSS: Month, day, hour, minutes, seconds

.Z: Added only when the -c option is specified.

AAA: Unit of information to be acquired
SAV: Information under the $DCDIR/spool/save directory
SPL: Information under the $DCDIR/spool directory (except for the save directory)
TMP: Information under the $DCDIR/tmp directory
CNF: Definitions and related information under the $DCDIR/conf directory
INF: Information in information files and the like

.BB: Appended to the file name when the -c option is specified. The appended characters are .gz in Linux, and .Z in other operating systems.

Output messages

Message ID Description Output destination
KFCA01861-E An error occurred during command processing. Standard error output
KFCA01897-I Description about how to use the command Standard output