SNMP Configuration and Management Manual

SCF Commands for the SNMP Agent
SNMP Configuration and Management Manual—424777-006
5-15
ALTER PROCESS Command
ALTER PROCESS Command
Use the ALTER PROCESS command to direct the NonStop agent process to send its
event messages to a different EMS collector process.
$agent-process
identifies the NonStop agent process whose configuration is being altered. It
consists of a dollar sign ($) followed by one to five alphanumeric characters, the
first of which must be alphabetic.
EMSCOLL [\node.]$ems-collector
specifies the EMS collector process to which the NonStop agent is to send events
it generates.
$ems-collector is one to five alphanumeric characters preceded by a dollar
sign ($). The first alphanumeric character must be a letter. The process name can
optionally be qualified with a node name (backslash followed by one to seven
alphanumeric characters, the first of which must be a letter) identifying the node on
which the process is running.
Considerations: ALTER PROCESS
•
You can issue an ALTER command against a PROCESS object while the object is
in the STARTED state.
•
In the event of a takeover by the backup NonStop agent process, the backup
process also sends its events to the EMS collector identified in the current
EMSCOLL setting.
•
The value of the EMSCOLL attribute is not saved in the SNMPCTL file (in which
the NonStop agent maintains values for its current configuration). If you restart a
NonStop agent process, the NonStop agent sends its events to the default EMS
collector, $0, regardless of the EMSCOLL setting in effect when the agent was
stopped.
•
You can also specify that the NonStop agent send its events to an alternate
collector by including a COLLECTOR startup parameter when you start the
NonStop agent process. Including the COLLECTOR startup parameter with no
argument is the only way you can suppress output of NonStop agent events. You
cannot accomplish this through SCF.
For information on using the COLLECTOR startup parameter rather than the
EMSCOLL attribute, see RUN Command on page 2-7.
ALTER PROCESS $agent-process
[ , EMSCOLL [\node.]$ems-collector ]