TCP Interface Messages

The following table describes the messages that pertain to the Substation ES TCP Interface.

Code Description
SXB2000I IId:Intf-Id Connect to TCP host-name:port Starting
Explanation: This message appears at initialization time when the application is connecting to a TCP listener. host-name is the LPAR name, and port is the port you specified in the TCP interface parameters.

User Response: This is a mandatory message to show TCP startup.

System Response: None.

Destination: Log and trace files.

SXB2001I IId:Intf-Id Connect to TCP host-name:port Complete
Explanation: This message appears at initialization time when the application has successfully connected to a TCP listener. host-name is the LPAR name, and port is the port you specified in the TCP interface parameters.

User Response: This is a mandatory message to ensure that TCP is connected.

System Response: External applications or WebUI can now communicate with Substation.

Destination: Log and trace files.

SXB2001E IId:Intf-Id Connect to host-name:port Failed Rsn:RSN
Explanation: This message appears at initialization time when the application connection has failed. host-name is the LPAR name, and port is the port you specified in the TCP interface parameters.

Possible reason codes are as follows:

  • 10 (RSN_NAME_RESOLUTION_ERROR)

    Invalid URL

  • 14 (RSN_SERVER_FAILED)

    Configuration error

    Failure to set the stack name

    TCP service already initialized

    Failure to open log file

  • 15 (RSN_SOCKET_ERROR)

    Internal (socket error)

  • 18 (RSN_GSK_ERROR)

    TLS-related error

  • 909

    When the port number is in use by another running Substation

    URL with an incorrect host name or IP Address is used.

  • 970

    When an out of range port number is specified.

  • 975

    When a non-existing LPAR name is specified.

  • 983

    When the S7RSERVR load module is not available.

User Response: Refer to the reason code to possibly diagnose and correct this failure.

System Response: Connection is not established.

Destination: Log and trace files.

SXB2050I IId:Intf-Id User user-name from client-name Authenticated
Explanation: This message appears when a remote user has connected to the host system. user-name is the z/OS user ID that is used, and client-name is the client host name where the request originated from.

User Response: None.

Destination: Log and trace files.

SXB2051E IId:Intf-Id Password Decryption Failed RC:RC
Explanation: A service or WebUI has specified an incorrect port number for the same host on which TCP/IP serves multiple connections. Most likey WebUI tried to connect to Substation using an incorrect port. There are two host numbers: 1 is for Substation and 2 is for Mainframe RED.

User Response: Normally this is an incompatibility issue or a system error. Contact TIBCO Support and supply the message associated with this issue.

System Response: Authentication failed.

Destination: Log and connecting application.

SXB2052E IId:Intf-Id Host Validation Failed RC:RC
Explanation: A user authentication request for z/OS sent from a remote application failed. The return code is sent back to the user application.

User Response: Ensure that the user ID and password are valid, and the user ID is active in the z/OS host system.

System Response: Authentication failed.

Destination: Log and connecting application.

SXB2053E IId:Intf-Id Failed to deliver Response. Thd:Thd RC:RC
Explanation: Substation was notified by TCP that a response failed delivery. The thread number from where the response was sent is supplied.

User Response: Contact TIBCO Support and supply the associated log file.

System Response: None.

Destination: Log and trace file.

SXB2055E Incorrect target system reached #number
Explanation: A service or WebUI has specified an incorrect port number for the same host on which TCP/IP serves multiple connections. Most likey WebUI tried to connect to Substation using an incorrect port. There are two host numbers: 1 is for Substation and 2 is for Mainframe RED.

User Response: Ensure that you have the correct port number specified in WebUI or your application calling Substation.

System Response: The connection request is rejected.

Destination: Log and connecting application.

SXB2061E IId:Intf-Id Service Service-Name Type:Type, Invalid eye found

Explanation: An obtain for storage was done but the eye catcher is not recognized. This means the storage is invalid or someone has overridden the storage. The request to obtain the service will fail.

User Response: Contact TIBCO Support and supply the associated log and trace file information.

System Response: The system fails this function only but continues processing.

Destination: TIBLOG and and TIBTRC files.

SXB2110E IId:Intf-Id Function Get_Input Failed Thd:Thd RC:RC

Explanation: Obtaining input data with the tcp tibtcpz_Obtain_Input Function failed.

User Response: Contact TIBCO Support and supply the associated log and trace file.

System Response: The system failed to obtain input and this is deemed a serious issue. The system continues processing and returns to the input handler waiting for the next request.

Destination: TIBLOG and and TIBTRC files.

SXB2111E IId:Intf-Id Function Unmangle Failed Thd:Thd RC:RC

Explanation: The unmangle of a password failed with RC. As a result the credentials can't be verified.

User Response: Contact TIBCO Support and supply the associated log and trace file.

System Response: The system fails to get the real password and this is deemed a serious issue. The system continues processing and returns to the input handler waiting for the next request.

Destination: TIBLOG and and TIBTRC files.

SXB2112E IId:Intf-Id Function Release_Input Failed Thd:Thd RC:RC

Explanation: The release of the input buffer to tcp failed with RC. The result is the user may not see the reply the system sent.

User Response: Contact TIBCO Support and supply the associated log and trace file.

System Response: The system fails on this function and this is deemed a serious issue. The system continues processing and returns to the input handler waiting for the next request.

Destination: TIBLOG and and TIBTRC files.

SXB2113E IId:Intf-Id Function Send_Receive Failed Thd:Thd RC:RC

Explanation: The internal function of sending data to tcp and then going into a receive failed with RC. The result is the user may not see the reply the system sent.

User Response: Contact TIBCO Support and supply the associated log and trace file.

System Response: The system fails on this function and this is deemed a serious issue. The system continues processing and returns to the input handler waiting for the next request.

Destination: TIBLOG and and TIBTRC files.

SXB2114E IId:Intf-Id Function Send Failed Thd:Thd RC:RC

Explanation: The sending of data to tcp failed with RC. The result is the user may not see the reply the system sent.

User Response: Contact TIBCO Support and supply the associated log and trace file.

System Response: The system fails on this function and this is deemed a serious issue. The system continues processing and returns to the input handler waiting for the next request.

Destination: TIBLOG and and TIBTRC files.

SXB3480E Input threads failed to start

Explanation: A Substation ES TCP Interface that is required to start input threads has failed. This is normally a Substation ES internal error caused by start the TCP CallBack threads failed.

User Response: Review the error condition together with other messages in the log. Contact TIBCO Support with the information on the error from the log and trace files.