The pdinfoget command acquires error information when a failure occurs in the HiRDB system in order to determine the cause of the failure. It can also be used to estimate the amount of information to be acquired.
HiRDB administrator who is authorized to reference information files output by HiRDB as well as OS information files
pdinfoget -e initial-information-file-output-directory-name |
pdinfoget -m |
Specifies the absolute path name of an existing directory to which the initial information file (containing information needed to determine the cause of a failure) is to be output. The maximum length of a directory name is as follows.
If the specified directory does not exist or the write privilege for it has not been granted, the command outputs an error message and cancels processing.
The command outputs the initial information file and the execution log to the specified initial information file output directory. The initial information file is an archive file that consists of multiple files. The names of the files are formatted as shown below:
For details about the error information that is collected in the initial information file, see Table 2-10 List of error information acquired by the pdinfoget command.
Specifies the absolute path name of an existing directory to which the detail information file (containing information needed for further investigation after the cause of an error has been determined) is to be output. The maximum length of a directory name is as follows:
If the specified directory does not exist or the write privilege for it has not been granted, the command outputs an error message and cancels processing.
The detail information file is an archive file that consists of multiple files. The names of the files are formatted as shown below:
For details about the error information that is collected in the detail information file, see Table 2-10 List of error information acquired by the pdinfoget command.
After acquiring error information, the pdinfoget command archives or compresses the error information by executing a HiRDB or OS command. This option specifies the absolute path name of an existing directory that is to be used to store temporary work files. The maximum length of a directory name is as follows:
If the specified directory does not exist or the write privilege for it has not been granted, the command outputs an error message and cancels processing.
The command creates work directory pdinfoget_work_date-and-time under the specified directory and then stores work files in that directory. If there is already a directory named pdinfoget_work_date-and-time, the command terminates with an error.
If this option is omitted, the following directory is assumed:
-w option | pd_tmp_directory operand in system definition | ||
---|---|---|---|
Specified | Omitted | ||
TMPDIR environment variable# | |||
Specified | Omitted | ||
Specified | Directory specified in the -w option | ||
Omitted | Directory specified in pd_tmp_directory | Directory specified in TMPDIR | /tmp directory |
These files are deleted when the processing terminates.
Note that if an error occurs during the processing, the files might not be deleted. If this happens, delete the files manually.
Specifies the absolute path name of the syslogfile that is set to be acquired by default by the pdinfoget command.
The table below shows the syslogfile that is acquired by the pdinfoget command by default.
Platform | File acquired by default |
---|---|
HP-UX | /var/adm/syslog/syslog.log |
AIX | /tmp/syslog.out |
Solaris | /var/log/syslog |
Linux | /var/log/messages |
You might need to use the -s option to acquire a file in the following cases:
This option is related to memory databases. Normally, you must not specify this option.
Specifies the absolute path name of an existing directory to which an XDS shared memory dump file is to be output. If this option is omitted, an XDS shared memory dump file is not acquired. The maximum length of a directory name is as follows:
If the specified directory does not exist or the write privilege for it has not been granted, the command outputs an error message and cancels processing.
For the destination of the XDS shared memory dump file, allocate an amount of space that is at least equal to the value displayed by the -m option as the estimated amount of error information.
If the-m option was not able to provide a value for the estimated amount of error information (because, for example, an error occurred), you must allocate at least twice the sum of the sizes of the database areas for all XDSs in the server machine where the pdinfoget command is executed. For details about estimating the sizes of the database areas for XDSs, see Estimating memory requirements in the HiRDB Version 9 Memory Database Installation and Operation Guide.
Do not specify for the output directory any directory under $PDDIR. If such a directory is specified, HiRDB might terminate abnormally due to a shortage of space.
An XDS shared memory dump file is output when the conditions shown in the table below are satisfied:
Condition | Whether XDS shared memory dump file is output | |
---|---|---|
-b option | XDS status | |
Specified | Running | Output |
Inactive | Output However, if there is no information in the shared memory, the XDS shared memory dump file is not output. |
Specifies that an estimate of the size of the error information to be acquired is to be output. The size estimates are output to the standard output in the following format:
File type | Display format (megabytes) |
---|---|
Initial information file | init_directory = xxx Mbyte |
Detail information file | detail_directory = yyyy Mbyte |
XDS shared memory dump file | dump_directory = zzzz Mbyte# |
Performance trace information | prf_directory = wwww Mbyte# |
Legend: xxx, yyyy, zzzz, wwww: Numeric value
If you also specify the -s option to acquire error information, the estimate includes the size of that error information. For this reason, always specify the -s option. If an option other than -s is specified together with -m, the command will terminate with an error.
Specifies that the size of performance trace information files is not to be estimated or acquired. Specify this option in the following cases:
Table 2-10 List of error information acquired by the pdinfoget command
Information item to be acquired | Whether acquired | Initial information | Detail information | |||
---|---|---|---|---|---|---|
HiRDB command | Information about HiRDB status acquired by executing a HiRDB command | Unit and internal component status | Y | Y | N | |
Server process status | Y | Y | N | |||
HiRDB server's schedule status | Y | Y | N | |||
HiRDB server settings | Y | Y | N | |||
HiRDB server status in unit | Y | Y | N | |||
Information about transaction being executed | Y | Y | N | |||
User identifier information | Y | Y | N | |||
Lock information | Y | Y | N | |||
Lock pool usage status | Y | Y | N | |||
Internal lock information | Y | Y | N | |||
Semaphore information | Y | Y | N | |||
Message queue information | Y | Y | N | |||
Unit and server status | Y | Y | N | |||
Shared memory information | Y | Y | N | |||
HiRDB version information | Y | Y | N | |||
Server process communication control information | Y | Y | N | |||
Global buffer usage information | Y | Y | N | |||
RDAREA status display | Y | Y | N | |||
SQL object information | Y | Y | N | |||
Real Time SAN Replication information | Y | Y | N | |||
System switchover facility information | Y | Y | N | |||
XDS summary error information | Y | Y | N | |||
XDS database status | Y | #3 | N | |||
HiRDB information file | Definition referenced by HiRDB and resulting output file | All directories and files under $PDDIR/spool | Y | N | Y | |
Configuration interface under $PDDIR | Y | Y | N | |||
Files under $PDDIR/spool | Command log file | Y | Y | N | ||
Message log file | Y | Y | N | |||
Error log file | Y | Y | N | |||
Failure snap information file | Y | Y | N | |||
Abort information file | Y | Y | N | |||
cwaitover information file | Y | Y | N | |||
Performance trace information | Y | N | Y | |||
System definition information (conf/*, %PDCONFPATH%) | Y | Y | N | |||
Simple setup tool information (pdistup/*) | bin | N | N | N | ||
conf | N | N | N | |||
ini | N | N | N | |||
sample | Y | Y | N | |||
tmp | Y | Y | N | |||
spool | Y | Y | N | |||
pdi_log.txt | Y | Y | N | |||
HiRDB database environment information ($PDDIR/.dbenv/*) | Y | Y | N | |||
Under HiRDB internal work directory ($PDDIR/tmp/*) | Y | N | Y | |||
Client trace information (files under $PDCLTPATH) | SQL trace information | Y | #1 | #1 | ||
Error log file | Y | Y | N | |||
pdess* file | Y | Y | N | |||
UAP statistical information | Y | Y | N | |||
Performance trace information file (output to the directory specified in the pd_prf_output_directory operand) | Y | N | Y | |||
Configuration information for performance trace information file (configuration information for the directory specified in the pd_prf_output_directory operand) | Y | Y | N | |||
OS command | Information about OS status acquired by executing a command | Process information | Y | Y | N | |
Disk information | Y | Y | N | |||
Status of inter-process communication facility | Y | Y | N | |||
CPU usage rate and disk status | Y | Y | N | |||
Process's CPU activity and memory status | Y | Y | N | |||
Virtual memory status | Y | Y | N | |||
Kernel parameter | Y | Y | N | |||
Host name | Y | Y | N | |||
Information about the maximum values for system resources | Y | Y | N | |||
OS performance information | Y | Y | N | |||
OS information file | Definition referenced by OS and resulting output file | OS version information | Y | Y | N | |
Machine information | Y | Y | N | |||
Processor information | Y | Y | N | |||
Installed memory information | Y | Y | N | |||
Environment variable information | Y | Y | N | |||
Network information | Y | Y | N | |||
Network status information | #2 | Y | N | |||
Disk information | #2 | Y | N | |||
syslogfile | Y | Y | N | |||
Back trace information | Y | Y | N |
Condition | Whether XDS database status information is acquired | |
---|---|---|
XDS status | System used to execute command | |
Running | Running system | Acquired |
Standby system | Not acquired | |
Inactive | Running system | Not acquired |
Standby system | Not acquired |
Table 2-11 Directories that cause an error if located in an output directory
Output directory | Directories that cause an error if located in the output directory |
---|---|
Output directory for initial information file | CLTDIR PDDIR spool conf .dbenv pdistup OSFILE SYSLOG COREINF PRF |
Output directory for detail information file | PDDIR spool tmp CLTDIR PRF |
KFPN10403-I init information file output, file=initial-information-file-path-name |
Return code | Termination status | Meaning and action |
---|---|---|
0 | Normal termination | Terminated normally. If the KFPN10451-I message has been issued, archiving or compression of the error information has not been completed.
|
4 | Warning termination |
|
8 | Abnormal termination | Processing was canceled because of an error.
|
12 | Termination by interrupt (signal generation) | Processing was canceled by an interrupt (signal generation). |