Set Up Test Data for the AOF

OPSVIEW Editors Option › Set Up Test Data for the AOF

Set Up Test Data for the AOF

Follow the steps on the next several pages to set up test data for the AOF.

To set up test data for the AOF

Verify That the Rule Is Enabled
Before you can test a rule, it must be enabled. If you have not enabled the rule, you can do so from the Rule List panel. Enter the E line command in the prefix area of the line on which the name of the rule appears. Do this for every rule you want to test.

If the E command fails, the rule contains syntax errors. Correct the syntax errors and issue the E command again.
Issue the T Command for the Rule
On the Rule List panel, enter the T line command in the prefix area of the line on which the name of the rule you want to test appears. As a result, the AOF places you in the rule test environment.
Enter the Test Environment
When the AOF places you in the rule test environment, the actual panel you see depends upon the type of rule you selected for testing. In the following sample panel, the words AOF Test CMD appear at the upper left corner of the panel to indicate that the rule that was selected for testing is a CMD (command) rule.

If you are testing another type of rule, such as a MSG (message) or OMG (OMEGAMON) rule, the panel you see will differ slightly. All of the panels and the fields that appear on them are described under Overview of AOF Test Panels for Different Rule Types in this chapter. Regardless of the type of rule you want to test, the process of setting up test data is essentially the same.
```
AOF Test CMD ------------ MSI1 --- OPSVIEW --- 13:38:09 29JUN2007 COLS 001 070
COMMAND ===>                                                  SCROLL ===> PAGE
 REXX Trace ==> N   Live Commands ==> NO        Access Auto Test Data:   (Y/N)
 IMS Id          ===>                 Exit Type      ===> MVS
 Console Number  ===> 1               Jobname        ===> T
 Console Name    ===>                 Command Disp:
 User Field      ===>                 Command Verb:
 Command         ===>
Time     ----+----1----+----2----+----3----+----4----+----5----+----6----+----7
******** ********************* TOP OF MESSAGES  *******************************
13:38:09 ENABLE O.CMD
13:38:09 ENABLE O.CMD
******** ******************* BOTTOM OF MESSAGES *******************************
```
The messages that appear in the message section at the bottom of the panel shown above came from OPSLOG. They indicate that the user enabled the rule named CMD that is stored in the O rule set. At this point, the rule has not been tested.

Access OPSLOG Browse

From the AOF Test panel for your rule, enter a Y in the Access Auto Test Data field. As a result, the AOF puts you into OPSLOG Browse. Following is a sample panel:

OPSLOG Browse Test Data-- MSI1 --- AOF TEST --- 09:41:05 29JUN2007 COLS 001 059 Line commands 'E' and 'EE' available for test data extraction COMMAND ===> SCROLL ===> CSR MessageNum Message ID ----+----1----+----2----+----3----+----4----+----5----+--- 0105917000 IST664I IST664I REAL OLU=NETTX.EMCVAPP7 REAL DLU=NETTX.AHO1 0105917001 IST889I IST889I SID = D90BE39BB5E72EEB 0105917002 IST889I IST889I SID = D90BE39BB5E72EEB E105917003 IST264I IST264I REQUIRED RESOURCE AHO1207Z UNDEFINED 0105917004 IST264I IST264I REQUIRED RESOURCE AHO1207Z UNDEFINED 0105917005 IST314I IST314I END 0105917006 IST314I IST314I END 0105917007 OPS1400H OPS1400H MSIADA OPSS JES3 3.1 NONE 0105917008 OPS1400H OPS1400H MSIADA OPSS JES3 3.1 NONE 0105917009 OPS1181H OPS1181H MSIADA OPSS MVS E MSIADA,PERFORM=002 0105917010 OPS1181H OPS1181H MSIADA OPSS MVS E MSIADA,PERFORM=002 EE05917011 E E MSIADA,PERFORM=002 0105917012 RESET E MSIADA,PERFORM=002 0105917013 IEE304I IEE304I MSIADA JOB RESET EE05917014 IEE304I IEE304I MSIADA JOB RESET 0105917015 OPS1450H OPS1450H MSIADA OPSS OPSLOG 0105917016 OPS1450H OPS1450H MSIADA OPSS OPSLOG 0105917017 OPS1450H OPS1450H MSIADA OPSS OPSLOG 0105917018 OPS1450H OPS1450H MSIADA OPSS OPSLOG ********** ***************** BOTTOM OF MESSAGES *******************************

Extract Lines of Data from OPSLOG
After the AOF puts you into OPSLOG Browse, you can begin extracting data for your rule test. Use these commands to extract the data:

E

Extracts a single line of data. Place an E in the MessageNum (message number) field of each single line of data you want to extract. Notice that in the panel above, the user has placed the E command to extract a single line.

