BEA eLink TCP for IMS 3.1   Information Center     

        HOME   |   SEARCH   |   CONTACT   |   PDF FILES |   WHAT'S NEW 
 
        TABLE OF CONTENTS   |   PREVIOUS TOPIC   |   NEXT TOPIC   |   GLOSSARY  |   INDEX  

Error and Informational Messages

All messages issued by BEA eLink for Mainframe TCP for IMS (hereafter referenced as eLink 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.

Message Part Description

nnnn

A unique message number in the range 2000 - 2500.

t

The message type:

I=Informational
E=Error
W=Warning

ssss

The socket number identifying the TCP/IP connection with which the message is associated. If the message is not associated with a specific TCP/IP connection, this field is blank.

text

The actual text of the message.


Logical Machine IDs

A logical machine ID (LMID) is a symbolic name used to identify a BEA eLink gateway. LMIDs are defined in the BEA eLink TCP for IMS configuration file, and appear in selected messages issued by BEA eLink 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 logical machine IDs are defined in the configuration file for BEA eLink TCP for IMS.

The terms local and remote, as used in this document, are relative to the BEA eLink TCP for IMS gateway. Local refers to the IMS gateway; remote refers to another BEA eLink gateway with which the IMS gateway is communicating.

The following are examples of LMIDs used in messages issued by BEA eLink TCP for IMS:


Messages Returned to the Remote Gateway

BEA eLink 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 OS/390 console. For a complete description of each of these messages, refer to the "Messages Written to the BEA eLink TCP for IMS Message Log" section that follows.


Messages Written to the BEA eLink TCP for IMS Message Log

BEA2000I

jobname BEA Connect TCP For IMS (vv.rr) has ended - RC = rc

Description:

This message is issued during termination just before BEA eLink TCP for IMS returns to OS/390.

jobname is the OS/390 job name assigned to BEA eLink 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.

Response:

BEA eLink TCP for IMS normally terminates in response to a SHUTDOWN request, in which case the return code is 24 and no special response is required.

If BEA eLink TCP for IMS terminates with a return code other than 24, termination is the result of an abnormal condition. In that case, there should be other messages that provide additional information about the reason for the termination.

BEA2001I

jobname BEA Connect TCP For IMS (vv.rr) starting

Description:

This message is issued when BEA eLink TCP for IMS begins execution.

jobname is the OS/390 job name assigned to BEA eLink TCP for IMS.

vv is the product version number.

rr is the product release number.

Response:

None required.

BEA2002I

jobname BEA Connect TCP For IMS (vv.rr) initialization complete

Description:

This message is issued when BEA eLink TCP for IMS has successfully completed initialization and is ready to begin normal processing.

jobname is the OS/390 job name assigned to BEA eLink TCP for IMS.

vv is the product version number.

rr is the product release number.

Response:

None required.

BEA2003I

BEA Connect TCP For IMS (vv.rr) is terminating (RSN=rc)

Description:

This message is issued when BEA eLink TCP for IMS begins the termination process (for example, in response to an operator SHUTDOWN command).

vv is the product version number.

rr is the product release number.

rc is a reason code indicating the reason for termination.

Response:

BEA eLink TCP for IMS normally terminates in response to a SHUTDOWN request, in which case the return code is 24 and no special response is required.

If BEA eLink TCP for IMS terminates with a return code other than 24, termination is the result of an abnormal condition. In that case, there should be other messages that provide additional information about the reason for the termination.

BEA2004E

Invalid IMS Client Request: description, Error(error-code), Reason(reason-code)

Description:

An IMS client transaction has issued a request that is invalid.

description is a text description of the error detected.

error-code is the error code. For a description of error codes issued by BEA eLink TCP for IMS, refer to "Error and Reason Codes."

reason-code is the reason code. For a description of reason codes issued by BEA eLink TCP for IMS, refer to "Error and Reason Codes."

Response:

Identify and correct the indicated problem.

BEA2005E

IMS Client Request for Service(service) failed: Requested service not defined

Description:

The requested service is not defined to BEA eLink TCP for IMS.

service is the specified service name.

Response:

The specified service is not defined in the BEA eLink TCP for IMS configuration file. Ensure that the correct local service name is being specified, and that the service is properly defined in the configuration file with the specified local service name.

BEA2006E

IMS Client Request for Service(service) failed: All outbound sessions busy

Description:

All available outbound sessions with remote systems offering the service are currently in use (and no additional sessions can be started due to session limits).

service is the specified service name.

Response:

Retry the request later. Increase the maximum number of outbound sessions defined for remote systems that offer the specified service.

BEA2007E

Client Request routing error: Service(service-name), RC(rc)

Description:

An internal error occurred while attempting to select a remote system and outbound session to process an IMS client request.

service-name is the specified service name.

rc is the return code returned by the GetServiceInfo() function.

Response:

Report the error to the systems programmer responsible for BEA eLink TCP for IMS.

BEA2008E

Operator command unrecognized - rejected

Description:

An operator command has been entered that is syntactically invalid.

Response:

Correct and re-enter the command.

BEA2009I

Operator request for SHUTDOWN accepted

Description:

BEA eLink TCP for IMS has recognized and accepted an operator request to initiate shutdown processing.

Action:

BEA eLink TCP for IMS begins the process of terminating.

Response:

None required.

BEA2010I

Initializing IMS interface

Description:

This message is issued during initialization to indicate that the interface with IMS (i.e., via the IMS message queue) is being initialized.

Response:

None required.

BEA2011E

Abnormal return from IMS function request - Status = ss

Description:

An IMS API call has returned an abnormal or unexpected status code.

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).

Response:

Identify the type of error and determine the reason for it. For example, the error may be the result of a temporary change in the IMS configuration.

BEA2012E

Open failed for Message Log: DDNAME(ddname)

Description:

BEA eLink TCP for IMS was unable to open the message log.

ddname is the DDNAME of the message log dataset.

Action:

Initialization fails and BEA eLink TCP for IMS terminates.

Response:

Verify that the correct DDNAME is coded in the JCL for BEA eLink TCP for IMS and that the message log dataset has the correct attributes.

BEA2013I

Initializing network (TCP/IP) interface

Description:

This message is issued during initialization to indicate that the TCP/IP network interface is being initialized. This includes starting a Listener session for each local gateway defined in the BEA eLink TCP for IMS configuration file.

Response:

None required.

BEA2014I

Terminating network (TCP/IP) interface

Description:

This message is issued during termination to indicate that the TCP/IP network interface is being terminated. This involves: - terminating active inbound sessions - terminating active outbound sessions - terminating Listener sessions

Response:

None required.

BEA2015I

ssss Inbound Sessions are no longer being accepted by LMID(lmid,L)

Description:

The Listener for the specified logical machine ID is being stopped; inbound TCP/IP connection requests are no longer accepted by this LMID.

ssss is the socket ID assigned to the Listener by TCP/IP.

lmid is the logical machine ID of the local gateway.

Response:

None required.

BEA2016I

Starting Listener for LMID(lmid,L), IP(ip-address), Port(port-number)

Description:

A Listener is being started for the local gateway to accept TCP/IP connection requests from remote systems.

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.

Response:

None required.

BEA2017E

Unable to allocate Session Control Block for Listener

Description:

BEA eLink TCP for IMS was unable to allocate storage for an internal control block used to manage a Listener session.

Response:

This is an abnormal condition indicating a severe storage shortage or corruption of the storage allocation control blocks. It may be necessary to terminate BEA eLink TCP for IMS (preferably with a dump) to identify and correct the problem.

BEA2018I

ssss LMID(lmid,L) is accepting TCP/IP connection requests at IP(ip-address), Port(port-number)

Description:

A Listener was successfully started for a local gateway and is ready to accept inbound TCP/IP connection requests from remote systems.

ssss is the socket ID assigned to the Listener by TCP/IP.

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.

Response:

None required.

BEA2019I

ssss Inbound TCP/IP connection request received for LMID(lmid,L) from IP(ip-address: host-name)

Description:

A TCP/IP connection request was received from a remote system for a local gateway.

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.

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.

Response:

None required.

BEA2020E

ssss Inbound TCP/IP connection request rejected: Session limit (max-sessions) exceeded

Description:

