Set the file maintenance utility command processor condition code.
Set >>-SET--+---------------+--+------------------+-----------------> '-,ADDCC(value)-' '-,DELETECC(value)-' >--+----------------+--+----------------+-----------------------> '-,HIGHCC(value)-' '-,LISTCC(value)-' >--+-------------------+--+------------------+----------------->< '-,OVERALLCC(value)-' '-,UPDATECC(value)-'
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.