SET

Function

Set the file maintenance utility command processor condition code.

Syntax

Read syntax diagramSkip visual syntax diagramSet
 
>>-SET--+---------------+--+------------------+----------------->
        '-,ADDCC(value)-'  '-,DELETECC(value)-'
 
>--+----------------+--+----------------+----------------------->
   '-,HIGHCC(value)-'  '-,LISTCC(value)-'
 
>--+-------------------+--+------------------+-----------------><
   '-,OVERALLCC(value)-'  '-,UPDATECC(value)-'
 

Description

The SET command enables you to specify a return code (RC) for individual commands that allows file maintenance utility command processing to continue instead of terminating. You can specify a different condition code value for each of the file maintenance utility commands-ADD, DELETE, and UPDATE. The default permitted condition code for all the commands is 0 (zero) thus, by default any command returning a non-zero return causes termination of the file maintenance utility.

The SET command enables you to raise the maximum allowed condition code to a value that does not cause the utility to terminate. For example, the DELETE command sets return code 8 if the object you specify for deletion does not exist, in which case, the default action is that command processing terminates and no more commands are processed (see CBKxx7302E). However, if you use DELETECC to set a value equal to, or greater than, the object-not-found return code (8 in this case), command processing continues. Each xxxxCC command corresponds to the command that it affects.

For example, if there is no FILE object named TEST in the CICS BAC control file and you specify DELETE FILE(TEST), the command return code is 8. By default, command processing terminates and the job step ends. However, if you are prepared to accept this one rejection only and want subsequent commands to be processed, specify SET DELETECC(8) command before the DELETE command.

If you subsequently want any commands to revert to default command processing and terminate, for example, when an object is not found, issue a SET DELETECC(0) command. Thus, after each command is processed, and a non-zero return code is issued, a check is made first against the corresponding xxxxCC value. If the return code is less than, or equal to, the xxxxCC value, command processing continues.

Instead of specifying an individual command condition code, you can use the OVERALLCC parameter to specify a ‘catchall’ condition code. If you have not specified an individual xxxxCC value for a particular command, and the command gives a non-zero return code, the command processor compares the return code with any OVERALLCC value that you have specified. If the command return code is less than, or equal to, the OVERALLCC value, command processing continues.

After each command is processed, the return code from the command is compared to the highest return code raised so far. If the latest command return code is higher then the highest return code reported so far, the latest RC is set as the new highest value. You can reset the highest RC value to 0 using the SET HIGHCC(0) command.

Parameters

ADDCC(value)
Specifies the value of the condition code for an ADD command up to which command processing is to continue. If an ADD command raises a return code above the specified value, the command processor does not process any further commands and the file maintenance utility job step terminates and displays the highest return code raised during the job step. Note that the highest return code displayed at job step termination might have been set by a HIGHCC parameter.
DELETECC(value)
Specifies the value of the condition code for a DELETE command up to which command processing is to continue. If a DELETE command raises a return code above the specified value, the command processor does not process any further commands and the file maintenance utility job step terminates and displays the highest return code raised during the job step. Note that the highest return code displayed at job step termination might have been set by a HIGHCC parameter.
HIGHCC(value)
Specifies a new highest condition code. This replaces the highest condition code raised up to the point when file maintenance utility processes the HIGHCC parameter.
LISTCC(value)
Specifies the value of the condition code for a LIST command up to which command processing is to continue. If a LIST command raises a return code above the specified value, the command processor does not process any further commands and the file maintenance utility job step terminates and displays the highest return code raised during the job step. Note that the highest return code displayed at job step termination might have been set by a HIGHCC parameter.
OVERALLCC(value)
Specifies, for those commands for which you have not specified an individual xxxxCC parameter, the value of the condition code up to which command processing is to continue. If any command raises a non-zero return code and you have not specified an individual xxxxCC parameter for the command, the command processor compares the return code with the OVERALLCC value before it terminates command processing. Thus you can use OVERALLCC as a substitute for an individual command parameter.
UPDATECC(value)
Specifies the level of the condition code for an UPDATE command up to which command processing is to continue. If an UPDATE command raises a return code above the specified value, the command processor does not process any further commands and the file maintenance utility job step terminates and displays the highest return code raised during the job step. Note that the highest return code displayed at job step termination might have been set by a HIGHCC parameter.