Start of change

ABDISPCC parameter

Parameter type

Keyword, optional

Purpose

This parameter is used to describe how the system performs data set disposition processing based on the job step completion code. By default, the system uses the normal termination disposition for each DD, which can be specified by the second subparameter of the DISP parameter of the DD statement or the first subparameter of the PATHDISP parameter. The system can alternatively use the abnormal termination disposition, which can be specified by the third subparameter of the DISP parameter of the DD statement or the second subparameter of the PATHDISP parameter.

Syntax

ABDISPCC=(code,operator)

Subparameter definition

code
Specifies a number that the system compares to the completion code of the current step. It is a decimal number from 0 to 4095.
operator
Specifies the type of comparison to be made to the step completion code. Operators and their meanings:
GT
Greater than.
GE
Greater than or equal.

Defaults

If ABDISPCC is not specified on the EXEC statement, the system uses the normal termination disposition for each DD when the step terminates normally regardless of the step completion code.

Relationship to other control statements

This keyword affects the processing of the DISP and PATHDISP parameters on DD statements within the job.

Examples

Example 1

Start of change
//STEPB EXEC PGM=FAILURE,ABDISPCC=(16,GE)
//DD2   DD DSN=TEST.DSN,DISP=(NEW,CATLG,DELETE),
//         UNIT=SYSALLDA,VOLUME=SER=DASD01,
//         SPACE=(TRK,1)
DD statement DD2 defines a new data set. If STEPB terminates normally with a step completion code less than 16, the data set is cataloged. If STEPB abnormally terminates, or normally terminates with a step completion code greater than or equal to 16, the data set is deleted.End of change

Example 2

Start of change
//STEPC EXEC PGM=FAILPROG,ABDISPCC=(8,GT)
//DD3   DD PATH=’/tmp/test.data’,PATHDISP=(KEEP,DELETE)
DD statement DD3 identifies an existing file. If the step terminates normally with a step completion code of 8 or less, the file is kept. If the step terminates normally with a step completion code greater than 8, the file is deleted. If STEPC abnormally terminates, the data set is also deleted.End of change
End of change