COSELECT Rule

The COSELECT rule is triggered by other Control-O/COSMOS rules to search for Object database rows on which to perform a specified action. The names of a Filter rule and an Action rule are supplied as parameters to the COSELECT rule.

The COSELECT rule performs the following actions:

1. The COSELECT rule applies the specified Filter rule to each row of the specified Object databases.

   If the current row is selected by the Filter rule, the specified Action rule is triggered to perform an action on the current row.

2. The COSELECT rule increments the row number (%%$DBROW) and applies the Filter rule to the next row of the Object database.

Filter rules and Action rules are described later in this chapter.

The DO RULE statement that triggers the COSELECT rule supplies the following parameters:

where

• database is the name of the Working Object database to scan. Valid values:
  • dbname – The name of the database to scan.
  • ALL – Scan all databases.
• filter is the name of the Filter rule applied to each database row scanned by the COSELECT rule.
• action is the name of the Action rule to apply to database rows chosen by the Filter rule.

Example

Assume that the following statement is used to trigger the COSELECT rule:

Rule FILTER01:

IF       %%CURRENT NE %%DESIRED

DO SET      = %%COS_SELECTED = YES

ENDIF

Rule ACTION01:

DO SHOUT    = TO OPER              URGENCY R SYSTEM

   MESSAGE CONTROL-O/COSMOS - %%CPU/%%OBJECT/%%CURRENT/%%DESIRED/%%MODE/%%TEXT

A Shout message is issued for each row of DATABASE1 in which the CURRENT column and the DESIRED column do not match.