OSI/FTAM Configuration and Management Manual

FTAM Management Environment
OSI/FTAM Configuration and Management Manual—421944-001
2-27
Event Messages
Event Messages
When a subsystem or system component detects an event that might affect its operation,
it generates an event message describing the event. Such event messages can be related
to hardware or software malfunctions or to important changes in the state of a system
component. Text (readable) versions of these event messages can be displayed as
operator messages.
You might, for example, see an operator message reporting one of the following
conditions:
•
An initiator or a responder process has changed states.
•
An attempt has been made to access FTAM services with insufficient security
clearance.
•
An error has occurred in creating an initiator or a responder process.
An operator message briefly describes the condition that triggered the message and
identifies he process reporting the message. For a listing of operator messages, as well as
specific cause, effect, and recovery information, see the Operator Messages Manual.
EMS Filters
EMS allows you to write filter programs that specify exactly which messages are passed
on for viewing. For example, you can write a filter that distinguishes event messages
generated by Tandem FTAM from event messages generated from the rest of the system.
Filters allow you to determine the types of messages an operator sees and does not see.
Section 5, Monitoring FTAM Performance
, discusses strategies for writing filters; and
Appendix B, FTAM EMS Filters, provides examples of two EMS filters. For more
information on writing filters for EMS, see the EMS Manual.
Displaying Current Event Messages
Assuming that EMS is installed correctly and is running successfully, and assuming that
the log files are secured so that you can access them, it is easy to run a printing
distributor. The simplest case is to run a printing distributor to your terminal by entering
a TACL command such as the following:
EMSDIST /NAME $DIST1/ TYPE PRINTING, COLLECTOR $0, &
TEXTOUT $TERM1, FILTER $SYSTEM.MYFLTR.EXFLT1
This command is an implicit RUN command, meaning that the word RUN is not
actually entered. Implicit RUN commands assume that EMSDIST is located on
$SYSTEM.SYSTEM. If your EMSDIST is located elsewhere, you must precede the
command with the word RUN.
This sample command runs a printing distributor to a terminal called $TERM1. The
source of the event messages is the collector $0 (the primary collector on your FTAM
system), and the filter is one you have written that passes only FTAM-related event
messages (messages sent by the APLMGR and FTAM subsystems). See Appendix B,
FTAM EMS Filters, for an example of such a filter.