Handling failed coupling facility structures

To determine which structures remain allocated on the failed CF, issue the D XCF,CF,CFNAME=failed_cfname command.

To delete the allocated structures do the following for each structure in the failed CF:

Display structure information using the D XCF,STR,STRNM=strname command.

The structure might have failed-persistent connections, or the structure itself might be persistent, or both.

Deleting failed-persistent connections
Delete all failed-persistent connections with the following system command
```
SETXCF FORCE,CONNECTION,STRNAME=strname,CONNAME=ALL
```
Because the z/OS® system does not have connectivity to the failed CF, the preceding command will be accepted with the following message:
```
IXC354I THE SETXCF FORCE REQUEST FOR CONNECTION
conname IN STRUCTURE strname WAS ACCEPTED:
REQUEST WILL BE PROCESSED ASYNCHRONOUSLY
```
Display the structure again: DISPLAY XCF,STRUCTURE,STRNAME=strname

The number of connections to the structure should now be zero.
Deleting persistent structures
If the structure is persistent (DISPOSITION: KEEP in IXC360I) and the number of connections to the structure in message IXC360I is greater than zero, then delete the structure as described below.

If ACTIVE connectors exist (see connection state in IXC360I), invoke recovery procedures for the connector, or CANCEL the connector's address space to make the connector disconnect from the structure. Then, if the connector enters a failed-persistent state, force the connector using the SETXCF FORCE,CON.

Then, to delete the structure, issue the following system command: SETXCF FORCE,STRUCTURE,STRNAME=strname
Because the z/OS system does not have connectivity to the failed CF, the preceding command will be accepted with the following message:
```
IXC353I THE SETXCF FORCE REQUEST FOR STRUCTURE
strname WAS ACCEPTED:
REQUEST WILL BE PROCESSED ASYNCHRONOUSLY
```
Once all failed-persistent connections are forced or the structure is forced, the structure should enter an “in transition” state or "delete pending" state. If you display the structure again, message IXC360I should contain the following statements:
```
STRUCTURE IN TRANSITION
-----------------------
REASON IN TRANSITION: CONNECT OR DISCONNECT IN PROGRESS
```
When the structure enters an in transition state, it means that the structure is targeted for deletion by CFRM. At this point, a new instance of the structure can be allocated. Depending on the application that owns the structure, the application might need to be restarted to allocate a new structure.

Note: When the structure is allocated in an alternate CF, the DISPLAY XCF,STR,STRNAME=strname command will produce information about both the new instance of the structure in the alternate CF and the structure in transition which is pending deletion from the failed CF. When the failed CF is eventually restored, XCF will resolve the structure in transition condition and this information will no longer be displayed.