EMS Manual

Compiled Filters
EMS Manual—426909-005
5-39
Functions
DECOMPOSEERROR Function
This function returns the error resulting from the most recently executed DECOMPOSE
function if an error occurred. A 0 is returned if no error occurred.
Examples Using DECOMPOSE and DECOMPOSEERROR
This statement retrieves all events generated by processes on \NCN:
IF DECOMPOSE (ZEMS^TKN^PROC^DESC,SYSTEM NAME)=”\NCN”
AND DECOMPOSEERROR = 0 THEN
PASS;
This statement retrieves all events generated by any process named $null:
IF DECOMPOSE (ZEMS^TKN^PROC^DESC,DESTINATION NAME,NAME
PART)='$null'
AND DECOMPOSEERROR = 0 THEN
PASS;
EMSTEXTMATCH Function
The EMSTEXTMATCH function compares the text of an event message, as formatted
by EMSTEXT, against a specified template. EMSTEXTMATCH returns TRUE if the text
generated by EMSTEXT matches the template.
value
is the initial template to be supplied to EMSTEXT. value must be either a constant
or a parameter token whose contents conform to the header-template-key
parameter for EMSTEXT. For more information about the header-template-key
parameter, see the EMSTEXT procedure material in Section 15, EMS Procedures.
paramtkn
is a parameter token passed to the distributor, containing the template against
which the text generated by EMSTEXT is to be compared. The template can
contain optional wild-card characters. A question mark (?) matches any single
character. An asterisk (*) matches zero or more characters.
SUFFIX
Specifies inclusion of the trailing portion
PREFIX
Specifies inclusion of the leading portion
NO DEFAULTS
Specifies that =_DEFAULTS not be used
DECOMPOSEERROR
EMSTEXTMATCH ( value , paramtkn )