A TCP/IP connection request from a remote system was rejected because the local gateway is already operating at the specified maximum number of concurrent, inbound sessions.

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.

Response:

If necessary, increase the maximum number of inbound sessions for the local gateway (defined by the SESSIONS parameter in the GATEWAY TYPE=LOCAL statement).

BEA2021E

ssss Unable to allocate Session Control Block for Inbound Session

Description:

BEA eLink TCP for IMS was unable to allocate storage for an internal control block used to manage an inbound session.

ssss is the socket ID assigned to the connection by TCP/IP.

Response:

This is an abnormal condition indicating a severe storage shortage or corruption of the storage allocation control blocks. It may be necessary to terminate BEA eLink TCP for IMS (preferably with a dump) to identify and correct the problem.

BEA2022I

ssss Inbound TCP/IP connection accepted by LMID(lmid,L(port)) from R(ip-address:port)

Description:

An inbound TCP/IP connection from a remote system has been accepted by a local gateway.

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.

Response:

None required.

BEA2023I

Requesting outbound TCP/IP connection with LMID(lmid,R) at IP(ip-address), Port(port-number)

Description:

The local gateway is attempting to establish an outbound TCP/IP connection with a remote system.

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.

Response:

None required.

BEA2024I

ssss Unable to establish TCP/IP connection with LMID(lmid,R)

Description:

The local gateway failed to establish an outbound TCP/IP connection with a remote system.

ssss is the socket ID assigned to the connection by TCP/IP.

lmid is the logical machine ID of the remote gateway.

Response:

None required.

BEA2025E

ssss Received message length (rcvd-length) exceeds maximum allowed on session (max-length)

Description:

The local gateway received a gateway message whose length exceeds the maximum allowed for the session.

ssss is the socket ID assigned to the connection by TCP/IP.

rcvd-length is the length of the message received.

max-length is the maximum message length allowed on the session.

Action:

The session is terminated.

Response:

This error can be caused by any of the following:

  1. The configurations of the local and/or remote gateways may be incorrect or inconsistent with respect to the maximum message length allowed. The maximum message length of the local gateway is specified by the MAXMSGLEN parameter on the GATEWAY TYPE=LOCAL statement.

  2. The remote gateway may not be properly configured to connect to an IMS gateway. In particular, the remote gateway may be configured incorrectly to connect to a CICS gateway.

  3. Some other TCP/IP application (i.e., not a BEA eLink gateway) may be attempting to connect to the IP address and port number used by BEA eLink TCP for IMS. Check the configuration and verify that BEA eLink TCP for IMS is not using an IP address and port number which are also being used by another TCP/IP application.

BEA2026E

ssss Message header length (length) is not valid

Description:

The local gateway received a gateway message containing an invalid header length.

ssss is the socket ID assigned to the connection by TCP/IP.

length is the length of the message header received.

Action:

The session is terminated.

Response:

This error may be caused by any of the following:

  1. The versions of the local and remote gateways may be incompatible.

  2. Some other TCP/IP application (i.e., not a BEA eLink gateway) may be attempting to connect to the IP address and port number used by BEA eLink TCP for IMS. Check the configuration and verify that BEA eLink TCP for IMS is not using an IP address and port number which is also being used by another TCP/IP application.

BEA2027E

ssss Message length (length) is not valid

Description:

The local gateway received a gateway message whose overall length is invalid (the total length is less than the length of the message header).

ssss is the socket ID assigned to the connection by TCP/IP.

length is the length of the gateway message received.

Action:

The session is terminated.

Response:

Contact your BEA eLink TCP for IMS system programmer.

BEA2028E

ssss IMS Client Request timed out: LMID(lmid,R), Service(service)

Description:

An IMS client request was sent to a remote system for processing, but no response was received within a specified period of time.

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).

Action:

BEA eLink TCP for IMS aborts the request and schedules the specified IMS response transaction with the appropriate return codes.

Response:

The remote system may be experiencing problems, or may be extremely busy. An adjustment to the time out value may resolve this problem.

BEA2029E

ssss Allocation failed for buffer (size = buffer-size)

Description:

BEA eLink TCP for IMS is unable to allocate a buffer of the specified size for a gateway message.

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.

Action:

The session is terminated.

Response:

Assuming a reasonable buffer size, this is an abnormal condition indicating a severe storage shortage or corruption of the storage allocation control blocks. It may be necessary to terminate BEA eLink TCP for IMS (preferably with a dump) to identify and correct the problem.

BEA2030E

ssss IMS Server Request failed - Invalid IMS transaction code: Service(service-name)

Description:

BEA eLink TCP for IMS received an abnormal return from IMS (PCB Status Code = "A1") while attempting to insert a server request message into the IMS message queue.

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).

Action:

The request fails. This message is also returned to the remote gateway as part of a negative response to the request.

Response:

The requested service name must be the (correct) IMS transaction code for the server transaction that processes the request. Check the remote configuration and verify that a valid IMS transaction name is specified as the remote service name.

BEA2031I

ssss Shutdown requested by client transaction: Type(type)

Description:

A client transaction requested a shutdown of the IMS gateway. Note that this request can be made either by a remote (e.g., BEA TUXEDO) client or an IMS server transaction if CLIENTSHUTDOWN is set to Yes.

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

Action:

BEA eLink TCP for IMS initiates shutdown processing.

Response:

Assuming that this is a valid request, no response is required.

BEA2032E

ssss IMS Server Request (size=size) exceeds maximum supported IMS message length (max-length)

Description:

BEA eLink TCP for IMS received a server request which is too large to be formatted into a single IMS message segment for insertion into the IMS message queue.

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.

Action:

The request fails.

Response:

Server requests are limited by the maximum supported IMS message segment length.

BEA2033E

Logging IMS Server Response: mmddyyyy.hhmmss.nnnnnn (reason)

Description:

BEA eLink TCP for IMS is unable to correlate a response message returned by an IMS server transaction with a pending, active request. Each server request and response message is identified by a timestamp consisting of the date and time that BEA eLink TCP for IMS was started and a unique serial number:

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.

Action:

The response message is logged in the server response log dataset.

Response:

If the reason is "Server Request not found", one of the following occurred:

  1. BEA eLink TCP for IMS was restarted after the server request was sent to IMS but before the response was received. This message may be issued following a restart of BEA eLink TCP for IMS if server requests were in progress at the time BEA eLink TCP for IMS was terminated.

  2. The TCP/IP connection with the remote gateway was lost after the server request was sent to IMS but before the response was received.

  3. A server request timed out and was aborted (either by the local or the remote gateway) before the response was received from IMS.

Response:

If the reason is "No response was expected", it indicates that an IMS server transaction issued a response to a request for which a response was not required. Correct the IMS server transaction. One other possible cause for this error is that BEA eLink TCP for IMS was unable to identify an IMS client request and processed it as if it were an IMS server response. This can happen if an IMS client transaction improperly initializes the BEA Client request header by failing to initialize the BEA-RESERVED1 field (BEA_Reserved1 in the C header file) to binary zero (low values).

BEA2034E

ssss Invalid or unsupported request received by LMID(lmid,L): Opcode(opcode)

Description:

BEA eLink TCP for IMS received a gateway message from a remote gateway containing an invalid or unsupported request type.

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.

Action:

The session is terminated. This message is also sent to the remote gateway as part of a negative response to the request.

Response:

The local and remote gateways may be incompatible (different versions).

BEA2035E

Unable to add service service-name, maximum service count reached.

Description:

The maximum number of dynamically added services has been reached.

Action:

The ADD SERVICE operator command is rejected.

Response:

The service cannot be added dynamically. The BEA eLink TCP for IMS gateway must be stopped and restarted before additional services can be added dynamically.

BEA2036I

ssss CONNECT request received by LMID(lmid,L)

Description:

BEA eLink TCP for IMS received a CONNECT request from a remote gateway. A CONNECT request is issued to establish an inbound session with the local gateway.

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.

Response:

None required.

BEA2037I

ssss CONNECT request accepted by LMID(lmid,L)

Description:

BEA eLink TCP for IMS accepted a CONNECT request from a remote gateway. An inbound session has been established.

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.

Response:

None required.

BEA2038I

Reserved for future use by BEA Connect TCP for IMS.

