ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzatl_5.4.0.1/rzatlindications.htm

89 lines
5.3 KiB
HTML

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html lang="en-us" xml:lang="en-us">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="copyright" content="(C) Copyright IBM Corporation 2005" />
<meta name="DC.rights.owner" content="(C) Copyright IBM Corporation 2005" />
<meta name="security" content="public" />
<meta name="Robots" content="index,follow" />
<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
<meta name="DC.Type" content="concept" />
<meta name="DC.Title" content="i5/OS support for the CIM indication provider" />
<meta name="abstract" content="You can use the CIM metric indication provider to notify applications when a specific metric event occurs." />
<meta name="description" content="You can use the CIM metric indication provider to notify applications when a specific metric event occurs." />
<meta name="DC.Relation" scheme="URI" content="rzatldev.htm" />
<meta name="DC.Relation" scheme="URI" content="http://cvs.rdg.opengroup.org/pegasus-doc/CIMIndicationProvider.html" />
<meta name="DC.Format" content="XHTML" />
<meta name="DC.Identifier" content="rzatlindications" />
<meta name="DC.Language" content="en-us" />
<!-- All rights reserved. Licensed Materials Property of IBM -->
<!-- US Government Users Restricted Rights -->
<!-- Use, duplication or disclosure restricted by -->
<!-- GSA ADP Schedule Contract with IBM Corp. -->
<link rel="stylesheet" type="text/css" href="./ibmdita.css" />
<link rel="stylesheet" type="text/css" href="./ic.css" />
<title>i5/OS support
for the CIM indication provider</title>
</head>
<body id="rzatlindications"><a name="rzatlindications"><!-- --></a>
<img src="./delta.gif" alt="Start of change" /><!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">i5/OS™ support
for the CIM indication provider</h1>
<div><p>You can use the CIM metric indication provider to notify applications
when a specific metric event occurs.</p>
<p>The CIM indication provider notifies user applications when specified metric
data occurs on the server which the provider supervises. Each application
must subscribe to the provider by providing, in query form, information about
an event about which it wants data. An <dfn class="term">event</dfn> is an occurrence
of a phenomenon of interest. Examples of events are occurrences such as authentication
failures, disk-write errors, or even mouse click. The provider then notifies
the application when the event occurs. Such an occurrence is called an <dfn class="term">Indication</dfn>.
When metrics match client-submitted queries, the indication provider creates
the indication and returns it to the client.</p>
<div class="important"><span class="importanttitle">Important:</span> The metric indication provider only accepts queries
which filter on either the InstanceId or the MetricDefinitionId properties.
The provider rejects empty filters or a filter which provides only properties
other than these two.</div>
<p>The QYCP_ColSrvMetricIndicationProvider C++ class is the main class involved
in handling indications for metrics. The indication provider defines the following
methods:</p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="border" border="1" rules="all"><thead align="left"><tr valign="bottom"><th valign="bottom" id="d0e29">CIM provider types and operations</th>
<th valign="bottom" id="d0e31">Description</th>
</tr>
</thead>
<tbody><tr><td valign="top" headers="d0e29 ">enableIndications</td>
<td valign="top" headers="d0e31 ">Called when the provider is expected to begin generating
indications.</td>
</tr>
<tr><td valign="top" headers="d0e29 ">createSubscription</td>
<td valign="top" headers="d0e31 ">Tells the provider to monitor for indications matching
the specified subscription.</td>
</tr>
<tr><td valign="top" headers="d0e29 ">modifySubscription</td>
<td valign="top" headers="d0e31 ">Informs the provider that the specified subscription
instance has changed.</td>
</tr>
<tr><td valign="top" headers="d0e29 ">deleteSubscription</td>
<td valign="top" headers="d0e31 ">Informs the provider to stop monitoring for indications
matching the specified subscription.</td>
</tr>
<tr><td valign="top" headers="d0e29 ">disableIndications</td>
<td valign="top" headers="d0e31 ">Tells the provider not to generate any more indications.</td>
</tr>
</tbody>
</table>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzatldev.htm" title="The CIM standard provides the ability to develop management application that work with the systems management data exposed by the CIM providers included with i5/OS.">Pegasus developer's reference</a></div>
</div>
<div class="relinfo"><strong>Related information</strong><br />
<div><a href="http://cvs.rdg.opengroup.org/pegasus-doc/CIMIndicationProvider.html" target="_blank">Open Group CIMIndicationProvider documentation</a></div>
</div>
</div>
<img src="./deltaend.gif" alt="End of change" /></body>
</html>