EMS Manual
Compiled Filters
EMS Manual—426909-005
5-43
Functions
subsystem-id
is a subsystem ID, expressed as a name or as a constant.
Consideration
Subsystem IDs are treated in comparisons as the EMF (EMS filter) unsigned values,
and unsigned values of unequal length are compared for the length of the shorter
value. Therefore, to compare a subsystem ID with the SSID function of another
subsystem ID ignores the version in the comparison.
Example
This example shows the use of an SSID function in a comparison:
[#SET ZTMF^VAL^SSID
[ZSPI^VAL^TANDEM].[ZSPI^SSN^ZTMF].[ZTMF^VAL^VERSION] ]
FILTER tmf_test;
BEGIN
IF ZSPI^TKN^SSID = SSID ( ZTMF^VAL^SSID ) THEN
BEGIN
.
.
.
END;
END;
Statements within the compound statement in the previous example are executed only
if TMF generated the event message, regardless of the version of the programmatic
interface.
TOKENPRESENT Function
The TOKENPRESENT function determines whether a specified token is currently
present and returns TRUE or FALSE.
argument
is the name of a token or field.
Considerations
As usual, if the token name is declared as a filter parameter, TOKENPRESENT
looks for the token among the set of parameter tokens. Otherwise,
TOKENPRESENT looks for the token in the event message.
You can use TOKENPRESENT to determine whether an OPTIONAL parameter
was actually passed.
TOKENPRESENT ( argument )