$T OUTCLASS(n)

Function

To specify the default disposition of the SYSOUT data sets in one or more specified output classes.

Syntax


>>-$T--OUTCLASS--+-n--+-----------+-------------------+--------->
                 |    '- ---+-n-+-'                   |   
                 |          '-*-'                     |   
                 |    .-,------------------------.    |   
                 |    V                          |    |   
                 '-(------+-n-+--+-----------+---+--)-'   
                          '-*-'  '- ---+-n-+-'            
                                       '-*-'              

>--+----------------------------------------------------------+-><
   '-,--OUTDisp--=--+-+-H-----+-----------------------------+-'   
                    | +-HOLD--+                             |     
                    | +-K-----+                             |     
                    | +-KEEP--+                             |     
                    | +-L-----+                             |     
                    | +-LEAVE-+                             |     
                    | +-P-----+                             |     
                    | +-PURGE-+                             |     
                    | +-W-----+                             |     
                    | '-WRITE-'                             |     
                    '-(--+-----------+--+--------------+--)-'     
                         '-+-H-----+-'  '-,--+-H-----+-'          
                           +-HOLD--+         +-HOLD--+            
                           +-K-----+         +-K-----+            
                           +-KEEP--+         +-KEEP--+            
                           +-L-----+         +-L-----+            
                           +-LEAVE-+         +-LEAVE-+            
                           +-P-----+         +-P-----+            
                           +-PURGE-+         +-PURGE-+            
                           +-W-----+         +-W-----+            
                           '-WRITE-'         '-WRITE-'

Parameters

(n)

The subscript defining the output class(es) (A-Z, 0-9) that are affected. The subscript may specify a single class (for example B) or a range of classes. For information about specifying a range for this subscript, see Command syntax conventions.

OUTDisp

Specifies the default disposition of the SYSOUT data sets in the specified output class(es).

(normal)

Specifies the output disposition if the job ends successfully. Specify one of the output dispositions below.

(abnormal)

Specifies the output disposition if the job ends unsuccessfully. Specify one of the output dispositions below.

Note: A job is considered to have ended abnormally if:

The job abended,
The job has a JCL error
Completed unsuccessfully with a condition code (COND=...) specified on the JOB statement
The job fails during input processing
The job fails during conversion processing.

Valid output dispositions:

H|HOLD

Hold the output. JES2 does not process the output until you either change the disposition to WRITE or KEEP, or release the output. When the output is released, the disposition changes to WRITE.

K|KEEP

Process the output and then keep a copy of it on spool. After processing, the disposition of this output becomes LEAVE.

L|LEAVE

JES2 does not process the output until you change the disposition to WRITE or KEEP, or release the output. Once the output is released, the disposition changes to KEEP.

P|PURGE

Purge the output immediately.

W|WRITE

Process the output then purge it.

See z/OS JES2 Initialization and Tuning Guide, SA32-0991 for more information about specifying output disposition and how JES2 determines output disposition defaults.

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 $HASP842 message displays the current values of all the parameters on the OUTCLASS initialization statement.

Example

 1   $t outclass(2),outdisp=(purge,write)

  $HASP842 OUTCLASS(2),OUTPUT=PRINT,BLNKTRNC=YES,
                       OUTDISP=(PURGE,WRITE),TRKCELL=YES

If a job, that has not yet entered output processing and has output in outclass(2), ends normally, JES2 purges its output in outclass(2). Otherwise the output is printed or punched normally.