Nonstop Database, HiRDB Version 9 System Operation Guide

[Contents][Index][Back][Next]

8.1.4 Suppressing message output to syslogfile

HiRDB outputs information such as error information, transaction information, and system file information to syslogfile as messages that indicate the system's operating status. Although these types of information are important for determining the operating status of HiRDB, a large volume of message information might be output depending on the operating environment, making it difficult and time-consuming to find relevant messages. You can improve message retrieval efficiency by suppressing unnecessary messages from being output to syslogfile.

Organization of this subsection
(1) Environment settings
(2) Processing when message output is suppressed
(3) Exceptions to message output suppression
(4) Usage examples
(5) Notes
(6) Relationship to other facilities (applicable only to a HiRDB parallel server configuration)

(1) Environment settings

You use the pdmlgput operand to specify the messages that are to be suppressed. This operand can also be used to specify the following:

(2) Processing when message output is suppressed

When message output suppression is specified, the specified messages are not output to syslogfile. Suppressed messages are output to the message log files. The following table shows the differences in message output processing depending on whether message output suppression is in effect.

Table 8-3 Differences in message output processing depending on whether message output suppression is in effect

Output suppression specification Server machine in which the system manager is defined Server machine in which the system manager is not defined
syslogfile Message log file syslogfile Message log file
Output suppression is not specified Y Y N#1 N
Output suppression is specified N Y#2 N Y#1, #3

Legend:
Y: Messages are output.
N: Messages are not output.

Note
For a HiRDB single server configuration, use the columns for Server machine in which the system manager is defined.

#1: For a HiRDB parallel server configuration, message logs are output to syslogfile and the message log files of the server machine where the system manager is defined. However, in the following cases, messages might not be output at all or might be output to syslogfile of the server machine that issued the messages:
  • The system monitor unit has not started yet or has encountered an error.
  • The message log server has terminated abnormally or has not been restarted yet.
  • The server machine is a standby system.

#2: Messages that are normally output to both syslogfile and the message log files are now output only to the message log files.

#3: For a HiRDB parallel server configuration, pdlog1 and pdlog2 (message log files) are created under $PDDIR/spool of the server machine in which the system manager is not defined, and messages that used to be output to syslogfile are now output to these message log files.

(3) Exceptions to message output suppression

In the cases below, message output is not suppressed; instead, messages are output to syslogfile.

(a) When an error occurs in a message log file

When an error occurs in a message log file, an error message is output to syslogfile. Messages that cannot be output to the message log file because of the error are output to syslogfile.

(b) When the HiRDB system definition contains an error

Messages that report a HiRDB system definition error are not suppressed. Such error messages are output to syslogfile.

(c) Messages that are output when commands are executed

Messages that are output when the following commands are executed are not suppressed:

(4) Usage examples

(a) Example 1

No messages are output to syslogfile and all messages are output to the message log files. The following an example of specifying the pdmlgput operand for this case:

 
pdmlgput -s N -c ALL
 
(b) Example 2

The KFPS01820 and KFPS00105 messages are not output to syslogfile, but instead are output to the message log files. The following is an example of specifying the pdmlgput operand for this case:

 
pdmlgput -s N -m KFPS01820,KFPS00105
 
(c) Example 3

Only the KFPH00211 and KFPH00212 messages are output to syslogfile and all other messages are output to the message log files. The following is an example of specifying the pdmlgput operand for this case:

 
pdmlgput -s N -c ALL                          ...1
pdmlgput -s Y -m KFPH00211, KFPH00212         ...2
 

Explanation
  1. No messages are to be output to syslogfile and all messages are to be output to the message log files.
  2. The KFPH00211 and KFPH00212 messages are to be output to both syslogfile and the message log files.

(5) Notes

(a) Processing when a message log file becomes full

When a message log file's capacity (value of the pd_mlg_file_size operand) is reached, the output destination for messages is swapped to the other message log file. When this swapping occurs, the KFPS01910-I message is output to syslogfile. If output of the KFPS01910-I message is suppressed, it is output to the message log file that was being used before swapping. If you are monitoring the message log file, you must swap the monitoring-target message log file whenever the KFPS01910-I message is output.

(b) Message log file size

When message output suppression is in effect, you must allocate a sufficient size for the message log file. Use the pd_mlg_file_size operand to specify a message log file size.

When message output suppression is in effect, a large volume of messages might be output to the message log file depending on the operating environment. Therefore, if the message log file size is insufficient, message log files are overwritten frequently, and there is a possibility that important messages, such as system operating status and troubleshooting information, which are output only to message log files might be erased.

(6) Relationship to other facilities (applicable only to a HiRDB parallel server configuration)

The following table shows HiRDB processing when message output suppression is used in combination with message log output dispersion.

Table 8-4 Processing by HiRDB when message output suppression is used in combination with message log output dispersion

Condition Message output destination
When message output suppression is not used When message output suppression is used
Message log output dispersion Not used
  • Message log file of the server machine where the system manager is defined
  • syslogfile of the server machine where the system manager is defined

  • Message log file of the server machine where the system manager is defined
Used
  • Message log file of each server machine
  • syslogfile of each server machine

  • Message log file of each server machine