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


Deregistering the Element (IXCARM REQUEST=DEREGISTER)

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

When an element no longer requires automatic restarts as part of its recovery environment (usually during the program's cleanup processing), the element should issue the IXCARM macro with the REQUEST=DEREGISTER parameter.

If the element was associated with another element (IXCARM REQUEST= ASSOCIATE was issued), the system will disassociate the element as part of the DEREGISTER request. For more information on associating elements, see Associating One Element with Another (IXCARM REQUEST=ASSOCIATE).

An application that has registered with ELEMBIND=CURSYS must specify the restart manager token that either was returned on the REGISTER request when issuing the IXCARM REQUEST=DEREGISTER request or through IXCQUERY REQINFO=ARMSTATUS. Optionally, an application that has registered with ELEMBIND=CURJOB can specify the restart manager token as input to the DEREGISTER request. These requests can be issued from the master address space or from the address space where the element was registered. The contents of the restart manager token must not have been modified.

Programs should be aware that an element might be deregistered by the SETXCF FORCE,ARMDEREGISTER operator command or automatically by MVS™ when various error conditions occur. An ENF signal is issued whenever an element is deregistered, so any unexpected situations could be handled through an ENF listener user routine (see Monitoring Restarts through the ENFREQ Macro for more information).

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014