AOFRSA08

Purpose

You can use the AOFRSA08 automation routine to respond to syslog being queued messages by starting an external writer to save the syslog that was queued.

AOFRSA08 keeps track of the incoming syslog queued messages and compares there occurrence with predefined thresholds at infrequent, frequent, and critical levels. An exceeded threshold is used as the option for selecting the appropriate commands according to the first field in the command entry of the MVSESA/SYSLOG entry/type-pair in the configuration file. If no threshold is exceeded the commands that are defined for the selection option ALWAYS are issued.

AOFRSA08 should be called from the NetView automation table.

Syntax

Restrictions

Processing in AOFRSA08 is only done if it is called from NetView automation table by the expected message IEE043I.
Actions are only taken in AOFRSA08 if the recovery automation flag for SYSLOG is on and if the status of JES is UP or HALTED.

Usage

Automation routine AOFRSA08 is intended to respond to the message:

IEE043I A SYSTEM LOG DATA SET HAS BEEN QUEUED TO SYSOUT CLASS class

which indicates that the system closed the system log (SYSLOG) data set and queued the data set to a SYSOUT class.

The commands to issue are selected from the command entry of the MVSESA/SYSLOG entry/type-pair in the configuration file.

If no threshold is reached when one of the expected messages arrive, all commands that are defined for entries without a selection option and for the selection option ALWAYS are selected.

If the threshold at the infrequent level is exceeded, all commands that are defined for entries without a selection specification option and for entries with the selection option INFR are selected.

In the same way, a level of frequent corresponds to the selection option FREQ and a level of critical corresponds to the selection option CRIT.

Examples

This example shows a sample scenario for SYSLOG processing:

The following entry in the NetView automation table is created automatically to issue AOFRSA08 as response to the incoming IEE043I message:

IF MSGID = 'IEE043I'                       
THEN                                                     
EXEC(CMD('AOFRSA08')ROUTE(ONE %AOFOPRECOPER%));

Figure 1. Threshold Definitions for MVS Component SYSLOG

   COMMANDS  HELP                                                               
 ------------------------------------------------------------------------------ 
                               Thresholds Definition                            
 Command ===>                                                                   
                                                                                
 Entry Type : MVS Component         PolicyDB Name   : DATABASE_NAME             
 Entry Name : MVS_COMPONENTS        Enterprise Name : YOUR_ENTERPRISE           
                                                                                
 Resource   : MVSESA.SYSLOG                                                     
                                                                                
 Critical Number  . . . . 3       (1 to 50)                                     
 Critical Interval  . . . 00:05   (hh:mm or hhmm, 00:01 to 24:00)               
                                                                                
 Frequent Number  . . . . 3       (1 to 50)                                     
 Frequent Interval  . . . 00:30   (hh:mm or hhmm, 00:01 to 24:00)               
                                                                                
 Infrequent Number  . . . 3       (1 to 50)                                     
 Infrequent Interval  . . 24:00   (hh:mm or hhmm, 00:01 to 24:00)

Figure 2. MESSAGES/USER DATA Policy Item for Entry/Type-Pair MVSESA/SYSLOG

Cmd PS/Select AutoFn/* Command Text                                                             
                       MVS S SAVELOG

Assume that the following message arrives the first time for one day:

IEE043I A SYSTEM LOG DATA SET HAS BEEN QUEUED TO SYSOUT CLASS A

Because none of the defined thresholds is exceeded, the automation routine AOFRSA08 searches for defined commands without selection option and to selection option ALWAYS to be issued. With the control file shown above the command MVS S SAVELOG is selected.

If message IEE043I continues to arrive and the occurrence of the expected messages thus exceeds the infrequent, frequent or critical threshold, the automation routine AOFRSA08 searches for defined commands without selection option and to selection option INFR, FREQ or CRIT to be issued.

Because no command is defined with any selection option, only the defined command with no selection option is selected and issued, as in the previous case.

Message AOF589I, AOF588I or AOF587I is issued in cases, where an infrequent, frequent or critical threshold has been exceeded. These messages indicate that an infrequent, frequent or critical threshold action has been processed.