These commands are available on the NETWORK-MANAGEMENT domain and require NET-ADMINISTRATION permission.
Usage:
START-SNMP-AGENT AGENT-NAME=*ALL STOP-SNMP-AGENT AGENT-NAME=*ALL RESTART-SNMP-AGENT AGENT-NAME=*ALL SHOW-SNMP-AGENT-STATUS AGENT-NAME=*ALL
AGENT-NAME accepts values: *ALL, APPMON, CONSOLE, OPENFT, OPENSM2, SPOOL, STORAGE, HOST, HSMS, OPENUTM, BCAM, SESAM or FTP. If given command is run with parameter *ALL – the command will be performed for all agents.
Each command in addition can return errors from NET0006 to NET0008 or NET0001 (descriptions are listed in previous chapter).
Possible outputs:
[agentName] mentioned in command/procedure output will be a name of currently processed subagent's file name: appMonAgent, consoleAgent, openFTAgent, openSM2Agent, spoolAgent, storageAgent, hostAgent, hsmsAgent, openUTMAgent, bcamAgent, sesAgent, ftpAgent
- START-SNMP-AGENT
If snmpd has not been started by the RC script or by the START-NET-SNMP command:
snmpd is not running: START-NET-SNMP
If [agentName] is not running and START-SNMP-AGENT is executed a message will be displayed (also displayed on the operator console):
[agentName] is started log file is on POSIX file system: /var/adm/[agentName].log
If [agentName] is running and START-SNMP-AGENT is executed a message will be displayed:
[agentName] is already started
- STOP-SNMP-AGENT
If [agentName] is running and STOP-SNMP-AGENT is executed a message will be displayed (also displayed on the operator console):
[agentName] successfully terminated
If [agentName] is not running and STOP-SNMP-AGENT is executed a message will be displayed:
[agentName] is not running
If STOP command will not be executed with success
unable to stop [agentName]
- RESTART-SNMP-AGENT
If [agentName] is not running and RESTART-SNMP-AGENT is executed a message will be displayed:
[agentName] is not running
If [agentName] is running and RESTART-SNMP-AGENT is executed a message will be displayed (also displayed on the operator console):
[agentName] is restarted log file is on POSIX file system:/var/adm/[agentName].log
- SHOW-SNMP-AGENT-STATUS
If [agentName] is not running and SHOW-SNMP-AGENT-STATUS is executed a message will be displayed:
[agentName] is not running
If [agentName] is running and SHOW-SNMP-AGENT-STATUS is executed a message will be displayed:
[agentName] is running log file is on POSIX file system: :/var/adm/[agentName].log
If application crashed or was kill -9 or cancelled:
[agentName] is dead
If application is running on posix but has not been run by RC scripts or START-SNMP-AGENT command:
[agentName] is running but it has not been started by START-SNMP-AGENT log file is on POSIX file system: /var/adm/[agentName].log
Behaviour of commands for AGENT-NAME=*ALL regarding return codes:
If a particular command is executed with parameter *ALL and at least one agent returns error different than CMD0001, the return code will be set up to the code returned by this agent. Code NET0001 is common for all agents so will be return by all agents or not return at all.
For example, if for RESTART-SNMP-AGENT one of agent return NET0005 the return code will be NET0005 even if rest of agents return CMD0001.
/RESTART-NET-SNMP-AGENT AGENT-NAME=*ALL appMonAgent is restarted log file is on POSIX file system: /var/adm/appMonAgent.log NET0005 consoleAgent is not started openFTAgent is restarted log file is on POSIX file system: /var/adm/openFTAgent.log openSM2Agent is restarted log file is on POSIX file system: /var/adm/openSM2Agent.log spoolAgent is restarted log file is on POSIX file system: /var/adm/spoolAgent.log storageAgent is restarted log file is on POSIX file system: /var/adm/storageAgent.log hostAgent is restarted log file is on POSIX file system: /var/adm/hostAgent.log NET0005 hsmsAgent is not running openUTMAgent is restarted log file is on POSIX file system: /var/adm/openUTMAgent.log bcamAgent is restarted log file is on POSIX file system: /var/adm/bcamAgent.log sesAgent is restarted log file is on POSIX file system: /var/adm/sesAgent.log ftpAgent is restarted log file is on POSIX file system: /var/adm/ftpAgent.log /show-ret %Returncode: %Subcode2 = 0 %Subcode1 = 64 %Maincode = NET0005