Processing the SMP/E RC operand

SMP/E keeps records of the highest return code for each command processed during a single SMP/E run. Before SMP/E processes a command, it checks whether the return codes for previous commands are less than the maximum allowed. If so, SMP/E can process the command; otherwise, the command fails.

You can change which return codes SMP/E checks for by specifying the RC operand on the command you want to process. This operand must be the last one specified on the command. It indicates which commands and return codes SMP/E is to check before processing the current command. The return code must be a decimal number greater than or equal to 0 and less than 16. For example, if you want the ACCEPT command to run unless the return code from a previous APPLY command is higher than 8, and you want SMP/E to check the default values for JCLIN, UCLIN, and SET, you should code this RC operand on the ACCEPT command:

RC(APPLY=08,JCLIN=08,UCLIN=08,SET=00)

Table 1 shows the default maximum return codes for each SMP/E command. Using these default values, for example, SMP/E processes an ACCEPT command if the return codes for previous commands meet these conditions:

The highest return code for a SET command was 0. This condition is required because if the SET command fails, SMP/E does not know which zone to process for the subsequent commands.
The highest return code for a JCLIN or UCLIN command was less than 8. This condition is required because these commands prepare data sets, such as the CSI, for processing by subsequent commands. If these commands fail, the other commands could either fail or run incorrectly.
The highest return code for any other command was less than 12.

Table 1. Default maximum return codes for commands previously processed
Command to be processed	Maximum for all commands except JCLIN, UCLIN, and SET	Maximum for JCLIN or UCLIN	Maximum for SET
ACCEPT	12	08	00
APPLY	12	08	00
BUILDMCS	12	08	00
CLEANUP	12	08	00
DEBUG	16	16	00
GENERATE	12	08	00
GZONEMERGE	12	08	00
JCLIN	12	08	00
LINK	12	08	00
LIST	16	12	00
LOG	12	08	00
RECEIVE	12	08	00
REJECT	12	08	00
REPORT	16	16	00
RESETRC	16	08	00
RESTORE	12	08	00
SET	16	16	16
UCLIN	12	08	00
UNLOAD	12	08	00
UPGRADE	16	16	00
ZONECOPY	12	08	00
ZONEDELETE	12	08	00
ZONEEDIT	12	08	00
ZONEEXPORT	12	08	00
ZONEIMPORT	12	08	00
ZONEMERGE	12	08	00
ZONERENAME	12	08	00

Return code processing for the RC operand is similar to processing for the default maximum return codes. Before SMP/E processes a command with the RC operand, it checks whether the return codes for previous commands are less than or equal to the maximums specified on the RC operand. If so, SMP/E can process the command; otherwise, the command fails. There is a difference, however. SMP/E checks return codes only for the commands specified on the RC operand. Return codes for any commands not specified do not affect processing for the current command. Therefore, if you use the RC operand, you should specify every command whose return code you want SMP/E to check.