pdcat [-d option omitted]

Function

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

Executor

Any user (with or without privileges)

Format

HiRDB/Single Server

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

HiRDB/Parallel Server

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]

Options

-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.

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 8 Messages). When this option is omitted, messages are not selected on the basis of significance codes.

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[Figure]<identifier> ((1-32))
To display messages by host, specifies the host's name.
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[Figure]<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.

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.

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.

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.

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

Command arguments

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:

Rules

  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.

Notes

  1. For a HiRDB/Parallel Server, 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.

Output format

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

Explanation
aa...a
Message serial number (7 decimal digits).
bb...b
Process ID (10 decimal digits).
cc...c
Message serial number within the process (server) (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 (8 characters).
jjj
Internal information used by the system (3 characters).
kk...k
Message ID (11 decimal digits).
ll...l
Message text (up to 223 characters).