BEA2039E

ssss CONNECT request rejected by LMID(lmid,L): Not Authorized

Description:

The local gateway rejected a CONNECT request from a remote gateway because the account ID and/or password presented is not correct.

ssss is the socket ID assigned to the connection by TCP/IP.

lmid is the logical machine ID of the local gateway.

Action:

The session is terminated. This message is also returned to the remote gateway as part of a negative response to the CONNECT request.

Response:

Check the respective configurations of the local and remote gateways to verify that they are consistent with respect to account ID and/or password. If the local gateway definition specifies that no account ID and/or password are to be used (by coding an asterisk for the account ID and/or password), the remote gateway must present a blank (i.e., spaces) account ID and/or password.

BEA2040I

ssss SHUTDOWN request received by LMID(lmid,L)

Description:

BEA eLink TCP for IMS received a SHUTDOWN request from a remote gateway.

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.

Action:

BEA eLink TCP for IMS initiates termination processing.

Response:

None required.

BEA2041I

ssss DISCONNECT request received by LMID(lmid,L)

Description:

BEA eLink TCP for IMS received a DISCONNECT request from a remote gateway. A DISCONNECT request may be sent by a remote gateway to logically terminate a session.

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.

Action:

BEA eLink TCP for IMS terminates the inbound session with the remote gateway. Note, however, that the TCP/IP connection is not affected and remains open. The remote gateway may issue a subsequent CONNECT request to establish a new inbound session, or it may close the TCP/IP connection at its option.

Response:

None required.

BEA2042I

ssss DISCONNECT request accepted by LMID(lmid,L)

Description:

BEA eLink TCP for IMS accepted a DISCONNECT request received from a remote gateway.

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.

Action:

This message is also returned to the remote gateway as part of a positive response to the DISCONNECT request.

Response:

None required.

BEA2043I

Inbound (request/response) for LMID(lmid,L)

Description:

A network message was received.

lmid is the logical machine ID of the local gateway receiving the request.

Action:

None.

Response:

None required. This message is used only when MSGLEVEL is set to DEBUG(10).

BEA2044I

ssss PING request received by LMID(lmid,L)

Description:

BEA eLink TCP for IMS received a PING request from a remote gateway. A PING request may be sent by a remote gateway to verify that a logical session exists and that the partner gateway is operative.

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.

Response:

None required.

BEA2045I

PING response: jobname BEA Connect TCP For IMS (vv.rr)

Description:

This message is returned to the remote gateway by BEA eLink TCP for IMS in response to a PING request. This message is not logged.

jobname is the OS/390 job name assigned to BEA eLink TCP for IMS.

vv is the product version number.

rr is the product release number.

Response:

None required.

BEA2046I

ssss COMMAND received by LMID(lmid,L)

Description:

BEA eLink TCP for IMS has received a command from a remote gateway.

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.

Response:

The COMMAND request is not currently supported by BEA eLink TCP for IMS and should not be sent by a remote gateway. (See ID: BEA2047E).

BEA2047E

ssss Command rejected by LMID(lmid,L): Remote commands are not supported

Description:

BEA eLink TCP for IMS does not currently support commands sent by remote gateways.

ssss is the socket ID assigned to the connection by TCP/IP.

lmid is the logical machine ID of the local gateway.

Action:

BEA eLink TCP for IMS ignores the request. This message is also returned to the remote gateway as part of a negative response to the COMMAND request.

Response:

The remote gateway should not be sending commands. Check the configuration and version of the remote gateway to determine why this is occurring.

BEA2048I

Allocating Buffer (size=n)

Description:

An internal storage buffer was allocated.

Action:

None.

Response:

None required. This message is used only when MSGLEVEL is set to DEBUG(10).

BEA2049E

ssss Protocol error detected by LMID(lmid,L) on Inbound Session: Request(request), State(state)

Description:

BEA eLink TCP for IMS received a request from a remote gateway, but the session is currently in a state which is inconsistent with the request.

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 BEA eLink TCP for IMS.

Action:

BEA eLink TCP for IMS takes no specific action. However, subsequent errors (including additional protocol errors) can occur, which likely leads to termination of the session. This message is also returned to the remote gateway as part of a negative response to the request.

Response:

This error can occur if two gateways become "out of sync" on a session with respect to their respective states. If this error occurs frequently or persistently, notify the systems programmer responsible for BEA eLink TCP for IMS.

BEA2050I

IMS Host hostname has been added.

Description:

The ADD HOST operator command has completed successfully.

Action:

None.

Response:

None required.

BEA2051E

ssss Invalid or unsupported response received from LMID(lmid,R): Opcode(opcode)

Description:

BEA eLink TCP for IMS received a response message from a remote gateway on an outbound session that cannot be identified (that is, the Opcode in the BEA eLink message header is not valid).

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.

Action:

The session is terminated.

Response:

If this error occurs, notify the systems programmer responsible for BEA eLink TCP for IMS.

BEA2052I

ssss Issuing CONNECT request for LMID(lmid,R)

Description:

BEA eLink TCP for IMS is requesting an outbound session with a remote gateway.

ssss is the socket ID assigned to the connection by TCP/IP.

lmid is the logical machine ID of the remote gateway.

Response:

None required.

BEA2053E

ssss CONNECT request rejected by LMID(lmid,R): GWError(gwerror), GWMsg(gwmsg)

Description:

BEA eLink TCP for IMS received a negative response to a CONNECT request to establish an outbound session with a remote gateway.

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.

Action:

The CONNECT request fails and the TCP/IP connection with the remote gateway is terminated.

Response:

Refer to the documentation for the remote gateway for information about the reason for the error. Also, consult the remote gateway's log file for additional information.

BEA2054I

ssss CONNECT request accepted by LMID(lmid,R)

Description:

BEA eLink TCP for IMS has received a positive response to a CONNECT request to establish an outbound session with a remote gateway. The session is established and is ready to process requests.

ssss is the socket ID assigned to the connection by TCP/IP.

lmid is the logical machine ID of the remote gateway.

Response:

None required.

BEA2055I

ssss Issuing DISCONNECT for LMID(lmid,R)

Description:

BEA eLink TCP for IMS is ending an outbound session with a remote gateway.

ssss is the socket ID assigned to the connection by TCP/IP.

lmid is the logical machine ID of the remote gateway.

Response:

None required.

BEA2056E

ssss DISCONNECT rejected by LMID(lmid,R): GWError(gwerror), GWMsg(gwmsg)

Description:

BEA eLink TCP for IMS received a negative response to a DISCONNECT request to end an outbound session with a remote gateway.

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.

Action:

The session is terminated.

Response:

Refer to the documentation for the remote gateway for information about the reason for the error. Also, consult the remote gateway's log file for additional information.

BEA2057I

ssss DISCONNECT accepted by LMID(lmid,R)

Description:

BEA eLink TCP for IMS received a positive response to a DISCONNECT request to end an outbound session with a remote gateway.

ssss is the socket ID assigned to the connection by TCP/IP.

lmid is the logical machine ID of the remote gateway.

Response:

None required.

BEA2058I

ssss Sending PING request to LMID(lmid,R)

Description:

BEA eLink TCP for IMS is sending a PING request to a remote gateway.

ssss is the socket ID assigned to the connection by TCP/IP.

lmid is the logical machine ID of the remote gateway.

Response:

None required.

BEA2059E

ssss PING request rejected by LMID(lmid,R): GWError(gwerror), GWMsg(gwmsg)

Description:

BEA eLink TCP for IMS received a negative response to a PING request sent to a remote gateway.

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.

Action:

The session is terminated.

Response:

Refer to the documentation for the remote gateway for information about the reason for the error. Also, consult the remote gateway's log file for additional information.

BEA2060I

ssss PING response from LMID(lmid,R): response

Description:

BEA eLink TCP for IMS received a positive response to a PING request sent to a remote gateway.

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.

Response:

None required.

BEA2061I

ssss Sending command to LMID(lmid,R)

Description:

BEA eLink TCP for IMS is sending a command to a remote gateway.

ssss is the socket ID assigned to the connection by TCP/IP.

lmid is the logical machine ID of the remote gateway.

Response:

None required.

BEA2062E

