pdgeter (Acquire error information)
Function
The pdgeter command outputs error information to a specified directory or DAT drive when an error occurs in the HiRDB system.
Executor
HiRDB administrator
Format
pdgeter [{-o output-destination-directory-name
|output-destination-device-name}]
[-w work-directory-name] [-x host-name[,host-name]...]
[-am]
[-t]
Options
Specifies the name of the directory or device to which error information is to be output. If this option is omitted, output is to the $PDDIR/erinf/outinf directory.
When directing the output of troubleshooting information to a tape device, specify the name of a work directory for temporary storage of the information being output. Specify the name as the directory name, in an absolute path, of the server machine that will execute the pdgeter command. HiRDB creates a temporary work file in the specified directory. This temporary work file should be created in the following situations:
The default for this option is $PDDIR/erinf/work.
Directories beginning with /dev cannot be specified in this option.
Specifies names of hosts from which error information is to be acquired. If this option is omitted, the name of the host where the pdgeter command is executed is assumed.
Specifies the type of error information that is to be acquired:
Table 2-1 Error information acquired depending on -a option specification
Information acquired | -a option | Remarks | |
---|---|---|---|
Specified | Omitted | ||
All files under $PDDIR/spool directory | u | u | None |
All files under $PDDIR/conf directory | u | u | |
All files under $PDDIR/.dbenv directory | u | u | |
RPC trace file | u | u | |
All files under $PDDIR/tmp directory | u | N | |
pdinit control statement | O | O | Before executing the pdgeter command, first copy the following file name under the $PDDIR/conf directory of the host where command is executed: pdinit control statement: $PDDIR/conf/INITCONT The following indicates the host of the copy destination:
|
pdmod control statement | O | O | Before executing the pdgeter command, first copy to the $PDDIR/conf directory of one of the hosts for which error information is to be acquired. |
Master directory | O | N |
|
Data directory | O | N | |
Data dictionary | O | N | |
OS library | u | u | Information depends on the OS:
|
Sort library | N | N | None |
Shared memory contents | O | O |
Formula for shared memory used by unit controller (20.1.2(1)) + formula for shared memory used by single server (20.1.2(2)). HiRDB/Parallel Server Formula for shared memory used by unit controller (20.2.2(1)) + formula for shared memory used by each server (20.2.2(2)).These sizes can be verified by executing the pdls -d mem command while HiRDB is active. |
System information | O | O |
|
Log | N | N | None |
System log file | N | N | |
User RDAREA | N | N |
u: Information is acquired.
O: Information acquisition depends on the details in the Remarks column.
N: Information is not acquired.
Specify this option when directing the output of troubleshooting information to a non-DAT tape device. Note that AIX 5L does not support this option.
When specifying this option, be sure to specify the name of a work directory using the -w option.
The pdgeter command uses the append option (-r option) of the tar command to record troubleshooting information onto a tape device. However, some tape devices do not support the append option. Therefore, error information cannot be output to this tape device.
The -t option temporarily stores the troubleshooting information to be recorded on a work directory and then writes the information to the tape device, even without an append option. Therefore, the -t option allows the system to record troubleshooting information on tape devices other than DAT drives.
Rules
Notes
Hosts specified in -x option | Output destination specified in -o option | |
---|---|---|
Directory | Device | |
One |
|
|
Multiple |
|
|
Output format
Information is output in the following format to the directory or device specified in the -o option.
The file name is shown as follows, depending on the -o and -w specifications:
Host specified in -x option | Output destination specified in -o option | |
---|---|---|
Directory | Device | |
Only host where pdgeter command is executed is specified | host-name.time.Z | Individual error information1 |
Host other than host where pdgeter command is executed is also specified | host-name.time.Z | host-name.time.Z |
Regardless of the -o and -w specifications, the execution results of operating system commands issued in a pdgeter command are output to a file named pdgeter.comlog.time.
If host-name.time.Z is expanded, the file name will be host-name.time. The host-name.time file comprises three or four files. Figure 2-3 shows the contents of the host-name.time file.
Figure 2-3 Contents of host-name time file
Usage examples