Description

The IXCTERM macro terminates an active member (called the target member) of a cross-system coupling facility (XCF) group.

The target member is terminated in accordance with the TERMLEVEL value specified when that member invoked IXCJOIN to become an active member of the group.

For TERMLEVEL=MEMASSOC, the system abnormally ends the associated task, which is either the task that issued the IXCJOIN causing the target member to become active, or the jobstep task that was current at the time the IXCJOIN was issued. Which type of task the member is associated with is specified by the MEMASSOC parameter on the IXCJOIN.
Note: The IXCTERM request is rejected with return code X'8', reason code X'120' if the target member is associated with an address space (MEMASSOC=ADDRSPACE).
For TERMLEVEL=ADDRSPACE, the address space associated with the member will be terminated and every XCF group member associated with that space (which could include other groups) will be terminated.
For TERMLEVEL=SYSTEM, the system on which the target member resides will be removed from the sysplex.

The system that performs the termination is always the system on which the target member resides. If termination of the member is to be performed by a system that is still being initialized (running during NIP), the system will be removed from the sysplex.

The abnormal end might cause other members who were associated with the same task, address space, or system as the target member to terminate. XCF does not allow the recovery routines for that task to retry. Use the IXCTERM macro to remove from the XCF group another active member of the same group. The actual termination of the target member occurs asynchronously.

After the target member terminates, XCF notifies the remaining members in the group that have defined a group user-routine that the member is no longer associated with the group. The target member's recovery routine determines the new state of the target member: quiesced, failed, or not-defined.