How to Begin Using the Product › Lesson 2: Test and Verify a Rule

Lesson 2: Test and Verify a Rule

This lesson shows you how to text and verify your new rule.

Follow these steps:

1. Verify that the AOF Test Rule List panel displays.

   If not, proceed with the following instructions:

   • If the AOF Edit displays, press your PF3 key (or enter END).
   • If the main OPSVIEW menu panel displays, select 2.1, and then enter your test library name in the AOF EDIT Entry panel.
   • If the AOF Edit Entry panel displays, enter your test library name.
2. Enable your rule by typing E to the left of the name of your rule and then press Enter.

   In response, two fields on the Rule List Panel change, as shown in the following example screen. This example shows how the panel looks after the changes. Notice that for the rule that is named IEF450I, the value in the Status field has changed to ENABLED and the value in the Typ field has changed to MSG. In addition, the message AOF RULE ENABLED appears in the upper-right corner of the panel.

   Note: For more information about enabling rules, see Lesson 5: How to Enable and Disable Rules and Rule Sets in this chapter.

   Note: If your rule contains syntax errors, the E command fails. If this failure happens, go back to the AOF panel and ensure that your REXX rule program is exactly like that shown in Lesson 1.

   AOF TEST - Rule List ------ USERID.TEST.RULES ---------------AOF RULE ENABLED
   COMMAND ===>                                                 SCROLL ===> PAGE
      Line Commands:     R EasyRule    S ISPF Edit     T Test    C Compile    V View
      E Enable  D Disable  A Set Auto-Enable Z Reset Auto-Enable   X Delcomp
           Test Start Date   : 2009/10/12  Test Start Time  : 13:54:00
           Test Current Date : 2009/10/12  Test Current Time: 13:54:00
     RULENAME STATUS  AE TYP VV.MM  CREATED  MODIFIED     SIZE INIT  MOD   ID
     IEF450I  ENABLED  Y MSG 01.04 09/10/12 09/10/12 18:38   7    5    3 SYSADM
   

3. Type T to the left of the name of the rule and press Enter.

   When you select a message rule for testing, the AOF takes you to the AOF Test MSG panel, which prompts you for information about the message rule you want to test. A sample panel appears in the next step. At the bottom of this panel, a portion of the OPSLOG is displayed.

4. Enter the following command in the Command field:

   D TIME DISP 
   

   This command tells CA OPS/MVS to display the following information for each rule:

   • Time that the event with which the rule is connected appeared in OPSLOG
   • Final disposition of the event as determined by the AOF

     AOF Test MSG ------------ MSI1 --- OPSVIEW --- 15:27:24  12OCT2009 COLS 001 070
     COMMAND ===>                                                   SCROLL ===> PAGE
      REXX Trace ==> N   Live Commands  ==> NO        Access Auto Test Data:   (Y/N)
      Msg Id:             Msg Disp:               Hardcopy Log:
      Jobname     ==>                            IMS Id      ==>
      Job Id      ==>                            Exit Type   ==> MVS
      MSF Sys     ==>                            Console Id  ==>
      User        ==>                            Console Nm  ==>
      Sys Id      ==>                            MCS Flags   ==>
      Special Ch  ==>                            Descriptor  ==>
      Route       ==>
      Term Name   ==>                            Report Id   ==>
      Message     ==>
     Time     ----+----1----+----2----+----3----+----4----+----5----+----6----+----7
     ******** ********************* TOP OF MESSAGES  *******************************
     15:27:24 ENABLE TESTING.IEF450I
     

5. Enter values on the AOF Test MSG panel:
   • Type any characters in the Jobname field. Although it does not matter for purposes of this lesson what characters are listed in the Jobname field, a rule test does not run unless that field has been filled. For example, you could type XXXX into the Jobname field.
   • Type the message ID and any text in the Message field. For example, you could type IEF450I SAMPLE MESSAGE into the Message field.
   • Type 0 in the Console Id field.
6. Press Enter.
   • A test message is run against the enabled rule.
   • The following sample panel shows the results of your rule test.
   • The value SUP that appears in the Dis (for disposition) column indicates that message IEF450I was successfully suppressed.

     AOF Test MSG ------------ MSI1 --- OPSVIEW --- 15:27:24  12OCT2009 COLS 001 070
     COMMAND ===>                                                   SCROLL ===> PAGE
      REXX Trace ==> N   Live Commands  ==> NO        Access Auto Test Data:   (Y/N)
      Msg Id:  IEF450I    Msg Disp:  Suppress        Hardcopy Log:
      Jobname     ==> XXXX                       IMS Id      ==>
      Job Id      ==>                            Exit Type   ==> MVS
      MSF Sys     ==>                            Console Id  ==> 0
      User        ==>                            Console Nm  ==>
      Sys Id      ==>                            MCS Flags   ==> 000000
      Special Ch  ==>                            Descriptor  ==> 0000
      Route       ==> 0000000000000000000000000000000000
      Term Name   ==>                            Report Id   ==>
      Message     ==> IEF450I SAMPLE MESSAGE
     Dis    ----+----1----+----2----+----3----+----4----+----5----+----6----+----7
     ******** ********************* TOP OF MESSAGES  *******************************
     NON ENABLE TESTING.IEF450I
     NON ENABLE TESTING.IEF450I
     000 OPR39000 RULE TESTING.IEF450I FOR MSG IEF450I           NOW ENABLED
     SUP IEF4501 SAMPLE MESSAGE
     

7. Examine the results of the test in the OPSLOG and when satisfied, press PF3 or type END on the command line.

Your rule is tested and verified.