ssss COMMAND rejected by LMID(lmid,R): GWError(gwerror), GWMsg(gwmsg)

Description:

BEA eLink TCP for IMS received a negative response to a command sent to a remote gateway.

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.

Action:

The session is terminated.

Response:

Refer to the documentation for the remote gateway for information about the reason for the error. Also, consult the remote gateway's log file for additional information.

BEA2063E

ssss Unable to allocate buffer for IMS Client Request (size=buffer-size)

Description:

BEA eLink TCP for IMS was unable to allocate storage for an internal buffer required to process an IMS client request.

ssss is the socket ID assigned to the connection by TCP/IP.

buffer-size is the size of the required buffer.

Response:

This is an abnormal condition indicating a severe storage shortage or corruption of the storage allocation control blocks. It may be necessary to terminate BEA eLink TCP for IMS (preferably with a dump) to identify and correct the problem.

BEA2064E

ssss IMS Client Request sent to LMID(lmid,R) failed: GWError(gwerror), GWMsg(gwmsg)

Description:

BEA eLink TCP for IMS received a negative response to an IMS client request sent to a remote gateway.

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.

Action:

The specified IMS client response transaction is scheduled with the appropriate return codes.

Response:

Refer to the documentation for the remote gateway for information about the reason for the error. Also, consult the remote gateway's log file for additional information.

BEA2065E

ssss State error on inout Session: LMID(lmid,type), Request(request), State(state)

Description:

BEA eLink TCP for IMS attempted to execute an operation against a session which is not currently in a state consistent with the requested operation.

ssss is the socket ID assigned to the connection by TCP/IP.

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.

Action:

The session is terminated.

Response:

Refer this error to the systems programmer responsible for BEA eLink TCP for IMS.

BEA2066E

Unable to allocate Session Control Block for Outbound Session

Description:

BEA eLink TCP for IMS was unable to allocate storage for an internal control block required to manage an outbound session.

Response:

This is an abnormal condition indicating a severe storage shortage or corruption of the storage allocation control blocks. It may be necessary to terminate BEA eLink TCP for IMS (preferably with a dump) to identify and correct the problem.

BEA2067I

ssss TCP/IP connection closed by session partner

Description:

BEA eLink TCP for IMS was notified that a TCP/IP connection with a remote system was closed by the session partner.

ssss is the socket ID assigned to the connection by TCP/IP.

Action:

The session is terminated.

Response:

None required.

BEA2068I

ssss TCP/IP connection reset

Description:

BEA eLink TCP for IMS was notified that a connection with a remote system was reset. A reset occurs when the connection is hard-closed (i.e., closed without first issuing a TCP/IP shutdown request).

ssss is the socket ID assigned to the connection by TCP/IP.

Action:

The session is terminated.

Response:

None required.

BEA2069E

ssss Length error on socket read

Description:

TCP/IP reported an illogical length read from a connection; for example, the length reported was greater than the actual length requested.

ssss is the socket ID assigned to the connection by TCP/IP.

Action:

The session is terminated.

Response:

This error may indicate a problem with TCP/IP for OS/390.

BEA2070E

ssss Abnormal return from TCP/IP API request: fcn(function), rc(rc), errno(errno)

Description:

BEA eLink TCP for IMS received an abnormal return from a TCP/IP socket operation.

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.

Action:

The session is terminated.

Response:

Consult the IBM TCP/IP for OS/390 documentation for a description of possible errno values and their meanings.

BEA2071I

ssss Session termination in progress (RSN=reason)

Description:

BEA eLink TCP for IMS has initiated termination of a session with a remote gateway.

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.

16 The connection was closed by the session partner.
20 An internal gateway request (such as CONNECT) timed out.
24 BEA eLink TCP for IMS is terminating in response to a SHUTDOWN request.
28 Session limit exceeded (a new session cannot be started).
60 A session protocol error occurred.

Response:

This action typically occurs as the result of a session-related error condition (identified by the reason code), or in conjunction with a SHUTDOWN request. If a reason code other than one of those previously listed is given, the error should be reported to the systems programmer responsible for BEA eLink TCP for IMS.

BEA2072I

ssss TCP/IP connection closed

Description:

As part of the session termination process, BEA eLink TCP for IMS successfully closed the TCP/IP connection. ssss is the socket ID assigned to the connection by TCP/IP.

Response:

None required.

BEA2073I

ssss Session termination complete

Description:

A session was successfully terminated by BEA eLink TCP for IMS.

ssss is the socket ID assigned to the connection by TCP/IP.

Response:

None required.

BEA2074E

Error writing to Server Response Log File

Description:

BEA eLink TCP for IMS received an abnormal return attempting to write a record to the server response log file.

Response:

Check the server response log file to ensure that it is allocated with the correct dataset attributes, allocated using the correct DDNAME, and is not full or experiencing I/O errors.

BEA2075E

Open failed for server response log file: DDNAME(ddname)

Description:

BEA eLink TCP for IMS is not able to open the Server Response Log File.

ddname is the DDNAME used by BEA eLink TCP for IMS to open the dataset.

Action:

Initialization fails and BEA eLink TCP for IMS terminates.

Response:

Check the server response log file to ensure that it is allocated with the correct dataset attributes and is allocated using the correct DDNAME as shown.

BEA2076E

ssss IMS Server Request received with previous request pending (timeout assumed)

Description:

BEA eLink TCP for IMS received an IMS server request from a remote gateway, but a prior request is still pending (i.e., currently being serviced by IMS).

ssss is the socket ID assigned to the connection by TCP/IP.

Action:

BEA eLink TCP assumes that the remote gateway timed out while waiting for a response to the previous request. Therefore, the previous request (currently being serviced by IMS) is aborted (discarded) and BEA eLink TCP for IMS begins processing the new request.

Response:

This error can occur when a remote gateway cancels a previously sent request (i.e., due to timeout) and immediately sends another request.

BEA2077E

ssss Pending IMS Server Request for Service(service) aborted

Description:

BEA eLink TCP for IMS aborted processing of the current server request.

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.

Action:

The current request is discarded and the session is ready to accept a new request.

Response:

None required.

BEA2078E

ssss IMS Server Request timed out: Service(service)

Description:

An IMS server request requiring a response was being processed by IMS, but no response was received within a specified period of time.

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.

Action:

The request is aborted. This message is also returned to the remote gateway as part of a negative response to the request.

Response:

Check the IMS server transaction (service) that processes the request to make sure that it is not stopped or has an unusually high backlog.

BEA2079E

Client Response failed: Sense Code=sc Reason=reason

Description:

A response to a client request was rejected by OTMA.

sc is the sense code.

reason is a numeric value indicating the reason for the response failure.

Action:

The response is logged.

Response:

Consult the IMS Open Transaction Manager Access Guide to determine the cause of the error.

BEA2080E

Malloc failed for parse work area

Description:

BEA eLink TCP for IMS was unable to allocate storage for an internal work area used to parse the configuration file.

Action:

Initialization fails and BEA eLink TCP for IMS terminates.

Response:

Report this error to the systems programmer responsible for BEA eLink TCP for IMS.

BEA2081I

IOPCB after CHKP Call:

Description:

Displays the contents of the IOPCB after a CHKP DLI call.

Action:

None.

Response:

None required. This message is used only when MSGLEVEL is set to DEBUG(10).

BEA2082E

Missing LMID option for REMOTE GATEWAY

Description:

A required keyword parameter (LMID) was omitted from a GATEWAY TYPE=REMOTE statement in the configuration File.

Action:

Initialization fails and BEA eLink TCP for IMS terminates.

Response:

Correct the problem and restart BEA eLink TCP for IMS.

BEA2083E

Missing HOSTADDR option for REMOTE GATEWAY

Description:

A required keyword parameter (HOSTADDR) was omitted from a GATEWAY TYPE=REMOTE statement in the configuration file.

Action:

Initialization fails and BEA eLink TCP for IMS terminates.

Response:

Correct the problem and restart BEA eLink TCP for IMS.

BEA2084E

Missing PORT option for REMOTE GATEWAY

Description:

A required keyword parameter (PORT) was omitted from a GATEWAY TYPE=REMOTE statement in the configuration file.

Action:

Initialization fails and BEA eLink TCP for IMS terminates.

Response:

