Table of Contents Previous Next PDF


Error and Informational Messages

Error and Informational Messages
All messages issued by Oracle Tuxedo Mainframe Adapter for TCP (IMS) (hereafter referenced as TMA TCP for IMS) have an IBM-standard 8-character message ID beginning with the characters, “BEA”. Messages have the following general format: BEAnnnnt ssss text.
 
Logical Machine IDs
A logical machine ID (LMID) is a symbolic name used to identify a Oracle Tuxedo Mainframe Adapter gateway. LMIDs are defined in the Oracle TMA TCP for IMS configuration file, and appear in selected messages issued by Oracle TMA TCP for IMS.
When used in a message to identify a gateway, the logical machine ID displays as follows:
LMID (logical-machine-id, type)
logical-machine-id
is the logical machine ID (1-16 characters)
type
is the type of gateway: L is the local gateway; R is a remote gateway
Note:
The terms local and remote, as used in this document, are relative to the Oracle TMA TCP for IMS gateway. Local refers to the IMS gateway; remote refers to another Oracle Tuxedo Mainframe Adapter gateway with which the IMS gateway is communicating.
The following are examples of LMIDs used in messages issued by Oracle TMA TCP for IMS:
Messages Returned to the Remote Gateway
Oracle TMA TCP for IMS returns the following messages to a remote gateway in conjunction with positive and negative responses to requests presented by a remote gateway:
These messages may also be recorded in the message log and displayed on the z/OS console. For a complete description of each of these messages, refer to the “Messages Written to the Oracle TMA TCP for IMS Message Log” section that follows.
Messages Written to the Oracle TMA TCP for IMS Message Log
 
