EMS Manual

Compiled Filters
EMS Manual—426909-005
5-42
Functions
MATCH Function
The MATCH function determines whether the value of a specified token matches the
pattern specified by a template. MATCH returns TRUE if the value of the token (or
field) matches the template. MATCH comparisons are case insensitive as are string
comparisons. For more information, see Comparing Strings on page 5-22.
token-specifier
is the name of any token or field whose value type is string or file name.
template
is a quoted string that contains the characters—and wild-cards asterisk and
question mark—to compare with token-specifier. A question mark (?)
matches any single character in token-specifier. An asterisk (*) matches zero
or more consecutive characters in token-specifier.
Considerations

The length of the token specifier should always be fewer than 512.

If token-specifier is a file name, template matches the external form of the
file name, as shown in the example. You can use either network or local file
names.

There is no way of representing an asterisk or question mark literally within a
template. They are exclusively wild cards.
Example
If the event message contains a ZFIL^TKN^FILENAME token and the token value is a
file name of a file on $SYSTEM.SYSTEM, the following PASS statement is executed:
IF MATCH (ZFIL^TKN^FILENAME, "$SYSTEM.SYSTEM.*") THEN PASS;
SSID Function
The SSID function returns the first two parts (organization and subsystem number) of a
subsystem ID. The return value is the internal form of an SSID that has been truncated
to exclude the version.
Use this function to ignore the version when comparing subsystem IDs.
The syntax for the SSID function is:
MATCH ( token-specifier , template )
SSID ( subsystem-id )