The pdgeter command outputs error information to a specified directory or DAT drive when an error occurs in the HiRDB system. Normally, you will use the pdinfoget command to acquire error information.
HiRDB administrator
pdgeter [{-o output-destination-directory-name |
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-6 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 |
|
System information | O | O |
|
Log | N | N | None |
System log file | N | N | |
User RDAREA | N | N |
Specify this option when directing the output of troubleshooting information to a non-DAT tape device. Note that AIX 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.
Hosts specified in -x option | Output destination specified in -o option | |
---|---|---|
Directory | Device | |
One |
|
|
Multiple |
|
|
Information is output in the following format to the directory or device specified in the -o option.
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 information# |
Host other than host where pdgeter command is executed is also specified | host-name.time.Z | host-name.time.Z |
Figure 2-4 Contents of host-name.time file
pdgeter -o/errl -x hostl |
pdgeter -o/dev/dat01 -w/work -x host2,host3 |