pdls (Display HiRDB system status)

Common function

The pdls command displays the status of the HiRDB system for a specified display object.

Common executor

Any user (with or without privileges)

Common format

HiRDB/Single Server

pdls [-d display-object-type [display-object-type-options]]

Note
The specifiable options depend on the display object type.
HiRDB/Parallel Server

pdls [-x host-name[,host-name]...]
     [-d display-object-type [display-object-type-options]]

Common options

Specifies the name of the host of the server for which status is to be displayed.

When this option is omitted, the items for the specified display object type are displayed for all servers in the system. If -d aud is specified, you cannot specify the -x option.

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

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 is not applicable to the specified display object is ignored, if specified.
  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).

Common note

  1. If you specify the TMPDIR environment variable and cancel the pdls command or another HiRDB command during execution, files whose names begin with pdcmd may remain in the directory set by TMPDIR. In such a case, use the OS's rm command to delete those files.
  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.