> IMS User Guide > Error and Reason Codes

IMS User Guide

     Previous  Next    Open TOC in new window  Open Index in new window  View as PDF - New Window  Get Adobe Reader - New Window
Content starts here

Error and Reason Codes

The Oracle Tuxedo Mainframe Adapter for TCP (IMS) (hereafter referenced as TMA TCP for IMS) client response message header contains error and reason codes used to return error information to an IMS client. When an error occurs while processing an IMS client request, the error code is set to a unique, nonzero value that indicates the type of error that occurred. Depending on the particular error, the reason code may also contain a value that provides additional information about the error.

Error Code (Decimal Values)
Description
0
Normal Return
The request completed successfully (no errors occurred).
4
Response Data Truncated
The user response data was truncated because it exceeded the maximum response length specified in the request. When this error occurs, the user response data is truncated to the maximum response length specified, but the actual length of the user response data (before truncation) is returned in the data length field.
8
Remote System Unavailable
The TMA TCP for IMS gateway cannot establish a session with the remote gateway required to service the request.
12
Remote System Busy
All existing sessions with the required remote gateway are busy and TMA TCP for IMS cannot establish a new session (due to session limits).
16
Request Timed Out
A required response was not received from the remote host within the specified time limit. This may indicate a connectivity problem or a problem with the remote system.
20
Service Not Defined
The requested service name is not defined to TMA TCP for IMS. This error can also occur if the requested service name is currently out of service.
24
Internal Error
An internal error occurred and TMA TCP for IMS could not allocate storage required to process the request.
28
Invalid Request
An error was detected while validating the request. When this error occurs, the reason code indicates the specific reason for the error.
0=No additional information is available for this error.
4=The request header length is not valid.
8=The combined header length, context length, and data length exceed the length of the request message (LL).
12=The specified request type is not valid.
16=A response transaction is not specified (that is, the response transaction field is spaces or binary zero).
20=The context length is not valid. The length of user context data cannot be greater than 32,767 bytes.
24=The data length is not valid. The length of user request data cannot be greater than 32,767 bytes.
28=The maximum response length is not valid. The maximum length of user response data cannot be greater than 32,767 bytes.
32=A service name is not specified (that is, the service name field is spaces or binary zero).
36=The requested service name is not defined to TMA TCP for IMS.
32
Remote System Error
An error was detected by the remote gateway. When this error occurs, the reason code contains the gateway error code returned by the remote system.
36
Remote Service Error
An error indication (TPERROR) was returned by the remote service. When this error occurs, the reason code contains the TPERRNO value returned by the remote service.
40
Internal Logic Error
An internal logic error was detected by TMA TCP for IMS. If this error occurs, notify the systems programmer responsible for TMA TCP for IMS.
44
Service Not Available
The remote service is currently unavailable.
48
Service Failed
The remote service returned a TPFAIL return code.
52
Security Error
The user is not authorized to execute the remote service.


  Back to Top       Previous  Next