Filter settings for log (message) output

You can selectively output log (messages) records by message level and message number. By using these settings, you can easily monitor only messages that you want to check.

This section explains the various settings and provides examples of operation.

Filtering by message level

You can set the filtering to output log records to the trace log and syslog based on the message level.

There are three message levels: "Information", "Warning", and "Error".

For details about message levels, refer to the following:

Filtering by message number

You can set the filtering to selectively suppress message output to the trace log and syslog. To do this, write a filter setting separately for each message number.

Describe the filter settings in the file "Message Filter file."

 

This section describes how to configure the Message Filter file.

File Name

The name of the Message Filter file is "msgfilter.info." You cannot change this name.

The Message Filter file is placed in the path (HULPATH) in which the system file used by HULFT exists.

Description Format

Message_Number tracelog syslog

• A line with '#' at the beginning is considered as a comment line.

• Space codes and tab codes at the beginning of each line are skipped.

• The space code (0x20) or tab code (0x09) is used as the delimiter between fields.

  Even if a space code and a tab code appear consecutively, HULFT considers these codes to be a single delimiter.

• If there are multiple records with the same message numbers, the last record registered is used.

• If HULFT detects a record that meets any of the following conditions, HULFT skips the record:

  • The record is written in an invalid format.

  • The message number is invalid.

  • Unallowed characters or numerical values are specified.

Record Layout

msgfilter.info (Message Filter file) does not contain binary data. You can create the file with a text editor such as Notepad. Write a record for each message number. Write one message number per line.

The maximum length of one line (record) is 1,024 bytes.

Explanation of each field

The following provides an explanation of each field.

Message Number

Specify the message number to define.

For details about message numbers, refer to the following:

HULFT10 for Linux/AIX Error Codes and Messages : Common header area

tracelog

Specify whether to output the log records that have the specified message number to the trace log.

0:

Do not output the log records

1:

Output the log records

syslog

Specify whether to output the log records that have the specified message number to syslog.

0:

Do not output the log records

1:

Output the log records

Setting Example

# HULFT10 Message Filter 
# 
#       ID          Message number 
#       tracelog    0: No Output 1: Output 
#       syslog      0: No Output 1: Output 
# 
# ID        tracelog      syslog 
# E1234567  1             0         # This ID is commented out. 
E001002     0             0         # Ignore this message. 
I200789     1             1         # Forcibly output this message to both logs. 
A111111     1             1         # Invalid record 
W001003     9             8         # Invalid record

Operation example

To determine which log (messages) records are output to a log, you can combine the message level filter settings with the message number filter settings.