Building and Controlling AOF Rules › Control AOF Rule Status › Create and Control Rules Programmatically

Create and Control Rules Programmatically

You can programmatically control AOF rules using the OPS/REXX ADDRESS AOF host environment.

While AOF rules are mainly controlled manually using OPSVIEW option 4.5, the ADDRESS AOF OPS/REXX host environment provides you with the flexibility of controlling your rules in an automated application. This feature is commonly used as a tool in the form of a pseudo-AOF command rule that can be invoked from anywhere a z/OS command can be entered, which eliminates the need to use the OPSVIEW 4.5 option.

In addition to programmatically controlling rules, the ADDRESS AOF OPS/REXX host environment gives you a way to dynamically create AOF rules. The ADDRESS AOF host environment lets you build an AOF rule in other AOF rules or OPS/REXX programs. This type of logic is mainly used to trigger automation for events that can occur at any time.

To programmatically create and control rules

• Suppose your suppression rules are in a rule set called OPSMVS.PROD.SUPPRESS.RULES and you wanted to create a quick way to disable all suppression rules. You can create the following rule:

  )CMD SUPPOFF
  )PROC
  /* Emergency pseudo command rule to disable all suppression */
  /* Enter the command SUPPOFF from any system console to     */
  /* trigger this rule.                                       */
  /* Send DISABLE command to AOF for SUPPRESS ruleset         */
  ADDRESS AOF
  "DISABLE SUPPRESS"
  

• Suppose you want to invoke an OPS/REXX program that performs various checks against VTAM-related nodes and to trigger this program 10 minutes after VTAM initializes. You can code the following:

  )MSG IST020I
   )PROC
   /* This message indicates that VTAM has initialized. We want      */
   /* to schedule our VTAM check EXEC 10 minutes from now. Since     */
   /* we never know in advance the exact time that VTAM will         */
   /* initialize, we create a dynamic AOF TOD rule to wake up 10     */
   /* minutes from the time this message was issued.                 */
   queue ")TOD *+10 MINS"
   queue ")PROC"
   queue "ADDRESS OSF"
   queue "'OI PROGRAM(VTAMCHCK)'"
   address AOF
   "ENABLE *DYNAMIC.VTAMCHCK"
  

For more information on using the ADDRESS AOF OPS/REXX host environment to programmatically control and create AOF rules, see the Command and Function Reference.