NetBatch Management Programming Manual

SPI Programming Considerations for the NetBatch
Subsystem
NetBatch Management Programming Manual—522462-003
3-14
Critical Events
SUBJECT) to get the token code and index of the token identifying the subject.
Then make another call to retrieve the subject token itself.
g. Call procedure EMSGET or EMSGETTKN to retrieve the values of other
tokens from the event message.
h. Take action appropriate to the information in the event message.
For information on retrieving tokens from an event message, see the EMS Manual.
Critical Events
Critical events can have serious consequences, such as scheduler failure. The value of
event-message token ZEMS-TKN-EMPHASIS determines whether an event is critical.
If the value is ZSPI-VAL-TRUE, the event is critical. If the value is ZSPI-VAL-FALSE,
the event is noncritical.
For a list of critical and noncritical NetBatch event messages, see Section 6, Event
Messages.
Filters
EMS provides you with the ability to create filters, which let applications select
particular event messages from among those reported. Filters select messages to
return to an application by examining the values of tokens in the messages. For
example, to select only NetBatch event messages, a filter would examine the token
that contains the subsystem ID of the issuing subsystem and then let only messages
containing the NetBatch subsystem ID pass to the application that requested them.
You can create filter source files and compile them into filter object files by using EMF,
the EMS filter language. You can load the resulting filters into consumer, printing, or
forwarding distributors by using the EMS program EMSDIST. Also, you can replace
filters online.
You can use any of the tokens contained in event messages to select which event
messages will be returned to your application. You can create filters that return only
critical event messages, all messages with a certain event number, and so on.
For general information on coding, compiling, loading, and replacing filters, see the
EMS Manual. For information specific to NetBatch subsystem filters, see Section 6,
Event Messages.