IXC253I
{PRIMARY|ALTERNATE} COUPLE DATA SET dsname FOR typename IS BEING REMOVED BECAUSE OF errortype DETECTED BY SYSTEM sysname [ERROR CASE: errorcase] [DATA SET TAKEN OVER BY SYSTEM stealsys AT stealtime]

Explanation

A couple data set failed. XCF is removing it from the sysplex.

Each system affected by the failure of the couple data set issues IXC253I to report its removal. The system detecting the error may also issue the ERROR CASE line(s) to provide additional detail about the failure.

In the message text:
PRIMARY
XCF is removing the primary couple data set from the sysplex.
ALTERNATE
XCF is removing the alternate couple data set from the sysplex.
dsname
The name of the couple data set that XCF is removing from the sysplex.
typename
The type of data contained in the data set.
errortype
One of the following:
AN UNKNOWN ERROR
An error that cannot be determined.
AN I/O ERROR
I/O error on the couple data set.
INCONSISTENT INFORMATION
Inconsistent information in the couple data set.
A SETXCF COUPLE,PSWITCH OPERATOR COMMAND
Initiated by operator command SETXCF,COUPLE with the PSWITCH option.
A SETXCF COUPLE,ACOUPLE OPERATOR COMMAND
Initiated by operator command SETXCF,COUPLE with the ACOUPLE option.
sysname
The name of the system that initiated the request or detected the error.
errorcase
One of the following:
PERMANENT ERROR
An I/O operation has failed with a permanent I/O error.
UNRESOLVED I/O TIMEOUT
Attempts to initiate I/O have timed out repeatedly, and the system has been unable to complete an I/O request within the 5 minute retry period.
TAKEOVER BY ANOTHER SYSPLEX
Another sysplex has taken ownership of the couple data set because the operator incorrectly replied 'U' to IXC248E / IXC247D while the couple data set was still in use by the sysplex of which the issuing system is a member.
UNABLE TO IDENTIFY WRITING SYSTEM
The system that left the couple data set partially written did not record its identity before beginning the write. The writing system may not have the partial write recovery support introduced by APAR OW51741 or z/OS® V1R5.
WRITING SYSTEM NO LONGER ACTIVE
The system that left the couple data set partially written was partitioned from the sysplex before it could complete the repair of the affected record.
TIME LIMIT FOR REPAIR EXPIRED
The maximum time limit for repair of a partially written record has elapsed.
stealsys
The name of the system from which the operator replied to IXC247D to allow ownership of the couple data set to be taken over.
stealtime
The date/time when ownership of the couple data set was taken over, in the format mm/dd/yyyy hh:mm:ss.ffffff.

System action

The system stops using the couple data set.

If the failing couple data set was the primary, XCF tries to switch to the alternate couple data set. Any work in progress will be restarted once the switch is made. If no alternate couple data set is available, the function associated with this couple data set type becomes unavailable. If the affected couple data set is sysplex or CFRM, XCF removes the issuing system from the sysplex.

If the failing couple data set was the alternate, the alternate becomes unusable. XCF informs all other systems in the sysplex of the failure.

Operator response

If the reason for the couple data set removal was:
  • AN I/O ERROR with error case PERMANENT ERROR
  • INCONSISTENT INFORMATION

then dump the couple data set. See the operator response to message IXC220W for the correct JCL to dump the couple data set. Otherwise, notify the system programmer.

System programmer response

Allocate and format a new alternate couple data set. Ask the operator to enter the SETXCF COUPLE,ACOUPLE command to make the new alternate couple data set available to XCF. The command should only be entered on one system in the sysplex.

Source

Cross System Coupling Facility (SCXCF)

Module

IXCL1SWT, IXCL1IOC, IXCL1IOR, IXCL1SIO, IXCO1ASY

Routing code

1,2,10

Descriptor code

4