Correct the problem and restart BEA eLink TCP for IMS.

BEA2085E

NAME option is invalid for REMOTE GATEWAY

Description:

An invalid keyword parameter (NAME) was specified on a GATEWAY TYPE=REMOTE statement in the configuration file.

Action:

Initialization fails and BEA eLink TCP for IMS terminates.

Response:

Correct the problem and restart BEA eLink TCP for IMS.

BEA2086E

TIMEOUT option is invalid for REMOTE GATEWAY

Description:

An invalid keyword parameter (TIMEOUT) was specified on a GATEWAY TYPE=REMOTE statement in the configuration file.

Action:

Initialization fails and BEA eLink TCP for IMS terminates.

Response:

Correct the problem and restart BEA eLink TCP for IMS.

BEA2087E

Cannot malloc for Remote Host

Description:

BEA eLink TCP for IMS was unable to allocate storage for an internal control block used to manage a remote gateway.

Action:

Initialization fails and BEA eLink TCP for IMS terminates.

Response:

Report this error to the systems programmer responsible for BEA eLink TCP for IMS.

BEA2088E

Missing LMID option for LOCAL GATEWAY

Description:

A required keyword parameter (LMID) was omitted from a GATEWAY TYPE=LOCAL statement in the configuration file.

Action:

Initialization fails and BEA eLink TCP for IMS terminates.

Response:

Correct the problem and restart BEA eLink TCP for IMS.

BEA2089E

Missing HOSTADDR option for LOCAL GATEWAY

Description:

A required keyword parameter (HOSTADDR) was omitted from a GATEWAY TYPE=LOCAL statement in the configuration file.

Action:

Initialization fails and BEA eLink TCP for IMS terminates.

Response:

Correct the problem and restart BEA eLink TCP for IMS.

BEA2090E

Missing PORT option for LOCAL GATEWAY

Description:

A required keyword parameter (PORT) was omitted from a GATEWAY TYPE=LOCAL statement in the configuration file.

Action:

Initialization fails and BEA eLink TCP for IMS terminates.

Response:

Correct the problem and restart BEA eLink TCP for IMS.

BEA2091E

Missing ACCOUNT option for LOCAL GATEWAY

Description:

A required keyword parameter (ACCOUNT) was omitted from a GATEWAY TYPE=LOCAL statement in the configuration file.

Action:

Initialization fails and BEA eLink TCP for IMS terminates.

Response:

Correct the problem and restart BEA eLink TCP for IMS.

BEA2092E

Missing PASSWORD option for LOCAL GATEWAY

Description:

A required keyword parameter (PASSWORD) was omitted from a GATEWAY TYPE=LOCAL statement in the configuration file.

Action:

Initialization fails and BEA eLink TCP for IMS terminates.

Response:

Correct the problem and restart BEA eLink TCP for IMS.

BEA2093E

NAME option is invalid for LOCAL GATEWAY

Description:

An invalid keyword parameter (NAME) was specified on a GATEWAY TYPE=LOCAL statement in the configuration file.

Action:

Initialization fails and BEA eLink TCP for IMS terminates.

Response:

Correct the problem and restart BEA eLink TCP for IMS.

BEA2094E

TIMEOUT option is invalid for LOCAL GATEWAY

Description:

An invalid keyword parameter (TIMEOUT) was specified on a GATEWAY TYPE=LOCAL statement in the configuration file.

Action:

Initialization fails and BEA eLink TCP for IMS terminates.

Response:

Correct the problem and restart BEA eLink TCP for IMS.

BEA2095E

Cannot malloc for Local Host

Description:

BEA eLink TCP for IMS was unable to allocate storage for an internal control block used to manage the local gateway.

Action:

Initialization fails and BEA eLink TCP for IMS terminates.

Response:

Report this error to the systems programmer responsible for BEA eLink TCP for IMS.

BEA2096E

Missing LMID option for REMOTE SERVICE

Description:

A required keyword parameter (LMID) was omitted from a SERVICE TYPE=REMOTE statement in the configuration file.

Action:

Initialization fails and BEA eLink TCP for IMS terminates.

Response:

Correct the problem and restart BEA eLink TCP for IMS.

BEA2097E

HOSTADDR option is invalid for REMOTE SERVICE

Description:

An invalid keyword parameter (HOSTADDR) was specified on a SERVICE TYPE=REMOTE statement in the configuration file.

Action:

Initialization fails and BEA eLink TCP for IMS terminates.

Response:

Correct the problem and restart BEA eLink TCP for IMS.

BEA2098E

PORT option is invalid for REMOTE SERVICE

Description:

An invalid keyword parameter (PORT) was specified on a SERVICE TYPE=REMOTE statement in the configuration file.

Action:

Initialization fails and BEA eLink TCP for IMS terminates.

Response:

Correct the problem and restart BEA eLink TCP for IMS.

BEA2099E

ACCOUNT option is invalid for REMOTE SERVICE

Description:

An invalid keyword parameter (ACCOUNT) was specified on a SERVICE TYPE=REMOTE statement in the configuration file.

Action:

Initialization fails and BEA eLink TCP for IMS terminates.

Response:

Correct the problem and restart BEA eLink TCP for IMS.

BEA2100E

PASSWORD option is invalid for REMOTE SERVICE

Description:

An invalid keyword parameter (PASSWORD) was specified on a SERVICE TYPE=REMOTE statement in the configuration file.

Action:

Initialization fails and BEA eLink TCP for IMS terminates.

Response:

Correct the problem and restart BEA eLink TCP for IMS.

BEA2101E

MAXMSGLEN option is invalid for REMOTE SERVICE

Description:

An invalid keyword parameter (MAXMSGLEN) was specified on a SERVICE TYPE=REMOTE statement in the configuration file.

Action:

Initialization fails and BEA eLink TCP for IMS terminates.

Response:

Correct the problem and restart BEA eLink TCP for IMS.

BEA2102E

SESSIONS option is invalid for REMOTE SERVICE

Description:

An invalid keyword parameter (SESSIONS) was specified on a SERVICE TYPE=REMOTE statement in the configuration file.

Action:

Initialization fails and BEA eLink TCP for IMS terminates.

Response:

Correct the problem and restart BEA eLink TCP for IMS.

BEA2103E

Missing NAME option for REMOTE SERVICE

Description:

A required keyword parameter (NAME) was omitted from a SERVICE TYPE=REMOTE statement in the configuration file.

Action:

Initialization fails and BEA eLink TCP for IMS terminates.

Response:

Correct the problem and restart BEA eLink TCP for IMS.

BEA2104E

Missing TIMEOUT option for REMOTE SERVICE

Description:

A required keyword parameter (TIMEOUT) was omitted from a SERVICE TYPE=REMOTE statement in the configuration file.

Action:

Initialization fails and BEA eLink TCP for IMS terminates.

Response:

Correct the problem and restart BEA eLink TCP for IMS.

BEA2105E

Cannot malloc for Work Service

Description:

BEA eLink TCP for IMS was unable to allocate storage used to process remote service definitions.

Action:

Initialization fails and BEA eLink TCP for IMS terminates.

Response:

Report this error to the systems programmer responsible for BEA eLink TCP for IMS.

BEA2106E

Cannot malloc for CurrWorkSer Info

Description:

BEA eLink TCP for IMS was unable to allocate storage used to process remote service definitions.

Action:

Initialization fails and BEA eLink TCP for IMS terminates.

Response:

Report this error to the systems programmer responsible for BEA eLink TCP for IMS.

BEA2107E

The command lines which are in error are: text

Description:

When a syntax error is detected during processing of the configuration file, BEA eLink TCP for IMS displays the lines containing the error.

text is the line containing the text in error.

Action:

Initialization fails and BEA eLink TCP for IMS terminates.

Response:

Correct the error and restart BEA eLink TCP for IMS.

BEA2108E

Cannot malloc for ServiceKeys

Description:

BEA eLink TCP for IMS was unable to allocate storage used to process remote service definitions.

Action:

Initialization fails and BEA eLink TCP for IMS terminates.

Response:

Report this error to the systems programmer responsible for BEA eLink TCP for IMS.

BEA2109E

Could not find LMID [lmid] for Service [service]

Description:

