ON FAILURE

ON FAILURE tells BMC AMI Unload how you want to handle an abnormal termination (when your job ends with a return code that is greater than or equal to 8, or abends).


Related topics

BMC AMI Unload option descriptions
BMC-AMI-Unload-Option-descriptions

UNLOAD syntax diagrams

SYSREC

DELETEFILES 


The default for this option is ON FAILURE ALL TERMINATE UTILITY. In this case, if BMC AMI Unload encounters a failure in any phase, the job terminates with the highest assigned return code.

TERMINATE UTILITY

When TERMINATE UTILITY is in effect for an abend that occurs during any or all of the UTILINIT, UNLOAD, or UTILTERM phases, BMC AMI Unload completes the following tasks:

  • Deletes the row that contains the utility ID from the BMCUTIL and BMCSYNC tables
  • Issues the normal return code

  • Deletes the SYSREC and SORTWK files if you have specified DELETEFILES YES

    Important

    If you are running the unload job in a worklist environment, BMC AMI Unload deletes only dynamically allocated SYSREC data sets.

Multiple statements

When you specify multiple ON FAILURE statements, BMC AMI Unload functions as follows:

  • For competing ON FAILURE statements, BMC AMI Unload honors the last statement.
  • When a phase-specific ON FAILURE statement follows an ON FAILURE ALL statement, BMC AMI Unload honors the phase-specific statement for that phase and the ON FAILURE ALL statement for remaining phases.

 

  • 13.1
Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*