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

AOF LISTINST—List Enabled Rule Statistics

This 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.

The LISTINST command sets the RC variable to zero. Unless the NOOUTPUT keyword is implicitly specified, the external data queue contains messages providing rule or rule set statistics. If a parameter error occurs, the RC variable is set to 12. A return code of 12 is accompanied by descriptive messages.

This command has the following format:

ADDRESS AOF "LISTINST keywords"
  [ruleset|ruleset.*|ruleset.rule]
  [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.

Use the RULETYPE keyword to specify the type of rules about which you are requesting statistics. The value of type can be any of the following: 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.

Examples: LISTINST command

• 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)"
  

More information:

ADDRESS AOF Command Format