2.61 pdls (Display HiRDB system status)
(1) Common function
The pdls command displays the status of the HiRDB system for a specified display object.
(2) Common executor
Any user (with or without privileges)
(3) Common format
pdls [-d display-object-type [display-object-type-options]] |
- Note
- The specifiable options depend on the display object type.
(4) Common options
(a) -d display-object ~<<svr>>
Specifies the type of object whose status is to be displayed:
- act
- User status
- aud
- Status of audit trail files
- ha
- System status when system switching facility is used
- lck
- Server lock status
- mem
- Information about common server memory
- org
- Progress of reflection processing for online reorganization
- prc
- Server processing status
- ris
- Execution status of log application processing at the log application site (applicable only when Real Time SAN Replication based on the log-only synchronous method is used).
- rpc
- Displays server communication control information
- rpl
- HiRDB Datareplicator linkage status
- scd
- Server scheduling status
- stj
- Displays whether types of statistical information output by unit and server are specified
- sts
- Status file status
- svr
- Unit and server status
- trn
- Server transaction status
(5) Common rules
- When aud, ha, rpl, or ust is specified in the -d option, you can execute the pdls command whether or not HiRDB is active. The pdls command with any other option specified can be executed only when HiRDB is running.
- You can execute the pdls command with -d ha, lck, svr, trn, or ust specified from any server machine (except a server machine on a utility special unit). Otherwise, this command must be executed at the server machine that contains the single server or where the system manager is located. If you have specified -d ris, execute the command at the log application site of the server machine that contains the single server, or where the system manager is located.
- An option that can be specified for any other display object type is ignored if it is specified as the display object type option.
- When you execute the pdls command, we recommend that you specify $PDDIR/bin/pdls (if you specify pdls, another program product's command that has the same name may be executed).
(6) Common note
- If you specify in the system definition only the TMPDIR environment variable without specifying the pd_tmp_directory operand and you cancel the pdls command or other HiRDB command during execution, a file whose name begins with pdcmd might remain in the directory set by the TMPDIR environment variable. In this case, use the OS's rm command to delete such a file.
- When the standby-less system switchover (effects distributed) facility is used, the server switched over to another unit is treated as the target unit's server.
- You might not be able to check the operating status of a unit correctly if you execute the command at the following times:
- While system switchover is underway
- Before the unit's status is detected (during the period specified in the pd_host_watch_interval option in the system definition)