DFHIS1011 date time applid Unable to acquire IPCONN ipconn. An {EXCEPTION | DISASTER | INVALID | KERNERROR | PURGED} response to the capability exchange was received, reason={AUTOINSTALL_FAILED | INVALID_IPCONN_STATE | INVALID_PARTNER_STATE | IPCONN_NOT_FOUND | ISCE_ERROR | ISCE_INVALID_APPLID | ISCE_TIMED_OUT | ISCE_BAD_RECOV | ISCER_BAD_RESPONSE | ISCER_ERROR | ISCER_HTTP_ERROR | ISCER_TIMED_OUT | SESSION_OPEN_FAILED | SHUTDOWN | TCPIP_CLOSED | TCPIPSERVICE_MISMATCH | TCPIPSERVICE_NOT_FOUND | TCPIPSERVICE_NOT_OPEN | NO_IPCONN | ONE_WAY_IPCONN | CAPEX_RACE | SECURITY_VIOLATION | SEC_SOCKET_ERROR | CLIENT_SOCKET_ERROR | INVALID_HA_TCPIPSERVICE | HA_RESOURCE_MISMATCH | NOT_IPIC_CLASSIFIED}.

Explanation

During processing of an acquire for IPCONN ipconn, module DFHISCO of the IP interconnectivity (IS) domain received an error response to its capability exchange request to the partner CICS. The capability exchange request will have been processed by DFHISCO initialize_connection in the partner system; the reason string corresponds to the error detected by that DFHISCO function in the partner system.

Exception response reasons:

AUTOINSTALL_FAILED

No IPCONN was found to match an incoming IPIC connection and capability exchange and the subsequent autoinstall attempt was disallowed or failed.

INVALID_PARTNER_STATE

A capability exchange request was received for an IPCONN whose state is invalid. The IPCONN must be inservice and not already acquired.

INVALID_IPCONN_STATE

An ISCO ACQUIRE_CONNECTION has been issued for an IPCONN whose state is invalid. The IPCONN must be inservice and released.

IPCONN_NOT_FOUND

An ISCO ACQUIRE_CONNECTION has been issued for an IPCONN which no longer exists.

ISCE_ERROR

The capability exchange request was determined to be invalid and rejected by the partner CICS.

ISCE_INVALID_APPLID

The server_applid, or its high level qualifier, in the capability exchange message does not match the partner CICS's local applid and high level qualifier. If this message is issued by a CICS region in which the associated IPCONN has the attribute HA(YES), the attempt to acquire the IPCONN may have failed because the server region is a previous release that does not support the use of IPCONN attribute HA(YES) for IPIC high availability. In this case the applid is invalid because it cannot be used for an IPIC cluster of server regions which includes a CICS region that does not support IPIC high availablity.

ISCE_TIMED_OUT

The TCPIPSERVICE transaction (CISS by default) has been attached to initialize a connection for an ipconn but it has not received its initial data, the capability exchange request, within the timeout period defined in its transaction profile.

ISCE_BAD_RECOV

A capability exchange request has been received that contains an unsupported isce_preferred_recovery value and no matching isce_supported_protocols flags are set to fallback to.

ISCER_BAD_RESPONSE

The callback capability exchange response contains a bad isco response and reason from the partner CICS.

ISCER_ERROR

The callback capability exchange response was determined to be invalid.

ISCER_HTTP_ERROR

The callback capability exchange response contained a bad http status code.

ISCER_TIMED_OUT

DFHISCO acquire_connection has not received a response to its capability exchange request within the timeout period specified.

SESSION_OPEN_FAILED

While acquiring an ipconn, DFHISCO has failed to open a web session to the partner host defined in the ipconn.

SHUTDOWN

A call has been made to DFHISCO to acquire or initialize an ipconn but CICS has been shutdown before the function completed.

TCPIP_CLOSED

DFHISCO acquire_connection has been called for an ipconn but tcpip is closed.

TCPIPSERVICE_MISMATCH

A capability exchange request was received for an IPCONN which is defined as using a different tcpipservice from that used for the capability exchange.

TCPIPSERVICE_NOT_FOUND

Either acquire_connection has been called for an ipconn but the tcpipservice named in the ipconn is not installed or release_connection has been called for a tcpipservice that is no longer installed.

TCPIPSERVICE_NOT_OPEN

DFHISCO acquire_connection has been called for an ipconn but the tcpipservice named in the ipconn is not open.

NO_IPCONN

DFHISCO acquire or release_connection has been called for a tcpipservice that has no ipconn referencing it.

ONE_WAY_IPCONN

The caller requires a two-way connection but the partner IPCONN is defined as one-way.

CAPEX_RACE

Acquire has been initiated from both sides of an IPCONN connection simultaneously. The acquire from this system is abnormally terminated. The acquire from the partner system will proceed because the partner has an alphabetically lower fully qualified APPLID than this system.

SEC_SOCKET_ERROR

An error occurred while a secondary socket was being obtained.

SECURITY_VIOLATION

The security credentials of the caller are not acceptable to the partner system.

CLIENT_SOCKET_ERROR

A client socket error has occurred.

INVALID_HA_TCPIPSERVICE

During an attempt to acquire a connection for high availability, a TCPIPSERVICE was found to have an invalid value for an attribute. For more information refer to messages produced in the job output by the other CICS system.

HA_RESOURCE_MISMATCH

A resource definition in the server region was found to be incorrect during an attempt to acquire a connection for high availability. An example of this is an incorrect value of IPCONN attribute HA in the server region.

NOT_IPIC_CLASSIFIED

An error has been detected that is not an IPIC classified error.

System action

An exception trace is written by IS domain in both systems and the task in progress is abended.

User response

Examine the resource definitions, message log, and trace if necessary, in both CICS systems. Possible problem causes include:

  • A mismatch between the definitions of the IPCONNs in the two CICS systems

  • The IPCONN in the partner CICS is not in the correct state to process an incoming connection request

  • A processing error in the partner CICS system

  • A mismatch between a definition of an IPCONN in one system and a definition of a TCPIPSERVICE in its partner system

Correct the problem and reissue SET IPCONN ACQUIRED if necessary.

Module

DFHISCO

XMEOUT parameters/Message inserts

  1. date
  2. time
  3. applid
  4. ipconn
  5. Value chosen from the following options:
  6. Value chosen from the following options:

Destination

CISO