OSI/AS Configuration and Management Manual

Routine Management Tasks
OSI/AS Configuration and Management Manual—424119-001
5-2
Displaying Current Event Messages
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 like the following:
EMSDIST /NAME $DIST1/ TYPE PRINTING, COLLECTOR $0, &
TEXTOUT $TERM1, FILTER $SYSTEM.MYFLTR.FLTR1
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 example command runs a printing distributor to a terminal called $TERM1. The
source of the event messages is the collector $0 (the collector on your local system), and
the filter is one you have written that passes only OSI-related event messages (messages
reported by OSI/AS, OSI/TS, X25AM, and TLAM on D-series releases or PAM on G06
and above releases. See Appendix B, Examples of EMS Filters
, for an example of such a
filter.
The distributor $DIST1 displays messages for all events reported from the time you start
the distributor until you stop it. Since the distributor has been assigned a name, you can
stop the process using that name. As a general rule, distributor processes should be
named.
You can use similar commands to run printing distributors to other terminals or printers
by substituting other names for $TERM1.
To stop the distributor, press the BREAK key on your terminal keyboard. Then,
assuming the distributor is the process you most recently started, use the TACL STOP
command to terminate it, or use the TACL STOP command with the distributor name to
stop it by name.
Displaying Saved Event Messages
You can run a printing distributor to display event messages saved in a previously
created log file. The TACL command is much the same as the one above, except the
LOGFILE parameter replaces the COLLECTOR parameter and a TIME parameter is
added to specify the generation time of the earliest message you want to display:
EMSDIST TYPE PRINTING, LOGFILE LOG1, TEXTOUT $TERM1, &
TIME 16 OCT 1991 7:30
This command runs a printing distributor to a terminal called $TERM1, using the
default pass-all filter to process event messages stored in the previously generated log
file called LOG1 and generated since 7:30 a.m. on October 16, 1991.
In this case, you can stop the distributor by pressing the BREAK key and using the
TACL STOP command, as before, or by letting the distributor run until it reaches the
end of the log file.