File: //opt/OV/www/htdocs/ito_man/opcmon.1.html
<!-- manual page source format generated by PolyglotMan v3.2, -->
<!-- available at http://polyglotman.sourceforge.net/ -->
<html>
<head>
<title>Title</title>
</head>
<body bgcolor='white'>
<a href='#toc'>Table of Contents</a><p>
<h2><a name='sect0' href='#toc0'>Name</a></h2>
<p>
opcmon - forward monitored object value to HP Operations Manager (HPOM)
<p>
<h2><a name='sect1' href='#toc1'><b>Synopsis</b></a></h2>
<p>
<b>opcmon</b> [ -help ] <i><monitored</i><b>_</b><i>object></i>=<i><value></i> [ -object <i><msg</i><b>_</b><i>object></i> ]
[ -option <i><variable></i>=<i><var</i><b>_</b><i>value></i> ]*
<p>
<h2><a name='sect2' href='#toc2'><b>Description</b></a></h2>
<p>
The command <i>opcmon</i> forwards the current value of the monitored object
to the Monitoring Agent of the HP Operations agent running on local
Managed Node.<br>
The Monitoring Agent checks this value against the configured thresh‐
old. 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 has been exceeded. The Message Agent
forwards the message to the HPOM Management Server where the message
can be reviewed on the HPOM Message Browser window by the responsible
HPOM operator(s).<br>
The Monitoring Agent checks the values received from monitored objects
once in every two seconds. When the opcmon command forwards multiple
values to the Monitoring Agent between two successive checks, the Moni‐
toring Agent accepts only the last message for further processing.
If a local automatic action has been set up for threshold exceeding,
this action will immediately be started by the local Action Agent.
The Monitoring Agent must be configured and running on the Managed
Node, otherwise the <i>opcmon</i> command will fail.
<p><p>
<b>Options</b><br>
<dl>
<dt>-help </dt></dt>
<dd> Print usage message of <i>opcmon</i>. All other
parameters are ignored.
<p></dd>
<dt><i><monitored</i><b>_</b><i>object></i>=<i><value></i> </dt></dt>
<dd> Name of the monitored object as config‐
ured in the HPOM user interface in the
<i>Add/Modify</i> <i>Threshold</i> <i>Monitor</i> window.
The current value can either be an inte‐
ger or real expression.
<p></dd>
<dt>-object <i><msg</i><b>_</b><i>object></i> </dt></dt>
<dd> Value of the object field which is part
of an HPOM message. Setting the object
with <i>opcmon</i> can be used for the object
monitoring.
<p></dd>
<dt>-option <i><variable></i>=<i><var</i><b>_</b><i>value></i></dt></dt>
<dd>
Sets the variable $OPTION(<i><variable></i>) to
<i><var</i><b>_</b><i>value></i>. Within the message condi‐
tions this variable can be used to access
the value passed with the <i>opcmon</i> call.
Special shell characters have to be
escaped.
<p></dd>
</dl>
<h2><a name='sect3' href='#toc3'><b>Exit</b> <b>Values</b></a></h2>
<p>
This command will exit with value zero after successful execution. If
something is wrong regarding the passed parameters, <i>opcmon</i> will exit
with value 2 and explain the problem on standard error. For other
errors, the exit value will be set to 1 and an appropriate error mes‐
sage will be returned on standard error.
<p>
<h2><a name='sect4' href='#toc4'><b>Restrictions</b></a></h2>
<p>
None.
<p>
<h2><a name='sect5' href='#toc5'><b>Examples</b></a></h2>
<p>
<i>opcmon</i> <i>cpu</i><b>_</b><i>load=78.4</i>
<p><p>
<i>opcmon</i> <i>DB</i><b>_</b><i>STATUS=1</i>
<p><p>
<i>opcmon</i> <i>disk</i><b>_</b><i>util=91.1</i> <i>-object</i> <i>/tmp</i> <i>-option</i> <i>device=/dev/dsk/c0t6d0</i>
<i>-option</i> <i>addl</i><b>_</b><i>auto</i><b>_</b><i>actn="bdf</i> <i>/"</i>
<p>
<h2><a name='sect6' href='#toc6'><b>See</b> <b>Also</b></a></h2>
<p>
<a href='opcagt.1m.html'>opcagt(1m)</a>
,<br>
<a href='opcmon.3.html'>opcmon(3)</a>
,<br>
<a href='opcmon_send.3.html'>opcmon_send(3)</a>
,<br>
<a href='opc.5.html'>opc(5)</a>
.
<p>
<h2><a name='sect7' href='#toc7'><b>Copyright</b></a></h2>
<p>
(c) Copyright 2001-2010 Hewlett-Packard Development Company, L.P.
<p><p>
HP shall not be liable for technical or editorial errors or omissions
contained herein.
<p>
<hr><p>
<a name='toc'><b>Table of Contents</b></a><p>
<ul>
<li><a name='toc0' href='#sect0'>Name</a></li>
<li><a name='toc1' href='#sect1'>Synopsis</a></li>
<li><a name='toc2' href='#sect2'>Description</a></li>
<li><a name='toc3' href='#sect3'>Exit Values</a></li>
<li><a name='toc4' href='#sect4'>Restrictions</a></li>
<li><a name='toc5' href='#sect5'>Examples</a></li>
<li><a name='toc6' href='#sect6'>See Also</a></li>
<li><a name='toc7' href='#sect7'>Copyright</a></li>
</ul>
</body>
</html>