The logical machine ID (LMID) specified on a SERVICE TYPE=REMOTE statement could not be matched with a GATEWAY TYPE=REMOTE statement specifying the same (matching) LMID in the configuration file.

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.

Action:

Initialization fails and BEA eLink TCP for IMS terminates.

Response:

Each Remote Service must be associated with a particular remote gateway (identified by a unique logical machine ID) that provides the service. Check the GATEWAY TYPE=REMOTE and SERVICE TYPE=REMOTE statements to verify that they specify the same logical machine ID. Correct any errors and restart BEA eLink TCP for IMS.

BEA2110E

Syntax error in configuration file, line line-no

Description:

A syntax error was detected during processing of the configuration file.

line-no is the line number of the line containing the syntax error.

Action:

Initialization fails and BEA eLink TCP for IMS terminates.

Response:

Correct the error and restart BEA eLink TCP for IMS.

BEA2111E

Line in error: text

Description:

This message is displayed in conjunction with message BEA2110E.

text is the line containing the text in error.

Action:

Initialization fails and BEA eLink TCP for IMS terminates.

Response:

Correct the error and restart BEA eLink TCP for IMS.

BEA2112E

Open failed for configuration file: DDNAME(ddname)

Description:

BEA eLink TCP for IMS was unable to open the configuration file.

ddname is the logical dataset name of the configuration file dataset.

Action:

Initialization fails and BEA eLink TCP for IMS terminates.

Response:

Verify that the correct DDNAME is coded in the JCL for BEA eLink TCP for IMS and that the configuration file dataset has the correct attributes.

BEA2113I

jobname BEA Connect TCP For IMS (vv.rr) ready

Description:

This message is issued by BEA eLink TCP for IMS in conjunction with an outstanding WTOR which can be used to enter operator commands.

jobname is the OS/390 job name assigned to BEA eLink TCP for IMS.

vv is the product version number.

rr is the product release number.

Response:

None required. You can reply to the associated WTOR to enter an operator command for BEA eLink TCP for IMS.

BEA2114I

ssss Session TIMEOUT detected on LMID(lmid,type)

Description:

This message is issued by BEA eLink TCP for IMS when an IDLE TIMEOUT has occurred.

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).

Response:

Refer this error to the systems programmer responsible for BEA eLink TCP for IMS.

BEA2115I

Service service-name for IMSID logical-IMS-identifier has been added.

Description:

The ADD SERVICE operator command for a local service has completed successfully.

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.

Action:

None.

Response:

None required.

BEA2116

Reserved for future use.

BEA2117I

IMS Host IMSID has been modified.

Description:

The MOD HOST operator command has completed successfully. IMSID is a symbolic name that uniquely identifies the IMS system definition.

Action:

None.

Response:

None required.

BEA2117I

IMS Host IMSID has been modified.

Description:

The MOD HOST operator command has completed successfully.

IMSID is a symbolic name that uniquely identifies the IMS system definition.

Action:

None.

Response:

None required.

BEA2118E

IMS Host must be stopped prior to modifying.

Description:

The STOP HOST command must be issued before entering the MOD HOST command.

Action:

The MOD HOST command is aborted.

Response:

Enter the STOP HOST command and then retry the MOD HOST command.

BEA2119E

Missing IMSID option for MOD HOST.

Description:

The IMSID parameter was omitted and is required.

Action:

The MOD HOST command is aborted.

Response:

Enter the IMSID parameter and then retry the MOD HOST command.

BEA2120E

Allocation failed for OTMA Work Area

Description:

Upon initialization of the OTMA interface, BEA eLink TCP for IMS was unable to allocate storage used to interface with OTMA.

Action:

Initialization fails and BEA eLink TCP for IMS terminates.

Response:

Refer this error to the systems programmer responsible for BEA eLink TCP for IMS.

BEA2121I

Terminating OTMA interface

Description:

During shutdown, BEA eLink TCP for IMS prepares to close its connection with OTMA.

Action:

The OTMA interface is closed and its associated resources are returned to the system.

Response:

None required.

BEA2122E

Cannot resolve host name

Description:

During configuration file processing, a hostname for a local or remote gateway could not be resolved by the domain name server or the local host file.

Action:

If the error occurs during initialization, BEA eLink TCP for IMS terminates. If the error occurs during the dynamic addition of a gateway, the gateway is not added.

Response:

Check the hostname to verify spelling. Contact your network administrator to verify the hostname or change the hostname if necessary.

BEA2123I

Host address for hostname is IP-address

Description:

A hostname in the configuration file has been resolved to the following IP address.

Action:

None.

Response:

None required.

BEA2124E

Client Bid Failed

Description:

The initial communication between BEA eLink TCP for IMS and the IMS OTMA interface failed.

Action:

Initialization of the OTMA interface fails.

Response:

Verify that the OTMA interface for the IMS system you want to access is enabled and that the OTMAGROUP parameter defined for BEA eLink TCP for IMS matches the XCF group defined to IMS.

BEA2125I

OTMA Msg Received

Description:

Informational message only displayed when message level is set to DEBUG(10).

Action:

None

Response:

None required.

BEA2126I

OTMA Msg Sent

Description:

Informational message only displayed when message level is set to DEBUG(10).

Action:

None

Response:

None required.

BEA2127I

Client-Bid Message Sent

Description:

Informational message only displayed when message level is set to DEBUG(10).

Action:

None

Response:

None required.

BEA2128I

XCF Status with IMS Client OTMANAME=status

Description:

Response message to the STATUS operator command.

status is one of the following: ACTIVE, UNKNOWN, ERROR, RESET, or BID SENT

Action:

None

Response:

None required.

BEA2129I

Processing input from file filename

Description:

Response message to the INFILE operator command.

Action:

None

Response:

None required.

BEA2130I

Writing Configuration to file filename

Description:

Response message to the CHKPT CONFIG operator command.

Action:

None

Response:

None required.

BEA2131E

Open failed for Checkpoint File: filename

Description:

The filename given in the CHKPT CONFIG operator command was not a valid file name or the file could not be created.

Action:

The configuration checkpoint is aborted.

Response:

Check the file name and re-enter the command. Contact the system programmer responsible for BEA eLink TCP for IMS to check for availability of DASD resources.

BEA2132I

Configuration checkpoint complete

Description:

Normal response to a CHKPT CONFIG operator command.

Action:

None

Response:

None required.

BEA2133E

Error opening file filename

Description:

The file name entered with the INFILE operator command could not be opened.

Action:

The INFILE command processing is aborted.

Response:

Check the file name and retry if it is correct. Resolve any contention issues with other processes needing exclusive access to the file.

BEA2134E

Host LMID not Unique

Description:

The LMID for a gateway definition is not a unique name. No two gateways can share the same LMID.

Action:

If the error occurs during BEA eLink TCP for IMS startup, initialization aborts. If the error occurs while dynamically adding a gateway, the gateway is not added.

Response:

Change the LMID to a unique name.

BEA2135I

Gateway lmid has been added

Description:

This is the normal response to an ADD GATEWAY operator command.

lmid is the logical machine ID specified for the ADD GATEWAY command.

Action:

None

Response:

None required.

BEA2136E

Missing LMID option for MOD GATEWAY

Description:

The LMID option is required for a MOD GATEWAY operator command.

Action:

The command action is aborted.

Response:

Add the LMID parameter to the command and retry.

BEA2137E

Gateway lmid is invalid

Description:

The LMID parameter entered in a MOD GATEWAY or MOD SERVICE command is not a currently defined gateway.

lmid is the logical machine ID specified for the MOD command.

Action:

The MOD command is aborted.

Response:

Change the LMID to match the name of the defined gateway to be modified.

BEA2138E

Gateway must be stopped prior to modifying

Description:

A MOD GATEWAY operator command was issued prior to stopping the gateway with a STOP GATEWAY command.

Action:

The MOD command processing is aborted.

Response:

Issue a STOP GATEWAY command and retry the MOD GATEWAY command.

BEA2139I

Gateway lmid has been modified

Description:

This is the normal response to a MOD GATEWAY operator command.

lmid is the logical machine ID specified for the MOD GATEWAY command.

Action:

None

Response:

None required.

BEA2140I

Gateway lmid has been started

Description:

This is the normal response to a START GATEWAY command.

