Description

The IXLFORCE service is intended only for use as a cleanup utility; therefore, you do not need to be connected to a structure to invoke the macro. IXLFORCE allows the requestor to delete:

A persistent structure
A failed-persistent connection to a structure
All failed-persistent connections to a structure
A structure dump
The serialization held on a structure for a structure dump

A persistent structure can be deleted if :

On systems at z/OS® V1R6, or with APAR OA02620 installed, structures with only failed-persistent connections can be deleted. Otherwise, structures with active or failed-persistent connections cannot be deleted.
There are no failed-persistent connections pending reconciliation into the CFRM active policy.
There is no structure dump associated with the structure.

An active connection cannot be deleted. A failed-persistent connection can be deleted only if:

All connectors active at the time the failed-persistent connection terminated have either provided an event exit response acknowledging the termination of the failed-persistent connector, or have themselves been terminated.

While structure rebuild is in progress:

A structure cannot be deleted because a structure that has a status of rebuild in progress must have at least one active connector.
A failed-persistent connection cannot be deleted.

While structure duplexing is in progress, a persistent structure cannot be deleted nor can a failed-persistent connection be deleted except as noted below.

When a persistent structure is in the Duplex Established phase of a duplexing rebuild and a request to stop the duplexing and switch to the new structure is not in progress, the structure can be deleted. Both the old and the new structure are deleted.
When a failed-persistent connection to a structure that is in the Duplex Established phase of duplexing rebuild and a request to stop the duplexing and switch to the new structure is not in progress, the failed-persistent connection can be deleted. Failed-persistent connectors to both instances of the structure will be deleted.

Note that forcing the deletion of a structure or a connection without understanding how the structure is being used may cause loss of data.

The security administrator may have controlled the use of installation structures through the use of RACF® or another security product. If so, ensure that you are authorized to issue the IXLFORCE macro for the structure.

For more information about structure and connection persistence, see z/OS MVS Programming: Sysplex Services Guide.