Previous Topic: Time Data CellNext Topic: Tally Data Cell


Scan Routine Data Cell

You can use scan routines to scan sub-records in the target domain. The scan routine data cell name starts with the target domain name. The scan routine data cell counts sub-record occurrences and tallies data into tally data cells for use in a rule expression. The scan routine data cell requires a rule expression, enclosed with parentheses, following the scan routine name. This rule expression can contain data cells. These cells referenced in the rule expression must be in the target domain scanned by the scan routine.

For example, you can use the scan routine data cell PROCESS_SCAN to return tally information. If a rule is in the LOCAL domain, you can use the following rule expression to test whether the image XYZZY.EXE is being used:

PROCESS_SCAN (IMAGE_NAME .EQS. "XYZZY") .GT. 0
The PROCESS domain is the target domain for PROCESS_SCAN.

The value that a scan routine returns is an integer indicating the number of times the specified expression tested true (evaluated to 1.0). In this case, the value returned by PROCESS_SCAN would be the count of process sub-records with an image name of XYZZY. If the value is greater than 0, the rule expression is true.

These scan routine data cells are valid:

You cannot use scan routine data cells as evidence.