lmid is the logical machine ID specified for the START GATEWAY command.

Action:

None

Response:

None required.

BEA2141I

Gateway lmid is being stopped

Description:

This is the initial response to a STOP GATEWAY operator command.

lmid is the logical machine ID specified for the STOP GATEWAY command.

Action:

All outstanding messages are allowed to continue processing unless the IMMED=YES option was specified. All sessions for the gateway are then closed.

Response:

None required.

BEA2142I

Gateway lmid has been stopped

Description:

The STOP GATEWAY command has completed stopping the gateway.

lmid is the logical machine ID specified for the STOP GATEWAY command.

Action:

None

Response:

None required.

BEA2143E

Local Service Name not Unique

Description:

A service of the same name exists for the LMID associated with this service.

Action:

If the error occurs during BEA eLink TCP for IMS startup, initialization aborts and the program terminates. If the error occurs during processing of an ADD SERVICE operator command, command processing aborts.

Response:

Choose a unique name for the service and retry the command.

BEA2144I

Service service-name for LMID lmid has been added

Description:

This is the normal response to an ADD SERVICE operator command.

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.

Action:

None

Response:

None required.

BEA2145I

Service service-name for LMID lmid is invalid

Description:

The service name specified in the MOD SERVICE operator command does not exist, or the LMID is incorrect.

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.

Action:

The MOD SERVICE command processing aborts.

Response:

Correct the error and retry the command.

BEA2146E

Service must be stopped prior to modifying

Description:

A MOD SERVICE operator command was entered prior to stopping the service with a STOP SERVICE command.

Action:

The MOD SERVICE command processing aborts.

Response:

Issue a STOP SERVICE command and retry the MOD SERVICE command.

BEA2147I

Service service-name for LMID lmid has been modified

Description:

This is the normal response for a MOD SERVICE operator command.

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.

Action:

None

Response:

None required.

BEA2148I

System parameters have been modified

Description:

This is the normal response to a MOD SYSTEM operator command.

Action:

None

Response:

None required.

BEA2149E

Inbound TCP/IP connection refused: MCB Error

Description:

A connection attempt from a remote gateway was rejected because of a shortage of message control blocks probably due to an allocation of system resource failure.

Action:

The connection is refused.

Response:

Refer this error to the system programmer responsible for BEA eLink TCP for IMS.

BEA2150S

Security Violation: Tran=tran-id, UserID=userid, GroupID=groupid, TermID=terminalid

Description:

A request to execute a transaction on behalf of the given userid failed authorization.

Action:

A security error response is returned to the requestor.

Response:

None required. The message is given for auditing purposes only.

BEA2151I

XCF Send Failed Ret=return-code Rsn=reason-code

Description:

An attempt to send a message to OTMA failed.

Action:

A system error response is sent back to the requestor.

Response:

Verify the OTMA system parameters, correct any errors, and retry. If the error persists, refer this error to the systems programmer responsible for BEA eLink TCP for IMS.

BEA2152I

Message rejected by LMID(lmid,L) on Inbound Session - Gateway Stopped

Description:

A new request was received by a gateway in a stopping condition.

lmid is the logical machine ID specified for the MOD SERVICE command.

Action:

A system error response is sent to the requestor.

Response:

None required.

BEA2153I

Service service-name for LMID lmid has been started

Description:

This is the normal response for a START SERVICE operator command.

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.

Action:

None

Response:

None required.

BEA2154I

Service service-name for LMID lmid is being stopped

Description:

This is the initial response to a STOP SERVICE operator command.

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.

Action:

All outstanding requests are allowed to continue processing unless the IMMED=YES option was specified.

Response:

None required.

BEA2155I

Service service-name for LMID lmid has been stopped

Description:

This is the normal response to a STOP SERVICE operator command.

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.

Action:

None

Response:

None required.

BEA2156I

Response received for previously timed out request

Description:

A response was received for a request for which timeout processing had already initiated.

Action:

None

Response:

None required.

BEA2157I

Hostname maximum length (256) exceeded.

Description:

The hostname string used in the HOSTADDR gateway parameter is too long.

Action:

If the error occurs during BEA eLink TCP for IMS startup, initialization aborts. If the error occurs while dynamically adding a gateway, the gateway is not added.

Response:

Contact your network administrator to provide a new hostname less than 256 characters, or use the IP address in dotted decimal format.

BEA2158I

Maximum number of hostnames (256) exceeded.

Description:

More than 256 gateways were defined in the configuration using the hostname option of the HOSTADDR parameter.

Action:

If the error occurs during BEA eLink TCP for IMS startup, initialization aborts. If the error occurs while dynamically adding a gateway, the gateway is not added.

Response:

Refer this error to the systems programmer responsible for BEA eLink TCP for IMS.

BEA2159I

Inbound TCP/IP connection request rejected: Gateway Stopped

Description:

A remote gateway connection attempt to a stopped gateway was rejected.

Action:

A connection error response was returned to the remote gateway.

Response:

None required.

BEA2160E

IMS Error Message received

Description:

IMS rejected a service request for a variety of reasons.

Action:

An IMS DFS Error message was returned to the gateway on behalf of a client request.

Response:

Examine the text of the message to determine the nature of the error and take corrective action.

BEA2161E

IMS Server Request failed - IMS Unavailable

Description:

The IMS host system required to service this request is not available.

Action:

An error message is returned to the client with the appropriate error and reason codes set.

Response:

Determine why the IMS Host is unavailable and change the configuration to reroute the request to another available Host, if possible.

BEA2162I

OTMA Status change detected with status: Old=oldstatus New=newstatus

Description:

The eLink gateway detected a status change with an IMS Host.

Action:

The message is logged and displayed to the console.

Response:

Determine why the status of the IMS Host has changed.

BEA2163E

OTMAINPIPE maximum length n exceeded.

Description:

An IMS Host was configured with an OTMAINPIPE parameter.

Action:

The message is logged and displayed to the console.

Response:

Correct the configuration information and retry.

BEA2164I

Multi-Segment Message Reconstructed

Description:

A multi-segment client response was received.

Action:

None.

Response:

None required. This message is used only when MSGLEVEL is set to DEBUG(10).

BEA2165E

Not enough spare sockets available.

Description:

A dynamic configuration change was attempted that required the use of additional TCP/IP socket resources and not enough were available. Message BEA2166E should follow with additional details.

Action:

The configuration change was rejected.

Response:

The eLink TCP for IMS gateway must be shut down to accomplish the change. Consider increasing the value of the SPARESOCKETS parameter for future dynamic updates.

BEA2166E

Requested: n, Available: n

Description:

A follow on message to BEA2165E. This message details the TCP/IP socket resources requested and available.

Action:

The configuration change was rejected.

Response:

The eLink TCP for IMS gateway must be shut down to accomplish the change. Consider increasing the value of the SPARESOCKETS parameter for future dynamic updates.

BEA2167E

Invalid Command Syntax

Description:

The command was entered incorrectly.

Action:

The command was rejected.

Response:

For correct command syntax, refer to the "Configuring BEA eLink TCP for IMS."

BEA2168E

IMS Server Request for Service(service-name) failed: Requested Service not defined

Description:

The service request from a remote client was for an undefined service.

Action:

The client request is rejected with an appropriate error and reason code.

Response:

Update the remote client to request the correct service name or define a new local service with the name requested.

BEA2169E

IMS Server Request for Service (service-name) failed:Requested Service not available

Description:

The service request from a remote client was for a service that is temporarily unavailable.

Action:

The client request is rejected with an appropriate error and reason code.

Response:

Determine why the service is currently unavailable and take corrective action, if necessary.

BEA2170E

IMS Server Request for Service (service-name) failed: Buffer Size Error

Description:

The service request from a remote client failed due to an internal buffer size error. Typically, this is caused by exceeding the maximum message size of 64K, including internal header data.

Action:

The client request is rejected with an appropriate error and reason code.

Response:

Contact BEA Support to report the error.

BEA2171E

Multiplex Count must be greater than zero (0)

Description:

A GATEWAY configuration statement contained a MULTIPLEX parameter set to zero.

Action:

The configuration is rejected. If the error occurred on initial startup, the eLink TCP for IMS gateway exits.

Response:

