opcmon

The command opcmon forwards the current value of the monitored object to the monitoring agent of HP Operations Manager running on a local managed node.
The monitoring agent checks this value against the configured threshold. According to the monitor configuration, the event is locally logged, suppressed, or forwarded to the message agent running on the local system if the threshold is exceeded. The message agent forwards the message to the HP Operations management server, where the message can be reviewed in the HP Operations message browser by the responsible HP Operations operators.
If a local automatic command is set up to occur when the threshold is exceeded, this command is immediately started by the local HP Operations agent. The monitoring agent must be configured and operating on the managed node, otherwise the opcmon command will fail.

Command synopsis

opcmon [ -help ] <object_name>[-<shortname>]=<value> [ -object <msg_object> ] [ -option <variable>=<var_value> ]*

Options

• -help Print usage message of opcmon. All other parameters are ignored.
• <object_name>[-<shortname>]=<value> Object name is the name of the measurement threshold policy. When the measurement threshold policy has been configured for multiple instance data, the short name is used to uniquely identify each instance within the policy.
• -object <msg_object> Value of the object text box which is part of an HP Operations message. Setting the object with the opcmon can be used for the object monitoring.
• -option <variable>=<var_value> Sets the variable $OPTION(<variable>) to <var_value>. Within the message conditions this variable can be used to access the value passed with the opcmon call. Special characters must be escaped with a backslash "\".

Exit Values

This command exits with value zero (0) after successful execution. If something is wrong regarding the passed parameters, opcmon exits with value 2 and explain the problem on standard error. For other errors, the exit value is set to 1 and an appropriate error message is returned on standard error.

Restrictions

None.

Examples

opcmon cpu_load=78.4

opcmon DB_STATUS=1

opcmon disk_util=91.1 -object /tmp -option device=/dev/dsk/c0t6d0
-option addl_auto_actn="bdf /"

Related Topics:

• opcagt
  
• AutomationWrapper: opcmsg