EMS Manual

Reporting Events
EMS Manual—426909-005
8-9
What You Must Provide
component instead of the ATM itself). Sometimes the process producing the event
message does not have the same view of the environment as the process that
supports the programmatic command-response interface for that subsystem (or the
subsystem might not support a command-response interface).

For action events, identify the resource that requires attention as the subject of the
event message. The identified resource should be the same for the action-attention
and action-completion messages and should be the only subject in each message.
Emphasis Token
The emphasis token (ZEMS-TKN-EMPHASIS) indicates how serious you consider the
event you are reporting. A value of TRUE indicates that the message is reporting a
critical event, as described in Critical Events
on page 8-3. A value of FALSE (the
default value) indicates that the event is not critical.
Manager Token
Include a manager token (ZSPI-TKN-MANAGER, of type file name) if the subject token
might not uniquely identify the subject or if, for any other reason, the application
retrieving the message needs more information before it can determine how to access
the appropriate object through its command-message interface.
For example, if a subsystem uses file names to identify its event-message subjects,
the subject names are unique within the system, and a manager token is not needed to
resolve ambiguities. However, Pathway uses subject names that must be interpreted in
the context of the particular Pathway subsystem that created the event message, so
Pathway uses the manager token to report the process name of the PATHMON
process controlling the subject.
In general, the manager token should contain the name of the process to which a
command message for that subsystem would be routed. This process might or might
not be the process that an application issuing a command message would actually
open. For example, for Pathway, the PATHMON process is both the process named in
the manager token and the process the application would open. But for EXPAND, the
application opens SCP (Subsystem Control Process), which then routes the command
to the manager process named in the manager token. This concept of the manager
token is compatible with the concept of the manager token in DNS. For more
information, see the Distributed Name Service (DNS) Management Operations
Manual.
Action Tokens
An action event requires two event messages: an action-attention message and an
action-completion message. Each message contains a token called ZEMS-TKN-
ACTION-NEEDED, which serves two purposes:

It indicates that the message is an action event.