Host Environment Commands › ADDRESS AOF Commands › AOF LISTSRC—List Source Code

AOF LISTSRC—List Source Code

This command lists the source code of an enabled rule. For each line of the source text of the enabled rule, one line of output is returned to the external data queue.

The LISTSRC command sets the RC variable to zero and the external data queue contains no output lines.

This command has the following format:

ADDRESS AOF "LISTSRC keywords"
  {ruleset.rule}
  [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.

Examples: LISTSRC command

• To list the source code for a rule, issue this command:

  ADDRESS AOF
    "LISTSRC ruleset.rule"
  

• To list the source code for the dynamic rule named NEWRULE, issue this command:

  ADDRESS AOF
    "LISTSRC *DYNAMIC.NEWRULE"
  

Usage Notes

Keep these things in mind when using the LISTSRC command:

• You may specify any valid rule set name for the value of ruleset, including *DYNAMIC. There is no default.
• You must specify the valid name of an enabled rule for the value of rule. You cannot specify an asterisk (*). There is no default.
• For all enabled rules to be eligible for LISTSRC processing, the AOFSOURCETEXT parameter must be set to YES. If the AOFSOURCETEXT parameter is set to NO, only dynamic rules are eligible for LISTSRC processing.
• When the value of the AOFSOURCETEXT parameter is NO and you issue the LISTSRC command, CA OPS/MVS returns the following information to the external data queue:
  • Return code 20
  • Message OPS3811I, indicating that CA OPS/MVS could not find the source text of the rule.

More information:

ADDRESS AOF Command Format