z/OS MVS Programming: Sysplex Services Guide
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Designing Your Application to Use Automatic Restart Management Services

z/OS MVS Programming: Sysplex Services Guide
SA23-1400-00

The IXCARM macro may be used in several ways. The simplest way is to register a job, task, or abstract resource with the automatic restart manager during program initialization, let automatic restart management know when the job or task is ready to perform its work, and deregister when the program does its cleanup (REGISTER, READY, and DEREGISTER parameters).

A more complex use of the IXCARM macro involves controlling the sequence in which elements become ready during a restart (WAITPRED parameter — see Waiting for Other Work to be Restarted (IXCARM REQUEST=WAITPRED)). Another use of the IXCARM macro involves designating a backup for an element (ASSOCIATE parameter — see Associating One Element with Another (IXCARM REQUEST=ASSOCIATE)).

When automatic restart management restarts an element, it restarts the element from the very beginning of its code. Automatic restart management does not perform any kind of cleanup processing or recovery for elements. The event exit (see Designing an Event Exit), the element restart installation exit, and the workload restart installation exit have been provided to allow the element's environment to be cleaned up, recovered, and prepared for restart processing. The element can also perform some cleanup before or after it re-registers.

When an element has been restarted, it will receive a return code X'4' with a reason code of X'104' or X'108' when it re-registers with automatic restart management. This indicates that the element has been restarted and the program can do cleanup processing before continuing. Types of cleanup can be:
  • To purge any partial output (depending on the type of output data set used).
  • To determine the effect of using replication symbols in any dynamic allocations that may be done. Started tasks use the symbols from the system the program initially registered on before and after the re-registration. Batch jobs use the symbols from the system the program initially registered on after the re-registration; the local system's table is used before the re-registration for batch jobs.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014