jobname BEA TMA vv.rr TCP For IMS has ended - RC = rc
jobname is the z/OS job name assigned to Oracle TMA TCP for IMS.
vv is the product version number.
rr is the product release number.
rc is a return code indicating the reason for termination. The most common return code is 24, indicating that termination occurred in response to a SHUTDOWN request.
jobname BEA TMA vv.rr TCP For IMS starting
jobname is the z/OS job name assigned to Oracle TMA TCP for IMS.
vv is the product version number.
rr is the product release number.
jobname BEA TMA vv.rr TCP For IMS initialization complete
jobname is the z/OS job name assigned to Oracle TMA TCP for IMS.
vv is the product version number.
rr is the product release number.
BEA TMA vv.rr TCP For IMS is terminating (RSN=rc)
vv is the product version number.
rr is the product release number.
rc is a reason code indicating the reason for termination.
Invalid IMS Client Request: description, Error(error-code), Reason(reason-code)
description is a text description of the error detected.
error-code is the error code. For a description of error codes issued by Oracle TMA TCP for IMS, refer to the “Error and Reason Codes” section.
reason-code is the reason code. For a description of reason codes issued by Oracle TMA TCP for IMS, refer to the “Error and Reason Codes” section.
IMS Client Request for Service(service) failed: Requested service not defined
service is the specified service name.
IMS Client Request for Service(service) failed: All outbound sessions busy
service is the specified service name.
service-name is the specified service name.
rc is the return code returned by the GetServiceInfo() function.
Abnormal return from IMS function request - Status = ss
function is the IMS function code: GU (Get Unique) GN (Get Next) CHNG (Change) ISRT (Insert) PURG (Purge) CHKP (Checkpoint).
ss is the status code from the program control block (PCB).
ddname is the DDNAME of the message log dataset.
ssss Inbound Sessions are no longer being accepted by LMID(lmid,L)
ssss is the socket ID assigned to the Listener by TCP/IP.
lmid is the logical machine ID of the local gateway.
Starting Listener for LMID(lmid,L), IP(ip-address), Port(port-number)
lmid is the logical machine ID of the local gateway.
ip-address is the IP address at which TCP/IP connection requests are accepted. If an asterisk (*) appears, connection requests are accepted through any available network interface on the machine.
port-number is the port number at which TCP/IP connection requests are accepted.
ssss LMID(lmid,L) is accepting TCP/IP connection requests at IP(ip-address), Port(port-number)
lmid is the logical machine ID of the local gateway.
ip-address is the IP address at which TCP/IP connection requests are accepted. If an asterisk (*) appears, connection requests are accepted through any available network interface.
port-number is the port number on which TCP/IP connection requests are accepted.
ssss Inbound TCP/IP connection request received for LMID(lmid,L) from IP(ip-address: host-name)
lmid is the logical machine ID of the local gateway receiving the request.
ip-address is the IP address of the remote system making the request.
host-name is the network name of the remote system making the request. TCP/IP obtains this information from a domain name server or from a local /etc/hosts file. If the name of the remote host cannot be determined, "Unknown" is displayed.
ssss Inbound TCP/IP connection request rejected: Session limit (max-sessions) exceeded
ssss is the socket ID assigned to the connection by TCP/IP.
max-sessions is the maximum number of concurrent, active inbound sessions supported by the local gateway.
ssss Unable to allocate Session Control Block for Inbound Session
ssss is the socket ID assigned to the connection by TCP/IP.
ssss Inbound TCP/IP connection accepted by LMID(lmid,L(port)) from R(ip-address:port)
ssss is the socket ID assigned to the connection by TCP/IP.
lmid is the port for logical machine ID of the local gateway accepting the connection.
port is the port for the local gateway accepting the connection.
ip-address:port is the IP address and port for the remote system making the connection.
Requesting outbound TCP/IP connection with LMID(lmid,R) at IP(ip-address), Port(port-number)
lmid is the logical machine ID of the remote gateway.
ip-address is the IP address of the remote gateway.
port-number is the port number of the remote gateway.
ssss Unable to establish TCP/IP connection with LMID(lmid,R)
ssss is the socket ID assigned to the connection by TCP/IP.
lmid is the logical machine ID of the remote gateway.
ssss Received message length (rcvd-length) exceeds maximum allowed on session (max-length)
rcvd-length is the length of the message received.
max-length is the maximum message length allowed on the session.
ssss Message header length (length) is not valid
ssss is the socket ID assigned to the connection by TCP/IP.
length is the length of the message header received.
ssss Message length (length) is not valid
ssss is the socket ID assigned to the connection by TCP/IP.
length is the length of the gateway message received.
ssss IMS Client Request timed out: LMID(lmid,R), Service(service)
ssss is the socket ID assigned to the connection by TCP/IP.
lmid is the logical machine ID of the remote gateway.
service is the remote name of the service requested (i.e., the name of the service as defined on the remote system).
ssss Allocation failed for buffer (size = buffer-size)
ssss is the socket ID assigned to the connection by TCP/IP (this field is blank if there is no associated connection).
buffer-size is the size of the requested buffer.
ssss IMS Server Request failed - Invalid IMS transaction code: Service(service-name)
ssss is the socket ID assigned to the connection by TCP/IP.
service-name is the name of the requested service (i.e., the IMS transaction code for the server transaction).
ssss Shutdown requested by client transaction: Type(type)
ssss is the socket ID assigned to the connection by TCP/IP.
type is the type of shutdown requested: STOP - Normal shutdown DUMP - User 3166 abend with dump
ssss IMS Server Request (size=size) exceeds maximum supported IMS message length (max-length)
ssss is the socket ID assigned to the connection by TCP/IP.
size is the length of the request message received.
max-length is the maximum supported length of an IMS message segment.
Logging IMS Server Response: mmddyyyy.hhmmss.nnnnnn (reason)
mm month (1-12)
dd day (1-31)
yyyy year
hh hour (0-23)
mm minute (0-59)
ss second (0-59)
nnnnnn serial number
reason specifies the reason that the response is being logged.
ssss Invalid or unsupported request received by LMID(lmid,L): Opcode(opcode)
ssss is the socket ID assigned to the connection by TCP/IP.
lmid is theological machine ID of the local gateway receiving the request.
opcode is a numeric value identifying the request type.
Unable to add service service-name, maximum service count reached.
ssss CONNECT request received by LMID(lmid,L)
ssss is the socket ID assigned to the connection by TCP/IP.
lmid is the logical machine ID of the local gateway receiving the request.
ssss CONNECT request accepted by LMID(lmid,L)
ssss is the socket ID assigned to the connection by TCP/IP.
lmid is the logical machine ID of the local gateway receiving the request.
ssss CONNECT request rejected by LMID(lmid,L): Not Authorized
ssss is the socket ID assigned to the connection by TCP/IP.
lmid is the logical machine ID of the local gateway.
ssss SHUTDOWN request received by LMID(lmid,L)
ssss is the socket ID assigned to the connection by TCP/IP.
lmid is the logical machine ID of the local gateway receiving the request.
ssss DISCONNECT request received by LMID(lmid,L)
ssss is the socket ID assigned to the connection by TCP/IP.
lmid is the logical machine ID of the local gateway receiving the request.
ssss DISCONNECT request accepted by LMID(lmid,L)
ssss is the socket ID assigned to the connection by TCP/IP.
lmid is the logical machine ID of the local gateway receiving the request.
Inbound (request/response) for LMID(lmid,L)
lmid is the logical machine ID of the local gateway receiving the request.
ssss PING request received by LMID(lmid,L)
ssss is the socket ID assigned to the connection by TCP/IP.
lmid is the logical machine ID of the local gateway receiving the request.
PING response: jobname BEA TMA vv.rr TCP For IMS
jobname is the z/OS job name assigned to Oracle TMA TCP for IMS.
vv is the product version number.
rr is the product release number.
ssss COMMAND received by LMID(lmid,L)
ssss is the socket ID assigned to the connection by TCP/IP.
lmid is the logical machine ID of the local gateway receiving the request.
ssss Command rejected by LMID(lmid,L): Remote commands are not supported
ssss is the socket ID assigned to the connection by TCP/IP.
lmid is the logical machine ID of the local gateway.
ssss Protocol error detected by LMID(lmid,L) on Inbound Session: Request(request), State(state)
ssss is the socket ID assigned to the connection by TCP/IP.
lmid is the logical machine ID of the local gateway receiving the request.
request is the type of request received: CONNECT, DISCONNECT, etc.
state is a numeric value corresponding to the current state of the session, as viewed by Oracle TMA TCP for IMS.
ssss Invalid or unsupported response received from LMID(lmid,R): Opcode(opcode)
ssss is the socket ID assigned to the connection by TCP/IP.
lmid is the logical machine ID of the remote gateway.
opcode is the numeric value of the Opcode in the Message Header.
ssss Issuing CONNECT request for LMID(lmid,R)
ssss is the socket ID assigned to the connection by TCP/IP.
lmid is the logical machine ID of the remote gateway.
ssss CONNECT request rejected by LMID(lmid,R): GWError(gwerror), GWMsg(gwmsg)
ssss is the socket ID assigned to the connection by TCP/IP.
lmid is the logical machine ID of the remote gateway.
gwerror is the gateway error code returned by the remote gateway.
gwmsg is the gateway error message returned by the remote gateway.
ssss CONNECT request accepted by LMID(lmid,R)
ssss is the socket ID assigned to the connection by TCP/IP.
lmid is the logical machine ID of the remote gateway.
ssss Issuing DISCONNECT for LMID(lmid,R)
ssss is the socket ID assigned to the connection by TCP/IP.
lmid is the logical machine ID of the remote gateway.
ssss DISCONNECT rejected by LMID(lmid,R): GWError(gwerror), GWMsg(gwmsg)
ssss is the socket ID assigned to the connection by TCP/IP.
lmid is the logical machine ID of the remote gateway.
gwerror is the gateway error code returned by the remote gateway.
gwmsg is the gateway error message returned by the remote gateway.
ssss DISCONNECT accepted by LMID(lmid,R)
ssss is the socket ID assigned to the connection by TCP/IP.
lmid is the logical machine ID of the remote gateway.
ssss Sending PING request to LMID(lmid,R)
ssss is the socket ID assigned to the connection by TCP/IP.
lmid is the logical machine ID of the remote gateway.
ssss PING request rejected by LMID(lmid,R): GWError(gwerror), GWMsg(gwmsg)
ssss is the socket ID assigned to the connection by TCP/IP.
lmid is the logical machine ID of the remote gateway.
gwerror is the gateway error code returned by the remote gateway.
gwmsg is the gateway error message returned by the remote gateway.
ssss PING response from LMID(lmid,R): response
ssss is the socket ID assigned to the connection by TCP/IP.
lmid is the logical machine ID of the remote gateway. response is the text of the response message returned by the remote gateway.
ssss Sending command to LMID(lmid,R)
ssss is the socket ID assigned to the connection by TCP/IP.
lmid is the logical machine ID of the remote gateway.
ssss COMMAND rejected by LMID(lmid,R): GWError(gwerror), GWMsg(gwmsg)
ssss is the socket ID assigned to the connection by TCP/IP.
lmid is the logical machine ID of the remote gateway.
gwerror is the gateway error code returned by the remote gateway.
gwmsg is the gateway error message returned by the remote gateway.
ssss Unable to allocate buffer for IMS Client Request (size=buffer-size)
ssss is the socket ID assigned to the connection by TCP/IP.
buffer-size is the size of the required buffer.
ssss IMS Client Request sent to LMID(lmid,R) failed: GWError(gwerror), GWMsg(gwmsg)
ssss is the socket ID assigned to the connection by TCP/IP.
lmid is the logical machine ID of the remote gateway.
gwerror is the gateway error code returned by the remote gateway.
gwmsg is the gateway error message returned by the remote gateway.
ssss State error on inout Session: LMID(lmid,type), Request(request), State(state)
inout session type: inbound or outbound.
lmid is the logical machine ID of the gateway.
type is the gateway type: L (local) or R (remote).
request is the request type: CONNECT, DISCONNECT, etc.
state describes the current state of the session.
ssss TCP/IP connection closed by session partner
ssss is the socket ID assigned to the connection by TCP/IP.
ssss TCP/IP connection reset
ssss is the socket ID assigned to the connection by TCP/IP.
ssss Length error on socket read
ssss is the socket ID assigned to the connection by TCP/IP.
ssss Abnormal return from TCP/IP API request: fcn(function), rc(rc), errno(errno)
ssss is the socket ID assigned to the connection by TCP/IP.
function is the TCP/IP API function called: read, write, etc.
rc is the TCP/IP return code (usually -1).
errno is the TCP/IP errno value returned.
ssss Session termination in progress (RSN=reason)
ssss is the socket ID assigned to the connection by TCP/IP.
reason is a numeric value indicating the reason the session is being terminated. Some typical reason codes are: 12 A socket error occurred.
ssss TCP/IP connection closed
ssss Session termination complete
ssss is the socket ID assigned to the connection by TCP/IP.
ddname is the DDNAME used by Oracle TMA TCP for IMS to open the dataset.
ssss IMS Server Request received with previous request pending (timeout assumed)
ssss is the socket ID assigned to the connection by TCP/IP.
ssss Pending IMS Server Request for Service(service) aborted
ssss is the socket ID assigned to the connection by TCP/IP.
service is the name of the IMS server transaction scheduled to process the current request.
ssss IMS Server Request timed out: Service(service)
ssss is the socket ID assigned to the connection by TCP/IP.
service is the name of the IMS server transaction scheduled to process the request.
sc is the sense code.
reason is a numeric value indicating the reason for the response failure.
text is the line containing the text in error.
Could not find LMID [lmid] for Service [service]
lmid is the logical machine ID specified in the SERVICE TYPE=REMOTE statement.
service is the local service name specified in the SERVICE TYPE=REMOTE statement.
line-no is the line number of the line containing the syntax error.
text is the line containing the text in error.
ddname is the logical dataset name of the configuration file dataset.
jobname BEA TMA vv.rr TCP For IMS ready
jobname is the z/OS job name assigned to Oracle TMA TCP for IMS.
vv is the product version number.
rr is the product release number.
ssss Session TIMEOUT detected on LMID(lmid,type)
ssss is the socket ID assigned to the connection by TCP/IP.
lmid is the logical machine ID of the gateway.
type is the gateway type: L (local) or R (remote).
Service service-name for IMSID logical-IMS-identifier has been added.
service-name is the local service name which is passed to IMS as the transaction name.
logical-IMSID-identifier is a symbolic name that uniquely identifies an IMS system definition. This name must match a logical IMS ID (IMSID) specified in a HOST, TYPE=IMS statement.
IMS Host IMSID has been modified.
IMSID is a symbolic name that uniquely identifies the IMS system definition.
Host address for hostname is IP-address
status is one of the following: ACTIVE, UNKNOWN, ERROR, RESET, or BID SENT
Gateway lmid has been added
lmid is the logical machine ID specified for the ADD GATEWAY command.
Gateway lmid is invalid
lmid is the logical machine ID specified for the MOD command.
Gateway lmid has been modified
lmid is the logical machine ID specified for the MOD GATEWAY command.
Gateway lmid has been started
lmid is the logical machine ID specified for the START GATEWAY command.
Gateway lmid is being stopped
lmid is the logical machine ID specified for the STOP GATEWAY command.
Gateway lmid has been stopped
lmid is the logical machine ID specified for the STOP GATEWAY command.
Service service-name for LMID lmid has been added
service is the local service name specified in the SERVICE TYPE=REMOTE statement.
lmid is the logical machine ID specified for the ADD SERVICE command.
Service service-name for LMID lmid is invalid
service is the local service name specified in the SERVICE TYPE=REMOTE statement.
lmid is the logical machine ID specified for the MOD SERVICE command.
Service service-name for LMID lmid has been modified
service is the local service name specified in the SERVICE TYPE=REMOTE statement.
lmid is the logical machine ID specified for the MOD SERVICE command.
Security Violation: Tran=tran-id, UserID=userid, GroupID=groupid, TermID=terminalid
XCF Send Failed Ret=return-code Rsn=reason-code
Message rejected by LMID(lmid,L) on Inbound Session - Gateway Stopped
lmid is the logical machine ID specified for the MOD SERVICE command.
Service service-name for LMID lmid has been started
service-name is the name of the requested service (i.e., the IMS transaction code for the server transaction).
lmid is the logical machine ID specified for the gateway.
Service service-name for LMID lmid is being stopped
service-name is the name of the requested service (i.e., the IMS transaction code for the server transaction).
lmid is the logical machine ID specified for the gateway.
Service service-name for LMID lmid has been stopped
service-name is the name of the requested service (i.e., the IMS transaction code for the server transaction).
lmid is the logical machine ID specified for the gateway.
Requested: n, Available: n
IMS Server Request for Service(service-name) failed: Requested Service not defined
IMS Server Request for Service (service-name) failed:Requested Service not available
IMS Server Request for Service (service-name) failed: Buffer Size Error