$T RECVopts

Function

For subtask and disastrous errors:
To specify the error rate threshold below which automatic SVC dumps are issued.
For JES2 main task errors:
To specify the error rate threshold below which the operator is not involved in the recovery process.

One or more parameters on this command accepts wild cards. Parameter descriptions will note that.

Syntax


>>-$T--RECVopts--+-'--type--'---------------+------------------->
                 |    .-,--------------.    |   
                 |    V                |    |   
                 '-(----+-type-------+-+--)-'   
                        '-'--type--'-'          

>--+-----------------+--+----------------------+---------------><
   '-,--COUNT--=--nn-'  '-,--INTERVAL--=--nnnn-'

Parameters

{type|*}

Specifies the type of recovery errors for which the operator does not receive the $HASP070 message.

You also can specify wild cards for the recovery error type. See Using wildcards for additional information.

If you specify (*), JES2 suppresses the $HASP070 message for all types of recovery errors. The valid types and their meanings are:

ALLOCATE: Allocation subtask errors
CBIO: CBIMPLxx disastrous errors
CKPTVRNS: APPLCOPY/CKPTVRNS subtask errors
CKPTONCF: Checkpoint on CF subtask errors
CKPT: Checkpoint errors
CONVERT: JCL conversion subtask errors
DISTERR: Disastrous errors
GENERAL: Generalized subtask recovery errors
IMAGE: Image subtask errors
MAIN: JES2 main task errors (catastrophic and abends)
OFFLOAD: Offload subtask errors
PQE: Print/punch queue error
SMF: SMF subtask errors
SPOOL: Spool subtask errors
VTAM®: VTAM subtask errors
WTO: WTO subtask errors

COUNT=nn

If the type is MAIN, COUNT= specifies the number (1-99) of errors permitted to occur within the specified time interval at which the operator becomes involved in the recovery process. For example, COUNT=2 indicates that the operator becomes involved in the recovery process when the second error occurs.

For other error types, COUNT= specifies the number of errors permitted to occur in the specified time interval at which automatic SVC dumps are no longer issued. For example, if a single automatic dump is desired, specify COUNT=2.

INTERVAL=nnnn

The time interval, in hours (1-9999), in which JES2 counts errors of the specified type. If a number is not specified, INTERVAL defaults to 24.

Note: If you change the value of this parameter, JES2 resets the cumulative error counter used for recovery/diagnostic processing to zero.

Authority Required

This command requires system authority. The description of the $T RDRnn command explains how to ensure that the authority of the appropriate MVS™ system command group is assigned.

This command requires control security access authority. For a description of assigning command input authority, see z/OS JES2 Initialization and Tuning Guide, SA32-0991.

Scope

Single member. This command will be in effect for this member only.

Depending on your installation's setup, however, you might want this command to be applied to all members of the MAS (to ensure a consistent environment across the MAS). If so, you can use the MVS ROUTE *ALL command to issue this command to all active members (if the JES2 command character is the same on all members). See z/OS MVS System Commands, SA38-0666 for more information on using the ROUTE *ALL command.

Messages

The $HASP846 message displays the current values of all the parameters on the RECVOPTS initialization statement.

Examples

 1   $t recvopts(main),count=3,interval=24

  $HASP846 RECVOPTS(MAIN) COUNT=3,INTERVAL=24

If three JES2 main task errors occur within a 24 hour time period, the operator becomes involved in the recovery process at the time of the third error.

 2   $t recvopts(disterr),count=2,interval=48

  $HASP846 RECVOPTS(DISTERR) COUNT=2,INTERVAL=48

JES2 issues an automatic SVC dump only for the first disastrous error that occurs in a 48 hour time period. The $HASP096 message indicates the csect in which the error occurred. For subsequent errors, JES2 issues the $HASP096 message but does not issue a dump.