Change the MULTIPLEX parameter to a number greater than zero or remove the parameter and use the default (1).

BEA2172E

Missing IMSID option for IMS HOST

Description:

A HOST configuration statement was missing an IMSID parameter which is required.

Action:

The configuration is rejected. If the error occurred on initial startup, the eLink TCP for IMS gateway exits.

Response:

Correct the configuration information and retry.

BEA2173E

Missing OTMANAME option for IMS HOST

Description:

A HOST configuration statement was missing an OTMANAME parameter which is required.

Action:

The configuration is rejected. If the error occurred on initial startup, the eLink TCP for IMS gateway exits.

Response:

Correct the configuration information and retry.

BEA2174E

Missing OTMAINPIPE option for IMS HOST

Description:

A HOST configuration statement was missing an OTMAINPIPE parameter which is required.

Action:

The configuration is rejected. If the error occurred on initial startup, the eLink TCP for IMS gateway exits.

Response:

Correct the configuration information and retry.

BEA2175E

Missing OTMAOUTPIPE option for IMS HOST

Description:

A HOST configuration statement was missing an OTMAOUTPIPE parameter which is required.

Action:

The configuration is rejected. If the error occurred on initial startup, the eLink TCP for IMS gateway exits.

Response:

Correct the configuration information and retry.

BEA2176E

Cannot malloc for IMS HOST

Description:

BEA eLink TCP for IMS was unable to allocate storage used to process IMS HOST definitions.

Action:

Initialization fails and BEA eLink TCP for IMS terminates.

Response:

Report this error to the systems programmer responsible for BEA eLink TCP for IMS.

BEA2177E

Host IMSID not Unique

Description:

A HOST configuration with the same IMSID already exists.

Action:

If the error occurs during BEA eLink TCP for IMS startup, initialization is aborted and the program terminates. If the error occurs during processing of an ADD HOST operator command, command processing is aborted.

Response:

Choose a unique name for the HOST and retry the command.

BEA2178E

Missing IMSID option for Service

Description:

A local service definition is missing an IMSID parameter which is required.

Action:

If the error occurs during BEA eLink TCP for IMS startup, initialization is aborted and the program terminates. If the error occurs during processing of an ADD SERVICE operator command, command processing is aborted.

Response:

Change the SERVICE, TYPE=LOCAL statement to include an IMSID parameter.

BEA2179E

Local Service service-name for IMSID IMS-logical-identifier is invalid

Description:

A dynamic configuration operator command (MOD, START, or STOP SERVICE) was entered for a local service that does not exist.

Action:

Command processing is aborted.

Response:

Enter the correct remote name of the local service in the NAME parameter of the dynamic configuration command.

BEA2180I

Service service-name for IMSID IMS-logical-identifier is being stopped

Description:

A STOP SERVICE operator command for a local service is being processed.

Action:

The STOP processing continues for the local service.

Response:

None Required. Informational message only.

BEA2181I

Service service-name for IMSID IMS-logical-identifier has been stopped

Description:

A STOP SERVICE operator command for a local service has completed processing.

Action:

The STOP processing has completed.

Response:

None Required. Informational message only.

BEA2182E

Could not find IMSID IMS-logical-identifier for service service-name

Description:

A dynamic configuration operator command was entered for a local service which did not contain a valid IMSID parameter.

Action:

Command processing is aborted.

Response:

Enter the correct IMSID of the local service in the IMSID parameter of the dynamic configuration command.

BEA2183I

Messages Processed = n

Description:

Part of the STATUS display showing the number of service requests processed.

Action:

None.

Response:

None Required. Informational message only.

BEA2184I

XCF Messages Received = n

Description:

Part of the STATUS display showing the number of XCF messages received by the gateway.

Action:

None.

Response:

None Required. Informational message only.

BEA2185I

MCBs: Allocated = number of MCBs Assigned = number of MCBs

Description:

Part of the STATUS display showing the number of message control blocks defined and currently in use.

Action:

None.

Response:

None Required. Informational message only.

BEA2186I

Services: Remote = number of remote services Local = number of local services

Description:

Part of the STATUS display showing the number of services currently defined.

Action:

None.

Response:

None Required. Informational message only.

BEA2187E

IMS HOST IMS-logical-identifier is invalid

Description:

A dynamic configuration operator command ( MOD, START, or STOP was entered for an IMSID that does not exist.

Action:

Operator command processing is aborted.

Response:

Retry the command with a valid IMSID.

BEA2188I

IMS HOST IMS-logical-identifier has been started

Description:

A START HOST operator command for an IMS host has completed processing.

Action:

None

Response:

None Required. Informational message only.

BEA2189I

IMS HOST IMS-logical-identifier is being stopped

Description:

A STOP HOST operator command for an IMS host is being processed.

Action:

The STOP HOST processing continues for the host.

Response:

None Required. Informational message only.

BEA2190I

IMS HOST IMS-logical-identifier has been stopped

Description:

A STOP SERVICE operator command for an IMS host has completed processing.

Action:

The STOP SERVICE processing has completed.

Response:

None Required. Informational message only.

BEA2191E

Service service-name for IMSID IMS-logical-identifier already exists.

Description:

An ADD SERVICE operator command for a local service has been attempted but the service has been previously defined.

Action:

The ADD SERVICE processing has been aborted.

Response:

Change the service name and retry, if necessary,

BEA2192E

Missing LMID option for START GATEWAY

Description:

A START GATEWAY operator command has been attempted but the LMID parameter, which is required, has been omitted.

Action:

The START GATEWAY processing has been aborted.

Response:

Add the LMID parameter to the command and retry.

BEA2193E

Missing LMID option for STOP GATEWAY

Description:

A STOP GATEWAY operator command has been attempted but the LMID parameter, which is required, has been omitted.

Action:

The STOP GATEWAY processing has been aborted.

Response:

Add the LMID parameter to the command and retry.

BEA2194E

Missing IMSID option for START HOST

Description:

A START HOST operator command has been attempted but the IMSID parameter, which is required, has been omitted.

Action:

The START HOST processing has been aborted.

Response:

Add the IMSID parameter to the command and retry.

BEA2195E

Missing IMSID option for STOP HOST

Description:

A STOP HOST operator command has been attempted but the IMSID parameter, which is required has, been omitted.

Action:

The STOP HOST processing has been aborted.

Response:

Add the IMSID parameter to the command and retry.

BEA2196E

OTMANAME for IMSID IMS-logical-identifier not unique

Description:

A HOST statement contains an OTMANAME parameter value that already is used in another HOST statement.

Action:

If the error occurs during BEA eLink TCP for IMS startup, initialization is aborted and the program terminates. If the error occurs during processing of an ADD HOST operator command, command processing is aborted.

Response:

Change the OTMANAME parameter to match the unique OTMA client name of the IMS system and retry.

BEA2197 - BEA2213

Reserved for internal trace messages used only when debugging is enabled.

BEA2214E

Response Service remote-service-name for Service local-service-name is invalid.

Description:

The specified RESPONSE service on a SERVICE, TYPE=LOCAL statement was not a valid remote service.

Action:

If the error occurs during BEA eLink TCP for IMS startup, initialization is aborted and the program terminates. If the error occurs during processing of an ADD SERVICE operator command, command processing is aborted.

Response:

Change the service name and retry.

BEA2215E

Response Transaction remote-service-name from IMS Client is invalid.

Description:

The response transaction specified in the BEA client request/response header is not defined as a local service.

Action:

The client request is aborted.

Response:

Define the response transaction as a local service.

BEA2216E

Client request for Service remote-service-name timed out on queue.

Description:

A service request from an IMS client timed out while waiting for an available session on a remote host.

Action:

A timeout error is returned to the response transaction.

Response:

Reconfigure the SESSIONS or MULTIPLEX count for the desired remote gateway, if necessary.

BEA2217I

Service local-service-name for IMSID IMS-logical-identifier has been started.

Description:

This is the normal response for a START SERVICE operator command for a local service.

Action:

None.

Response:

None Required.

BEA2218 - BEA2500

Reserved for future use by BEA Connect TCP for IMS.



        TABLE OF CONTENTS   |   PREVIOUS TOPIC   |   NEXT TOPIC   |   GLOSSARY  |   INDEX