DFS3175E AN MSC CSLSCMSG REQUEST FAILED, active_process, RETCODE = rc, RSNCODE = rsn, LOSTSESS = cause, MODULE =m , LINK = nnn , linkname

Explanation

SCI returned a non-zero return code or reason code to MSC in response to a CSLSCMSG request for services for an MSC logical link that is assigned to a TCP/IP physical link. The logical link is shut down.

In the message text:
active_process
The MSC process that was active when the error occurred. Possible values include:
RESTART
When SCI encountered the error, MSC was attempting to notify IMS Connect and the remote IMS system of the restart of the logical link identified in the message text.
SENDMSG
When SCI encountered the error, MSC was attempting to send an MSC message to a remote IMS system by way of the logical link identified in the message text.
SHUTDOWN
When SCI encountered the error, MSC was attempting to notify IMS Connect and the remote IMS system that the logical link was shutting down.
UNKNOWN
Displayed when the error occurred during an unidentifiable MSC process. The troubleshooting and recovery procedure is the same as for the regular active process types.
cause
The cause of a lost session, as reported either by SCI through the CSL SCI Notify Client exit routine or by IMS.

The possible values include:

FORCESTO
A /PSTOP LINK FORCE or UPDATE MSLINK STOP(COMM) OPTION(FORCE) command was issued by the operator.
ICONABE
The local IMS Connect instance terminated unexpectedly.
ICONSTOP
The local IMS Connect instance was shut down.
NONE
Neither IMS nor the CSL SCI Notify Client exit routine recorded a cause for the lost session.
SCIABE
The SCI instance that is managing communications between IMS and the local IMS Connect instance terminated unexpectedly.
SCISTOP
The SCI instance that is managing communications between IMS and the local IMS Connect instance was shut down.
linkname
The name of the affected MSC logical link.
nnn
The number of the affected MSC logical link.
rc
The CSLSCMSG return code issued by SCI.
rsn
The CSLSCMSG reason code issued by SCI.
Possible cause: The cause of this message is identified by the SCI return and reason codes and possibly by the value that is displayed in the LOSTSESS field in the message text.

System action

The MSC link session is terminated. IMS logs 6701-MSS1, MSS2, and MSS3 records.

Depending on the status of the connection to the remote IMS system, IMS might attempt to notify the remote IMS system. If notification is successful, the remote IMS system terminates the logical link, places the link in the PSTOPPED IDLE ERE state, and issues message DFS2169I DISCONNECTION COMPLETED ON LINK xxx at the remote site.

If the notification is not successful and the link remains in an IDLE ACTIVE state at the remote site, a /PSTOP LINK xxx FORCE or UPDATE MSLINK NAME(linkname) STOP(COMM) OPTION(FORCE) might need to be issued to terminate the link.

Even if the notification to the remote system is not successful, the notification to the local IMS Connect might succeed, in which case the local IMS Connect cleans up the associated sockets.

System programmer response

If the remote IMS system was not notified of the termination of the logical link, someone at the remote site might need to issue a /PSTOP LINK x FORCE or UPDATE MSLINK NAME(linkname) STOP(COMM) OPTION(FORCE).

Determine the cause of the error from the RETCODE, RSNCODE, and LOSTSESS values. The problem could be in either the local or remote IMSplex network. Look up the return and reason codes for the CSLSCMSG request. Check for other messages from SCI, IMS Connect, or TCP/IP that might help with the diagnosis. Collect the X'6701' error records from the IMS log.

After the cause of the error is corrected, restart the link.

Module

Module Description
DFSTCER0 DFSxxxx message interface
DFSTCPE0 Execute CSLSCMSG request
DFSTCP20 Receive Post handler
DFSTCRC0 Validate post codes
DFSTC1A0 Send output controller
DFSTC1B0 Send output buffer setup
DFSTC2A0 Process send completion
DFSTC3A0 Receive input controller
DFSTC4A0 Process receive completion
DFSTC7A0 Restart and shutdown router
DFSTC7B0 Restart processor
DFSTC7C0 Shutdown processor
DFSTC7D0 Shutdown cleanup
DFSCMSG0 Bandwidth output edit
DFSCMSP0 Bandwidth input error message processor
DFSCMSR0 Bandwidth response message builder
DFSCMSU0 Bandwidth output buffer header builder
DFSCMSX0 Bandwidth response message builder
DFSCMSZ0 Bandwidth input message processor
DFSCMS00 MSC analyzer