Using the MATCH command

The MATCH command has the following syntax:

Figure 1. Syntax

Note: Either commas or blank characters are permitted as delimiters.

In the above syntax diagram, column_name can be any one of the column names shown in Available columns, for example, Abend or IMS_Pgm. The column name and the specified value are not case sensitive.

MATCH ALL (which is the same as PF12) removes all match conditions including the limit, so that the display shows the same entries as it had when you first displayed the history file. This option is not the same as doing a REFRESH, which looks at the history file, and so can display new entries that have been written to the history file since you first started Fault Analyzer. When you refresh, you also remove all match conditions.

MATCH CSR is the cursor match. To make this work you have to move the cursor under a value and press Enter, which is essentially the same as placing the cursor and pressing PF4 (see Cursor-selecting a matching value).

The other keywords correspond to a field, and you follow the field name with a value. Optionally, you can specify an operator between the field name and the value. The default operator is =. When matching, values are not case-sensitive.

If a value contains blanks, commas or double quotes ("), then enclose it within double quotes. Any double quotes within the quoted string need to be doubled up. For example, if a displayed user title is:

A "B",C

then specify the match command as:

MATCH USER_TITLE "A ""B"",C"

An * can be used as a wildcard. When you append it to a value, Fault Analyzer matches all values starting with the value you entered before the *. Since all values are strings, you could, for example, enter

MATCH DATE 2019/07*

which would display all entries for the month of July, for 2019.

Another supported wildcard character is a percent sign (%), which can be used to indicate a single required character.

Specify the match values for any column in the same format as the data displayed in that column. For example, if a date column contains dates in the format year/month/day, then the match value must likewise be in the format year/month/day.

See Sorting and matching fault entries for more information about data types and valid values. The rules that apply to the match criteria on the Column Attributes display also apply to the MATCH command.

Example:

If a Date & Time column contains dates in the format month.day.year and time in the format hours:minutes:seconds, the following examples are valid match values:


1.13.2020
06.5.2020 0:0:0
TODAY
TODAY-365

Use the TODAY keyword in the Date column or the Date & Time column to specify either the current date (TODAY) or a range of dates relative to the current date (TODAY-days). For example:


TODAY
TODAY-10

When you specify TODAY-days, no blanks or other delimiters can precede or follow the minus sign.

You do not have to be able to see a value to enter it as part of a MATCH command. That is, you can MATCH on column values that are in the visible area of the screen, as well as column values that are outside of the current scroll window. However, you can only MATCH on columns that are currently selected for display. A match on a column that is not selected for display is ignored.

If you apply a match value, and no entries satisfy this value, then Fault Analyzer displays the message No matches, and shows a display with no entries.