AOFRSA0C

Purpose

You can use the AOFRSA0C automation routine to respond to a SVC dump taken to a dump data set message by issuing commands from the configuration file to format the dump, to clear the dump data sets, or to prevent further dumping. The commands to issue are taken from the MVSESA/MVSDUMP and MVSESA/MVSDUMPTAKEN entry/type-pairs and selected according to the frequency of the incoming messages and the thresholds defined in the automation policies. The first field in the command entry gives detailed criteria to select the appropriate commands from the configuration file.

AOFRSA0C should be called from the NetView automation table.

Syntax

Restrictions

Actions in AOFRSA0C are only taken if the recovery automation flag for MVSDUMP is on.
Processing in AOFRSA0C is only done if it is called from NetView automation table by one of the expected messages IEA611I or IEA911E.

Usage

Automation routine AOFRSA0C is intended to respond to the following messages:

IEA611I {COMPLETE|PARTIAL} DUMP ON dsname
DUMPID=dumpid REQUESTED BY JOB (jobname)
FOR ASIDS(id,id,...)
...

IEA911E {COMPLETE|PARTIAL} DUMP ON SYS1.DUMPnn
DUMPid=dumpid REQUESTED BY JOB (jobname)
FOR ASIDS(id,id,...)
...

These indicate that the system wrote a complete or partial SVC dump to an automatically allocated or pre-allocated dump data set on a direct access storage device or a tape volume.

AOFRSA0C keeps track on the reception of these messages and compares the frequency of the incoming messages with predefined thresholds of infrequent, frequent and critical level, where the thresholds to MVS component MVSDUMP are considered. The commands to issue are selected according to the frequency of the incoming messages.

If no threshold is reached, all commands to entries with no selection option and to selection option ALWAYS are selected. If the threshold at level infrequent is exceeded, all commands to entries with no selection option and to selection option INFR are selected. In the same way a level of frequent corresponds to selection option FREQ and a level of critical corresponds to selection option CRIT.

The commands to issue are taken from MVSESA/MVSDUMP entry/type-pair of the configuration file with respect to the frequency of the incoming of these messages.

If AOFRSA0C has been triggered by receipt of message IEA911E, all the commands from the MVSESA/MVSDUMPTAKEN entry/type-pair of the configuration file are also selected and issued, as long as the critical threshold has not been exceeded.

After dump processing has been done, AOFRSA0C further monitors the frequency of messages IEF611I and IEF911E in intervals of 15 minutes. As soon as the frequency falls below the infrequent threshold, all the commands of MVSESA/MVSDUMPRESET entry/type-pair are issued.

Global Variables

When defining the commands in the configuration file to handle the SVC dump data set, the variables &EHKVAR1 to &EHKVAR6 can be used to be substituted by variable contents of message IEA611I or IEA911E. The variables &EHKVAR1 to &EHKVAR6 are not available in command entries of type MVSDUMPRESET. These variables are substituted as follows:

&EHKVAR1: The dsname of IEA611I or suffix of SYS1.DUMPnn in IEA911E
&EHKVAR2: The data set name
&EHKVAR3: The dump ID
&EHKVAR4: The job name
&EHKVAR5: The ID of address space
&EHKVAR6: The dump type (PARTIAL or COMPLETE)

Examples

This example shows the use of automation routine AOFRSA0C in a sample context:

An entry in the NetView automation table is used to issue AOFRSA0C when one of the expected messages arrives:

IF MSGID = 'IEA611I' | MSGID = 'IEA911E'             
THEN                                              
EXEC(CMD('AOFRSA0C ')ROUTE(ONE %AOFOPRECOPER%));

Three threshold levels are defined in the automation policy for MVS component MVSDUMP:

Figure 1. MVSDUMP Thresholds

AOFKAASR                  SA z/OS  - Command Dialogs                           
 Domain ID   = IPSNO     ---------- INGTHRES ----------    Date = 08/28/03      
 Operator ID = SAUSER                                      Time = 09:38:02      
                                                                                
                                                                                
 Specify thresholds and resource changes:                                       
                                                                                
    Resource     =>    MVSESA.MVSDUMP     Group or specific resource            
    System       =>    KEY3         System name, domain ID, sysplex name or *all
                                                                                
    Critical     =>    6    errors in  00:30      Time (HH:MM)                  
    Frequent     =>    4    errors in  00:20      Time (HH:MM)                  
    Infrequent   =>    2    errors in  00:20      Time (HH:MM)                  
                                                                                
                                                                                
                                                                                
    Pressing ENTER will set the THRESHOLD values                                
                                                                                
                                                                                
                                                                                
                                                                                
 Command ===>                                                                   
    PF1=Help     PF2=End      PF3=Return                        PF6=Roll        
                                                               PF12=Retrieve

The MESSAGES/USER DATA automation policy item of the MVSESA/MVSDUMP entry/type-pair contains the following command entries for the message ID MVSDUMP with selection options at different levels:

Ps/Select	Command Text
`FREQ`	`'MVS DD ALLOC=INACTIVE'`
`INFR`	`'MVS DD ALLOC=ACTIVE'`
`CRIT`	`'MVS DD ALLOC=INACTIVE'`

The MESSAGES/USER DATA automation policy item of the MVSESA/MVSDUMPTAKEN entry/type-pair contains the following entry without any selection options:

'MVS DD CLEAR,DSN=&EHKVAR1'

The MESSAGES/USER DATA automation policy item of the MVSESA/MVSDUMPRESET entry/type-pair contains the following entry without any selection options:

'MVS DD ALLOC=ACTIVE'

As long as no threshold is exceeded at receipt of one of the IEA611I and IEA911E messages, no action is taken.

If dumps have been taken more often than defined with the infrequent threshold, the command MVS DD ALLOC=ACTIVATE, specified in entry type MVSDUMP, is issued. This makes sure that automatic dump data set allocation is enabled. In cases when the dump has been written to a pre-allocated SYS1.DUMP data set, additionally the data set is cleared using the command MVS DD CLEAR,DSN=&EHKVAR1, specified in the entry type MVSDUMPTAKEN. Variable &EHKVAR1 is substituted by the numeric suffix of the SYS1.DUMP data set.

The same processing is done in cases when the incoming dump data set messages exceeds the frequent level.

As soon as the critical threshold is exceeded, the automation routine stops clearing pre-allocated SYS1.DUMP data sets.

After commands having been issued by the automatic processing of dump data sets, automation routine AOFRSA0C checks every 15 minutes whether the infrequent threshold is satisfied again. As soon as this situation is reached, automatic dump data set allocation is enabled again by command MVS DD ALLOC=ACTIVE, as defined in entry type MVSDUMPRESET.