INGTHRES

Purpose

The INGTHRES command displays all thresholds that are defined for a resource. INGTHRES lists the thresholds that were set using the INGTHRES command or that are defined in your automation control file. INGTHRES also lets you set, change or delete the threshold settings for a particular resource. INGTHRES also sets the defaults for all MVS subcomponents, for all subsystems, or for MVSESA components.

Syntax

Read syntax diagramSkip visual syntax diagramINGTHRESDEFAULTSSUBSYSTEMMVSESAresnamefilterREQ=SETREQ=DELThresholdsTARGET=DestinationDest_list*ALLOUTMODE=LINEAUTONETLOG
Thresholds
Read syntax diagramSkip visual syntax diagramCRIT=( nn, interval)FREQ=( nn, interval)INFR=( nn, interval)
Destination
Read syntax diagramSkip visual syntax diagramsystem_namedomain_IDsaplex_name
Dest_list
Read syntax diagramSkip visual syntax diagram( Destination )

Parameters

If you do not specify a subsystem, the INGTHRES panel is displayed.

DEFAULTS
Sets the default settings for all automated resources that: do not have their own threshold settings OR do not belong to a group that has its own threshold settings.
SUBSYSTEM
Sets defaults for all subsystems.
MVSESA
Sets defaults for all MVS subcomponents.
resname
Specifies a particular resource, for example, WTOBUF. You can specify any automated resource.
filter
Is the filter used for the output. Only resource names that match the filter criteria are displayed. Wildcard is supported. The filter consists of the major resource name and, optionally, of a minor resource name separated by a period, for example, CICS*.TRANS*, or .*CEMT. To view major resources specify *. To view minor resources specify xyz.*.
REQ
Specifies the request type which can be:
SET
Adds or updates the thresholds for the given resource. This is the default setting.
DEL
Deletes the thresholds for the given resource.
CRIT
Specifies values for the critical threshold.
FREQ
Specifies values for the frequent threshold.
INFR
Specifies values for the infrequent threshold.
nn
Specifies the number of errors before the threshold is reached. You can specify a maximum of 50.
interval
Specifies the time period before the threshold is reached in the form hh:mm[:ss], where:
hh
Hours
mm
Minutes
ss
Seconds
TARGET
For information on the TARGET parameter, see TARGET Parameter.
OUTMODE
For information on the OUTMODE parameter, see OUTMODE Parameter.

Restrictions and Limitations

The changes you make are active only until the next time the automation control file is loaded.

The INGTHRES command can only be used when SA z/OS® is initialized.

Usage

SA z/OS uses threshold settings to determine when to stop trying to recover a component or restart a subsystem. The primary use of thresholds is to track subsystem abends and to make sure that the abend-and-recovery cycle does not become a loop.

When a threshold is crossed, SA z/OS performs the action specified for that threshold in the automation control file. For components, this action is customer-defined: contact your SA z/OS administrator for more information. For subsystems, SA z/OS performs the following actions:
Threshold exceeded Action
Infrequent Issues warning message
Frequent Issues warning message
Critical Stops Restart automation and issues a message to that effect

All three threshold values (CRIT, FREQ, and INFR) can be set with one invocation of the command.

The Critical threshold should specify more errors or a shorter time period than the Frequent and Infrequent thresholds.

Examples

To set defaults for all automated resources, enter: 
ingthres defaults crit=(2,00:14) freq=(2,01:00) infr=(4,04:00)
To add or replace the critical threshold for the resource JES2, enter: 
ingthres jes2 crit=(2,02:00)
If you enter ingthres jes2, you will see the command dialog shown in Figure 1.
Figure 1. Display of Threshold Settings for JES (INGTHRES JES)
 INGKYTH0                  SA z/OS  - Command Dialogs      Line  1    of 4      
 Domain ID   = IPSFM     ---------- INGTHRES ----------    Date = 11/23/09      
 Operator ID = NETOP1                                      Time = 12:52:57      
                                                                                
 Cmd:  A Add thresholds    C Change thresholds    D Delete thresholds           
                                                                                
 Cmd System    Resource                Critical        Frequent      Infrequent 
 --- --------  ----------------  --------------  --------------  -------------- 
      KEY1     DEFAULTS           4 in 01:00:00   4 in 02:00:00   6 in 12:00:00 
      KEY1     MVSESA             1 in 01:00:00   1 in 02:00:00   1 in 04:00:00 
      KEY1     SUBSYSTEM          1 in 00:05:00   1 in 00:30:00   1 in 01:00:00 
      KEY1     JES2               1 in 01:00:00   1 in 04:00:00   1 in 08:00:00 
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
 Command ===>                                                                   
    PF1=Help     PF2=End        PF3=Return                      PF6=Roll        
                                PF9=Refresh                    PF12=Retrieve
If JES reaches the Critical threshold, Restart automation does not continue. If JES exceeds the Frequent or Infrequent threshold, a message is sent to notification operators to inform them.
  • The Cmd field lets you modify the thresholds of a resource. The following command codes are supported:
    A
    Add new thresholds for a resource with the same values as the one selected.
    C
    Change existing thresholds for a selected resource.
    D
    Delete threshold settings for a selected resource.

    To define thresholds for a resource you can either type the ADD command at the command line or specify command code A in front of the resource whose thresholds should be used as the default. You can then modify the settings as needed.

  • The System field shows the name of the system where the resource resides.
  • The Resource field shows the name of the resource that the thresholds are defined for. The entries are sorted alphabetically.
  • The Critical field shows the critical threshold defined for the resource.
  • The Frequent field shows the frequent threshold defined for the resource.
  • The Infrequent field shows the infrequent threshold defined for the resource.

If you specify command code A, a panel similar to Figure 2 is displayed.

Figure 2. INGTHRES Command Dialog Panel to Add Thresholds
 AOFKAASR                  SA z/OS  - Command Dialogs                           
 Domain ID   = IPSFM     ---------- INGTHRES ----------    Date = 12/07/01      
 Operator ID = NETOP1                                      Time = 16:30:54      
                                                                                
                                                                                
 Specify thresholds and resource changes:                                       
                                                                                
  Resource   =>                 resource name, MVSESA, SUBSYSTEM or DEFAULTS    
  Minor name =>                                    minor resource name          
  Target     =>  KEY4           System name, domain ID, sysplex name or *all    
                                                                                
  Critical   =>  04   errors in  01:00:00   Time (hh:mm:ss)                     
  Frequent   =>  04   errors in  02:00:00   Time (hh:mm:ss)                     
  Infrequent =>  06   errors in  12:00:00   Time (hh:mm:ss)                     
                                                                                
                                                                                
                                                                                
   Pressing ENTER will set the THRESHOLD values                                 
                                                                                
                                                                                
                                                                                
                                                                                
 Command ===>                                                                   
    PF1=Help     PF2=End      PF3=Return                        PF6=Roll        
                                                               PF12=Retrieve