Chapter 8: Discovery Formulas
Discovery Formula Structure
A discovery formula typically has three sections:
•
Instance variable declaration. Instance variables represent the input values for a formula. The following
line is an example of an instance variable declaration:
Dim I1 AS Integer Default * NAME RTTMonIndex;
•
Temporary variable definition. Temporary variables hold the result of an SNMP query. These variables
can then be used as parameters in subsequent queries. The following line is an example of a temporary
variable definition:
V01=OIDINST(rttMonCtrlAdminStatus.%I1==1, once);
•
Results line. The last line in the formula returns the formula result. The results line includes a sub-element
instance string and a set of sub-element properties.
See the
Netcool/Proviso SNMP Formula Language Guide
formulas.
The Results Line
The discovery formula results line has four fields. Fields are delimited by a double-bar (||):
•
Field 1 specifies the sub-element instance string transmitted to each collection formula when the specified
sub-element is deployed for collection. The instance string for a given sub-element appears in the instance
field (
Sub-Element
•
Field 2 specifies the custom label of a sub-element. The custom label for a given sub-element appears in the
label field (
Sub-Element
The custom label may also display in reports that show statistics for a sub-element. The custom label typically
displays under some Name, Device Name, or some similar column.
•
Field 3 defines the property list (as name/value pairs). The property list for a given sub-element appears in
the Property and Value columns (
•
Field 4 is an optional field that, if specified, contains the invariant of the sub-element. The invariant is used
during the synchronization process to detect a change of element properties, including the instance string
(the first field).
Note:
The results line must appear as a single line in the formula.
426
for detailed information about the syntax used to write discovery
view) of the Netcool/Proviso DataMart Resource Editor.
view) of the Netcool/Proviso DataMart Resource Editor.
Sub-Element
Netcool/Proviso Cisco IP Telephony Technology Pack User's Guide, Version 4.3-W
view) of the Netcool/Proviso DataMart Resource Editor.