EE

Extracts a block of data. Place the characters EE in the MessageNum fields of the first and last lines of the block you want to extract. In the panel above, the user has placed the EE command to extract a four-line block.

After you enter in the E or EE commands, press PF3 (END). As shown in the panel above, you may specify multiple single line and block extractions before pressing PF3. When you press PF3, the AOF displays the AOF Test Data Selection panel, where you can view the data you extracted.

Note: When the AOF takes you into OPSLOG Browse, the MessageNum field always appears on the OPSLOG Browse Test Data panel. This occurs because the MessageNum field is the only OPSLOG Browse field that permits data entry for line commands.

View and Verify Extracted Data

After you extract data from OPSLOG Browse, the AOF displays the AOF Test Data Selection panel. Use this panel to view the data you extracted, and verify it is correct:

AOF Test Data Selection ---------- OPSVIEW  ----------------------- ROW 1 OF 5
COMMAND ===>                                                  SCROLL ===> PAGE
 Line Cmds: A-Add (DD)D-Del R-Replicate  S-Select (TT)T-(Block) Test U-Update
Test Suite: Temporary Test Data
 Acquire Data from OPSLOG Browse ===>   (Y/N)
  Job Name   Msg ID         Shortened Text
  *****************************************************************************
   MSIADA     E              E MSIADA,PERFORM=002
   MSIADA     RESET          E MSIADA,PERFORM=002
   *MASTER*   IEE304I        IEE304I MSIADA   JOB RESET
   NONE       IEE304I        IEE304I MSIADA   JOB RESET
   NETVIEW    IST264I        IST264I  REQUIRED RESOURCE     AHO1207Z
  ***************************** Bottom of data ********************************

When you look at the AOF Test Data Selection panel, you may decide to extract more data for the test, or to edit the data in some way. Steps 7 and 8 can help you.

Extract Additional OPSLOG Data
If you are viewing the AOF Test Data Selection panel, and you need more OPSLOG data for your rule test, enter a Y in the Acquire Data from OPSLOG Browse field. As a result, the AOF returns you to OPSLOG Browse.

After you place the E or EE commands on the new data lines you want to extract and press PF3, the AOF asks if you want to add the new lines to your existing test data or replace the existing test data with the new lines.

When you respond, the AOF returns you to the AOF Test Data Selection panel.
Edit the Extracted Data
Notice the line commands that appear on the sample AOF Test Data Selection panel (shown above). You can use the following commands to modify the test data you extracted from OPSLOG Browse.

A

Adds a line of test data to the AOF Test Data Selection panel. If you issue this command, the AOF takes you to the AOF Test Data Edit panel. For details, see The AOF Test Data Edit Panel in this chapter.

D

Deletes a single line of test data.

DD

Deletes a block of lines of test data. Place the command in the prefix area of both the first and the last lines in the block.

R

Copies (replicates) a line of test data.

S

Selects a line of test data for editing.

T

Tests a single line of data against all enabled rules.

TT

Tests a block of lines of test data against all enabled rules. Place the command in the prefix area of both the first and the last lines in the block. Use this command with caution; it runs a separate test for all enabled rules multiplied by the number of lines in the block.

U

Updates a line of test data. If you issue this command, the AOF takes you to the AOF Test Data Edit panel. For details, see The AOF Test Data Edit Panel in this chapter.

Use the Extracted Data to Test Your Rule

When you are satisfied with the data you have extracted, issue the T line command on the AOF Test Data Selection panel.

As a result, the AOF tests your rule and displays the results on the OPSLOG Browse Test Data Results panel.

Following is a sample panel:

OPSLOG Browse Test Data-- MSI1 --- AOF TEST --- 09:47:38 29JUN2007 COLS 001 057 ----------- Results from AOF Test Environment ------------------- COMMAND ===> SCROLL ===> PAGE Ruleset.Rulename Dis ----+----1----+----2----+----3----+----4----+----5----+-- ***************** *** ******** TOP OF MESSAGES ******************************* O.CMD NON ENABLE O.CMD O.CMD 000 ENABLE O.CMD O.CMD REJ RESET MSIADA,PERFORM=002 NONE.NONE NON GLOBAL.RESET O.CMD MSILCD NONE.NONE 000 OPS4200I TSO: 'SEND 'RESET command issued ' USER(MSISUPA) O.CMD 008 RESET MSIADA,PERFORM=002 ***************** *** ******* BOTTOM OF MESSAGES ******************************

The results shown in the above sample indicate that the enabled rule named CMD, which is stored in the rule set named O, took these three actions:

Rejected the RESET command
Modified a global variable
Issued a TSO SEND command

Tell Technical Publications how we can improve this information