EMS Manual

Compiled Filters
EMS Manual—426909-005
5-37
Statements
The filter PASS statement has been enhanced to allow an optional list of routing IDs, in
addition to the value that can currently be returned. A routing distributor also returns
the PASS value itself to the destination if the event is unformatted, which was
previously done for consumer distributors only. In the case of multiple filters, each filter
can send a different PASS value to its destinations.
The syntax of the PASS statement:
n
is any signed integer constant whose value is expressible as a 16-bit signed
integer. Include this value to indicate to your application which PASS statement
returned a particular event message. The pass value allows you to categorize
event messages to prevent redundant computations in your application.
m, m1...mN
are routing IDs as defined in the DESTINATION statements.
The PASS statement causes a consumer distributor to return the following tokens in its
response message to a GETEVENT command message sent by an application:

ZEMS^TKN^EVENT is a type bytestring token that contains the entire event
message that the PASS statement selected. The distributor always returns this
token when a PASS statement is executed.

ZEMS^TKN^PASSVAL is a type int token. The distributor returns this token only if
an integer-value follows the PASS keyword.
Examples
This filter fragment shows a PASS statement that returns values 1 or -1, depending on
the Boolean variable qflag:
.
.
.
IF qflag THEN
PASS 1
ELSE
PASS -1;
END; -- End of filter specification
Note. Routing distributor is the term used in this section to describe a printing distributor with a
filter that contains destination profiles.
PASS [ n ] [ m ] | PASS [ n ] ( m1, m2, ... mN )