Testing Messages

SA z/OS provides a collection of NetView automation table entries for your SA z/OS configuration. NetView automation table entries are in the AOFCMD member of the SA z/OS SINGPARM installation data set. When these entries are moved to your NetView automation table, they may need additional editing.

For example, you may already test for a particular message in your production NetView automation table. If you add an entry that tests for that same message, your automation table will not run as you expect. After a match with the test criteria is found, the search of the automation table is aborted. The second NetView automation table statement is not found. Consequently, the message does not drive all of your required actions.

To avoid this, combine entries into a single test condition. This ensures that all required actions are scheduled for all messages. For the following message:

IEA320A RESPECIFY PARAMETERS OR CANCEL

your NetView automation table may already have the following entry: ( 1 )

IF      MSGID = 'IEA320A'
THEN    EXEC (CMD('USERJOB') ROUTE( ONE *) ) CONINUE(Y);

With SA z/OS installed, the following message appears when forwarded from System z® or 390-CMOS processor hardware:

ISQ900I SYS1 OC IEA320A RESPECIFY PARAMETERS OR CANCEL

After the SA z/OS entries are added, the NetView automation table includes the following entry:

IF      TEXT = . 'IEA320A RESPECIFY PARAMETERS' .
        & MSGID = 'ISQ900I' .
THEN
        EXEC (CMD('ISQI320 '   ) ROUTE( ONE *) )
        DISPLAY(N) NETLOG(Y);

In this case, the first entry satisfies the IF test and the command USERJOB runs ( 1 ). The second command, ISQI320, is not scheduled to run because once the message matches a table entry, the autotask stops searching. Combine these two entries into a single entry, such as:

IF      TEXT = . 'IEA320A RESPECIFY PARAMETERS' .
        & MSGID = 'ISQ900I' .
THEN
   EXEC(CMD('ISQI320 ' ) ROUTE( ONE *) )
   EXEC(CMD('USERJOB ' ) ROUTE( ONE *) )
   DISPLAY(N) NETLOG(Y);

When you use the second example, both commands are scheduled.

If your NetView automation table tests the text of SA z/OS messages, the message format must match the character case for which you test. This can be done by requiring all sites to use the same format for their messages, or by duplicating AT entries in uppercase and in mixed formats.