Filter settings for console message outputs

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

This section explains adjusting filter settings, operation examples, and message numbers that are excluded from the filter settings.

Filtering messages by message level

You can selectively output messages by message level.

There are three message levels: "Information (ML=I)," "Warning (ML=W)," and "Error (ML=E)."

For details about the message levels, refer to the following:

HULFT10 for zOS Error Codes and Messages : Message level

Method of setting

Specify the following field in the System Environment Settings:

Output Toggles By Message Severity Level (CONSOLELOG)

The default setting is "111" (Output messages for all message levels).

For details on the settings of each field and setting examples, refer to Explanation of each field.

Note

Messages at the message level "Information (ML=I)" include messages that HULFT recommends to output.

When you suppress the output of "Information (ML=I)" in the filter settings by message level, the messages that are recommended to be output are also suppressed, unless you separately set the filter by message number in the message filter file in order to output the messages. For details, refer to Filtering messages by message number.
If settings are made in the message filter file, they override the settings you have made for each message level. For details on the message filter file, refer to Filtering messages by message number.

Filtering messages by message number

You can specify whether or not HULFT outputs specific console messages.

You must describe the filter settings by message number in a file that is called the "message filter file."

This section describes how to configure the message filter file.

Note

The following messages that HULFT recommends to output are described in the installed message filter file "HULFT.PARMLIB(MSGFILTR)" in advance.
- Indicates completion of transfer
- Indicates startup or shutdown of the HULFT
- Indicates the result of executing a command, status of the send queue, or cancelation
When you suppress the output of "Information (ML=I)" in the filter settings with a message level, the messages that are recommended to be output are also suppressed, unless you set the filter with message number in the message filter file in order to output the messages.
You can specify whether to output messages according to message level as described in Filtering messages by message level. However, for messages that are specified in the message filter file, the settings of the message filter file override message level settings.

File name

The member name of the message filter file is "MSGFILTR." The message filter file is placed in the "HULFT parameter library."

You can change the file name of the message filter file to any name.

System Environment Settings file

Specify the file name of the message filter file for Message Filter File (CONS-MSGFILTER) in the System Environment Settings.

CONS-MSGFILTER=File name of the message filter file

Description format

Message number, Output Setting

Write a record from the first column. Do not specify spaces at the beginning.
Separate a message number and its output setting with a comma ",". Do not specify unnecessary spaces.
You cannot specify wildcards such as an asterisk "*" in the message number.
If there are multiple records with the same message numbers, the last record registered is used.
A line with "*" in the first column is considered a comment line.
If HULFT detects a record that meets any of the following conditions, HULFT skips the record:
- The specified message number does not exist.
- A wildcard such as an asterisk "*" is specified in the message number.
- A character other than a comma "," has been used as a separator between the message number and the output setting, or there is no comma ",".
- Unnecessary spaces are specified at the beginning of the record or between the fields.

Record layout

Edit the message filter file with a text editor. Write a record for each message number. Write one message number per line.

Explanation of each field

An explanation of each field is given below.

Message Number

Specify the message number to be defined.

For details about the message numbers, refer to the following:

HULFT10 for zOS Error Codes and Messages : Console Message Output Option function

Output Setting

Specify whether or not to output messages for the specified message number.

0:: Do not output the messages
1:: Output the messages

= Remarks =

For message numbers, you can specify a conventional message number or an enhanced message number.
If the conventional and enhanced messages are switched according to the setting of the Console Message Output Option (CNSSELECT), the output of both messages can be set to enable or disable by specifying one of the message numbers.

Example: When you specify "XRT0023,0"

If Console Message Output Option (CNSSELECT) is set to "0 (Conventional Message)", the output for XRT0023 is suppressed. If the field is set to "1 (Enhanced Message)", the output for XRT8023 is suppressed.
To specify whether or not to output a message that only has an enhanced message number, specify that number. The specification sets whether the corresponding conventional message is output.

Example: When you specify "XRA1001,1"

If Console Message Output Option (CNSSELECT) is set to "0 (Conventional Message)", "* SEND * SEND ERROR RC=code FILEID=fileid" is output. If the field is set to "1 (Enhanced Message)", XRA1001 is output.

Setting example

[Description example]

XR0000,1                                   -+                                   
XR0009,1                                    |                                   
XR0016,1                                    |                                   
XRA0000,1                                   |                                   
XRA0006,1                                   |                                   
XRA0042,1                                   |                                   
XRR0000,1                                   |--(*1)                             
XRR0006,1                                   |                                   
XRR0034,1                                   |                                   
XRR0042,1                                   |                                   
XRR0106,1                                   |                                   
XRR0125,1                                   |                                   
XRT0017,1                                   |                                   
XRT0057,1                                   |                                   
XRT0077,1                                  -+                                   
                                                                                
XRU0001,1                                                                       
XRU0002,0

Messages recommended to be output

It is recommended that you do not change this setting.

Operation examples

To determine which messages are output, you can combine the message level filter settings with the message number filter settings.

To output messages with a specific message number

Example

To not output any level of messages and to output only messages with the message number "XRU0001," specify the following:

