DFHDPLOY utility return codes

If an error occurs while you run the DFHDPLOY utility, messages are written to the SYSTSPRT data definition destination and the step completes with a nonzero return code. When the return code is 8 or higher, no further commands in the input stream are processed.

There might be related messages in the CICSPlex SM address space (CMAS), connected to as a result of the SET CICSPLEX command, and in CICS systems in which the application or bundle is being deployed or undeployed.

DFHDPLOY return code	Description
0	All commands in the input stream completed successfully.
4	Either one or more warnings occurred during processing, or some commands did not complete successfully within the time that is specified by TIMEOUT. The following examples complete with a return code of 4: An attempt to transition a bundle without any entry points to an ENABLED and AVAILABLE state. An application, which has a target state of DISABLED, ends in an INCOMPLETE state. In cases where the script times out during the transition of a resource to its final target state, this return code does not reflect the success of the transition. Further processing of the application or bundle might occur. No further commands in the input stream are processed.
8	Error. The last command that was processed did not complete successfully, or processing timed out before the transition to the final target state began. The final target state was not reached. No further commands in the input stream are processed.
12	Error. The last command that was processed could not be validated. No further commands in the input stream are processed.

You can use the return code from your DFHDPLOY job to conditionally process later steps by using the JCL COND parameter and the IF/THEN, ELSE, and ENDIF statements. See COND Parameter in the z/OS MVS JCL Reference and IF/THEN/ELSE/ENDIF statement construct in z/OS MVS JCL Reference. For an example, see Using conditional processing in your DFHDPLOY script.