SNAX Connection Manager (SNAX/CM) Manual

EMSCOLLECTOR Command
SNAX/CM Commands
3–12 097842 Tandem Computers Incorporated
EMSCOLLECTOR
Command
Initially, EMS event generation for SNAX/CM is in a stopped state. Use the
SNAX/CM EMSCOLLECTOR command to start event generation and to specify the
EMS collector for EMS events. After the EMSCOLLECTOR command is successfully
issued, SNAX/CM issues events to the specified collector.
Events are issued for connections, disconnections, and command failures controlled by
the connection management process. See the SNAX/XF Management Programming
Manual for a complete description of SNAX/CM event messages.
The syntax of the EMSCOLLECTOR command is as follows:
EMS[COLLECTOR] [ collector-name ]
return : (OUTFILE)
{ EMS LOG TO collector-name | EMS LOG STOPPED
| ERROR MESSAGES }
return : ($RECEIVE)
STRUCT Reply^Receive;
INT Return^Code;
collector-name
if present, specifies the collector to which events are issued. This name must be an
EMS primary or alternate collector. If no collector name is specified, event
generation is stopped.
return : (OUTFILE)
if received from the IN file, SNAX/CM specifies the text message to be returned to
the OUT file. See Appendix B for detailed descriptions of error messages.
return : ($RECEIVE)
if received from the $RECEIVE file, SNAX/CM returns a structured buffer that
includes any return codes and file-system error messages. See Appendix B for
detailed descriptions of return codes and error messages.
Using the EMSCOLLECTOR Command
The first example shows how to use the EMSCOLLECTOR command to start logging
event messages to a primary collector:
-> EMSCOLLECTOR $0
The second example shows how to use the EMSCOLLECTOR command to stop
logging all SNAX/CM event messages:
-> EMSCOLLECTOR