Similar to defining members to XCF, disassociating members from
XCF is a process that requires some planning. Once a member is defined
to XCF and is in a
created or
active state, there are a number of ways that it can become disassociated
from XCF. For each member, you have the following choices:
- Do a controlled stop by placing an active member in the quiesced
state through IXCQUIES, and then, at a later time, in the not-defined
state through IXCDELET. (A member must have permanent status recording
to choose this option.) Placing the member in a quiesced state disassociates
the member from XCF services (cannot send and receive messages, cannot
be monitored, etc.) but the member is still known to XCF. Placing
the member in the not-defined state then disassociates the member
completely from XCF.
- Immediately place an active member in the not-defined state through
the IXCLEAVE macro. (Permanent status recording is not required for
this option.)
- Place a created member in the not-defined state through the IXCDELET
macro.
- Allow an active member with permanent status recording to terminate
without explicitly disassociating from XCF, causing the member to
be placed in the failed state. Then disassociate the member from XCF
through the IXCDELET macro. Any event causing termination, either
normal or abnormal, will cause an active member with permanent status
recording to be placed in the failed state.
- Force an active member to stop using XCF services by issuing the
IXCTERM macro. The member's recovery routine then gets control and
decides the member's final state. You can use IXCTERM for a member
with or without permanent status recording.
The topic entitled The Five Member States provided information you
need regarding the quiesced, failed, and not-defined member states
to determine how you should disassociate each member from XCF. The
information in this topic tells you how to use the IXCQUIES,
IXCLEAVE, IXCDELET, and IXCTERM macros to achieve the desired results.
Also included in this topic is information on providing recovery
when a member does not explicitly disassociate from XCF.