Specify "000" for Output Toggles By Message Severity Level (CONSOLELOG) in the System Environment Settings.
```
CONSOLELOG=000
```
In the message filter file, add a record for outputting messages with the message number "XRU0001."
```
XRU0001,1
```

To not output messages with a specific message number

Example

To output all messages other than messages with the message number "XRU0002," specify the following:

Specify "111" for Output Toggles By Message Severity Level (CONSOLELOG) in the System Environment Settings.
```
CONSOLELOG=111
```
In the message filter file, add a record for suppressing the output of messages with the message number "XRU0002."
```
XRU0002,0
```

Messages that cannot be filtered

Because messages that report results of user operations or commands and messages that prompt a response must always be output, these cannot be filtered.

The following list shows messages that cannot be filtered. These messages are always output, regardless of filter settings.

Table 3.10 List of messages that cannot be filtered
Message Level	Message Number
Information (I)	XR0010, XR0012, XR0013, XR0014, XR0017, XR0018, XR0019, XR0020, XR0021, XR0026, XR0027, XR0028, XR0029, XR0030, XR0031, XR0032, XR0033, XR0036, XR0037, XR0038, XR0039, XR0042, XR0043, XR0044, XR0045, XR0046, XR0065, XR0066, XR0067, XR0068, XR0069, XR0070, XR0073, XR0076, XR0085, XR0086, XR0091, XR0092, XR0093, XR0094, XR8013, XR8027, XR8029, XR8042, XR8045, XR8076, XRR0026, XRR0027, XRR0028, XRR0029, XRR0030, XRR0032, XRR0033, XRR0035, XRR0036, XRR0037, XRR0038, XRR0092, XRR0093, XRR0094, XRR0095, XRR0098, XRR0099, XRR0103, XRR0139, XRR8027, XRR8035, XRR8038, XRA0021, XRA0022, XRA0025, XRA0026, XRA0027, XRA0028, XRA0029, XRA0030, XRA0032, XRA0033, XRA0037, XRA0038, XRA0064, XRA0065, XRA0066, XRA0067, XRA0070, XRA0071, XRA1303, XRA1304, XRA1305, XRA8038
Warning (W)	XR0048, XR8048, XRRM003, XRP0001, XRP0003, XRP0004, XRP0005, XRP0008, XRP0009, XRP0010, XRP0011, XRP0012, XRP0013, XRP0014, XRP0015, XRP0016, XRP0017, XRP0018, XRP0019, XRP0020, XRP0021, XRP0022, XRP0023, XRP0024, XRP0025, XRP0026, XRP0027, XRP0028, XRP0029, XRP0030, XRP0031, XRP0032, XRP0033, XRP0034, XRP0035, XRP0036, XRP0037, XRP0038, XRP0039, XRP0040, XRP0041, XRP0042, XRP0046, XRP0047, XRP0048, XRP0049, XRP0050, XRP0051, XRP0052, XRP0053, XRP0054, XRP0055, XRP0056, XRP0057, XRP0058, XRP0059, XRP0060, XRP0061, XRP0063, XRP0064, XRP0065, XRP0066, XRP0067, XRP0068, XRP0069, XRP0070, XRP0071, XRP0072, XRP0098, XRP0099, XRP0100, XRP0103, XRP0104, XRP0105, XRP0106, XRP0107, XRP0110, XRP0111, XRP0112, XRP0114, XRP0115, XRP0117, XRP0118, XRP0122, XRP0124, XRP0125, XRP0126, XRP0127, XRP0128, XRP0129, XRP0130, XRP0131, XRP0132, XRP0133, XRP0134, XRP0135, XRP0136, XRP0137, XRP0138, XRP0139, XRP0140, XRP0141, XRP0142, XRP0144, XRP0147, XRP0148, XRP0149, XRP0150, XRP0153, XRP0154, XRP0155, XRP0156, XRP0157, XRP0158, XRP0159, XRP0161, XRP0162, XRP0163, XRP0164, XRP0165, XRP0167, XRP0168, XRP0169, XRP0170, XRP0171, XRP0172, XRP0173, XRP0174, XRP0175, XRP0176, XRP0177, XRP0178, XRP0179, XRP0180, XRP0181, XRP0182, XRP0184, XRP0185, XRP0186, XRP0188, XRP0189, XRP0190, XRP0191, XRP0192, XRP0193, XRP0194, XRP0195, XRP0197, XRP0198, XRP0199, XRP0200, XRP0201, XRP0202, XRP0203, XRP0204, XRP0206, XRP0207, XRP0208, XRP0209, XRP0210, XRP0212, XRP0213
Error (E)	XR0024, XR0025, XR0034, XR0035, XR0040, XR0041, XR0049, XR0059, XR0060, XR0061, XR0062, XR0063, XR0071, XR0072, XR0078, XR0087, XR0088, XR0089, XR0090, XR0095, XR0096, XR0097, XR0098, XR0099, XR0101, XR0102, XR0103, XR0104, XR8025, XRR0031, XRR0039, XRR0040, XRR0088, XRR0096, XRR0097, XRR8040, XRA0031, XRA0036, XRA0039, XRA0040, XRA0061, XRA0068, XRA0069, XRA8040, XRP0101, XRP0102, XRC0000, XRC0008, XRC0009