AOF LISTINST—List Enabled Rule Statistics

Host Environment Commands › ADDRESS AOF Commands › AOF LISTINST—List Enabled Rule Statistics

AOF LISTINST—List Enabled Rule Statistics

The LISTINST command fetches statistics about enabled rules and rule sets, regardless of whether the rules are resident on DASD. Unlike the LIST command, the LISTINST command returns information about dynamic rules.

This command sets the RC variable to zero. Unless the NOOUTPUT keyword is implicitly specified, the external data queue contains messages that provide rule or rule set statistics. If a parameter error occurs, the RC variable is set to 12. A return code of 12 includes descriptive messages.

AOF LISTINST has the following format:

ADDRESS AOF "LISTINST keywords"

[ruleset|ruleset.*|ruleset.rule|*dynamic\*dynamic.*\*dynamic.newrule]
[RULETYPE(type)]
[SYSTEM(sysname)]
[SYSWAIT(seconds)]

Note: If the SYSTEM keyword is used for this command, it may contain only one system name. EXT and ALL refer to all external systems (more than one) and are therefore not allowed.

Note: To specify the type of rules for which you are requesting statistics, use the RULETYPE keyword. The type can have any of the following values: ARM, CMD, DOM, EOJ, EOM, EOS, GLV, MSG, OMG, REQ, SCR, SEC, TLM, TOD, or USS. Specifying a value for the RULETYPE keyword is optional; if you let it default, the LISTINST command returns statistics for enabled rules of all types.

More information:

ADDRESS AOF Command Format

ADDRESS AOF Return Codes

AOF LISTINST Sample Coding Statements

The following examples show sample coding statements for AOF LISTINST:

To list all rule sets that contain enabled rules, issue this command:
```
ADDRESS AOF
```
```
"LISTINST"
```
To list all rule sets on system MVS1 that contain enabled rules, issue this command:
```
ADDRESS AOF
```
```
"LISTINST SYSTEM(MVS1)"
```
To list the rule sets on system MV2 that contain enabled message rules, issue this command:
```
ADDRESS AOF
```
```
"LISTINST RULETYPE(MSG) SYSTEM(MV2)"
```
To list all enabled command rules in a rule set, issue this command:
```
ADDRESS AOF
```
```
"LISTINST ruleset.* RULETYPE(CMD)"
```
To list all enabled dynamic rules, issue this command:
```
ADDRESS AOF
```
```
"LISTINST *dynamic.*"
```