OIDINST instruction

The OIDINST expression line stores the values of a key for which the expression is true (different from zero.) The instruction is primarily used for Discovery formulas to filter a subset of indexes from a large set, based on properties. If the filter is unsuccessful, the row is skipped. If the filter is successful, the value of the index for the row is assigned to the temporary variable, and processing continues with the next line of the formula.

The syntax is:
Vn = OIDINST(<Boolean Expression> [, Validity]);
Part of Formula Purpose Syntax Requirements
Vn A temporary variable.

Must be of the form "V1", "V" must be capitalized, and must be followed by a number.

=

Indicates that the result of the expression on the right must be assigned to the temporary variable on the left.

Spaces before and after are optional.
OIDINST A keyword to indicate that a conditional filter is being used. Not case-sensitive.
Expression The expression to be filtered.

OID, stat variable, or mathematical operations with a Boolean result.

Valid operators for filtering are:

like, <, >, <=, >=, ==, !=
Part of Formula Purpose Syntax Requirements
Validity specifies how often to re-evaluate the expression
The choices include:
  • Once, evaluate the expression only at the first polling.
  • Every, evaluate the expression at each polling. This is the default.
  • P, evaluate the expression at a specified number of pollings. For example, 10P means re-evaluate the expression on each10th polling.
  • A specific period, in seconds. For example, 3600 means re-evaluate the expression once each hour.
; Indicates the end of the line.

Required for every line of the formula, including comments.