The pdcat command displays messages contained in a message log file.

Any user (with or without privileges)

(a) HiRDB single server configuration

 
 pdcat [-{a| b | ab } ] [-c significance-code[,significance-code]...]
       [-y yyyymmdd] [-t hhmmss] [-T hhmmss] [-n records-count]
       [filename]
 

(b) HiRDB parallel server configuration

 
 pdcat [-{a| b | ab } ] [-c significance-code[,significance-code]...]
       [-x host-name| -u unit-identifier]] [-y yyyymmdd]
       [-t hhmmss] [-T hhmmss] [-n records-count]
       [filename]
 

(a) -{a | b | ab}

-a

Specifies that all message information except the message IDs and message texts is to be displayed.

-b

Specifies that the message IDs and message texts only are to be displayed.

-ab

Specifies that all message information is to be displayed.

(b) -c significance-code

Specifies a significance code when specific messages are to be selected on the basis of their significance codes (for details about significance codes, see the manual HiRDB Version 9 Messages). When this option is omitted, messages are not selected on the basis of significance codes.

(c) {-x host name| -u unit-identifier}

To display messages by host or unit, specifies the unit's unit identifier or the host's host name. When this option is omitted, messages for all hosts or units are displayed.

-x host-name ~<identifier> ((1-32))

To display messages by host, specifies the host's name. If a host name is specified in the -x option of the pdunit operand, specify that host name. If no host name is specified in the pdunit operand's -x option, specify the standard host name. If this option is omitted, message logs are output to all hosts.

To display server-related messages when the standby-less system switchover (effects distributed) facility is used, you must specify the name of a host whose server is running. This is because messages on the server in the switched system are being output to the message log for the host whose server is running.

-u unit-identifier ~<identifier> ((4 characters))

To display messages by unit, specifies the unit identifier of that unit.

To display server-related messages when the standby-less system switchover (effects distributed) facility is used, you must specify the identifier of a unit whose server is running. This is because messages on the server in the switched system are being output to the message log for the unit whose server is running.

(d) -y yyyymmdd

Specifies a date, when only messages for and subsequent to the specified message log date are to be displayed (in the format year-month-date, where the year consists of the four-digit calendar year, and the month and date each consist of two digits). When this option is omitted, messages are not selected on the basis of the message log date.

(e) -t hhmmss

Specifies a time, when only messages for and subsequent to the specified message log time are to be displayed (in the format hour-minute-second). When this option is omitted, messages are not selected on the basis of a message log begin time.

(f) -T hhmmss

Specifies a time, when only messages for and prior to the specified message log time are to be displayed (in the format hour-minute-second). When this option is omitted, messages are not selected on the basis of a message log end time.

(g) -n records-count ~<unsigned integer> ((1-32767))

Specifies the maximum number of message log records to be displayed. When this option is omitted, all selected message log records are displayed.

(a) filename ~<path-name>

Specifies the name of the message log file to be displayed. A file created by copying a message log file can be specified. When this option is omitted, the messages in the following message log files are merged into chronological order and then displayed:

• $PDDIR/spool/pdlog1
• $PDDIR/spool/pdlog2

1. The pdcat command can be executed only while HiRDB is active.
2. The pdcat command can be executed from any server machine except one that contains a utility special unit.
3. In a HiRDB parallel server configuration, if there is a host whose name consists of eight or more characters, specify the -u option to output information for each unit.

1. In a HiRDB parallel server configuration, the storage location of the message log file depends on the pd_mlg_msg_log_unit operand value in the system definition, as shown below:
   
   • When pd_mlg_msg_log_unit=manager is specified
     Unit where the system manager is located
     
   • When pd_mlg_msg_log_unit=local is specified
     All units
     
2. If pd_mlg_msg_log_unit=local was specified, the pdcat command displays the contents of the message log file for the corresponding unit. If pd_mlg_msg_log_unit=manager was specified or the pd_mlg_msg_log_unit operand was omitted, and if the system manager is located on the unit, the command displays the contents of the message log file for that unit; if the system manager is not located on the unit, the command displays nothing.
3. If there are hosts whose name consists of eight or more characters and a host name consisting of eight or more characters is specified in the -x option, HiRDB outputs information about all hosts whose host name begins with the specified eight characters.

 
 aa...a bb...b cc...c dddd ee...e ff...f gg...g hhhh ii...i
 jjj kk...k ll...l
 

Explanation

The items are separated by at least one single-byte space.

aa...a

Message sequence number (maximum of 7 decimal digits).

bb...b

The process ID. In AIX or HP-UX (IPF), this is a maximum of 10 right-aligned decimal digits. In any other OS, this is a maximum of five right-aligned decimal digits if the value is 99999 or less, and a maximum of 10 left-aligned decimal digits if the value is 100000 or more.

When the value is 100000 or more in any OS other than AIX or HP-UX (IPF), the items that follow the message sequence number within the process are shifted to the right.

cc...c

Message sequence number within the process (maximum of 7 decimal digits).

dddd

HiRDB identifier (4 characters).

ee...e

Date (in the format year/month/date) (10 decimal digits).

ff...f

Time (in the format hour:minute:second) (8 decimal digits).

gg...g

Request source host name (first 8 characters).

When the standby-less system switchover (effects distributed) facility is used, this is the name of the host whose server is running.

hhhh

Unit identifier (4 characters).

When the standby-less system switchover (effects distributed) facility is used, this is the identifier of the unit whose server is running.

ii...i

Message output request source server name (maximum of 8 characters).

jjj

Internal information used by the system (3 characters).

kk...k

Message ID (maximum of 11 decimal digits).

ll...l

Message text (up to 223 characters).

Output example

This example includes process IDs that are 100000 or more, for UNIX editions other than AIX and HP-UX (IPF):

12 38095 1 PRDB 2014/04/07 17:18:46 HOST0001 UNT0 _rdm rdm KFPS05220-I HiRDB system termination process started. mode = NORMAL ... Process ID is 99999 or less 13 108221 0 PRDB 2014/04/07 17:18:47 HOST0001 UNT0 _pdustop adm KFPS01840-I Now terminating HiRDB unit UNT0 ... Process ID is 100000 or more 14 8101 0 PRDB 2014/04/07 17:18:47 HOST0001 UNT0 _trn trn KFPS00958-I Unit terminating; stops receiving new transactions ... Process ID is 99999 or less