2.61 pdls (Display HiRDB system status)

Organization of this section
(1) Common function
(2) Common executor
(3) Common format
(4) Common options
(5) Common rules
(6) Common note

(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

  1. 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.
  2. 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.
  3. An option that can be specified for any other display object type is ignored if it is specified as the display object type option.
  4. 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

  1. 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.
  2. 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.
  3. 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)