z/OS MVS Setting Up a Sysplex
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Handling failed coupling facility structures

z/OS MVS Setting Up a Sysplex
SA23-1399-00

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.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014