|  | BEA eLink TCP for CICS 3.1 Information Center
HOME | SEARCH | CONTACT | PDF FILES | WHAT'S NEW
| TABLE OF CONTENTS | PREVIOUS TOPIC | INDEX

# Error and Informational Messages

Most of the messages produced from BEA eLink for Mainframe TCP for CICS (hereafter referenced as eLink TCP for CICS) are sent back to the remote TUXEDO eLink TCP for TUXEDO gateway and written to the ULOG on that system. Occasionally, messages are written directly to the CICS log configured specifically for eLink TCP for CICS. For more information about configuring the CICS log, refer to "Configuring and Administering BEA eLink TCP for CICS."

The following topics describe eLink TCP for CICS messages:

- Messages Returned to the Remote Gateway

- Messages Written to the eLink TCP for CICS Log

- Codes Returned to a CICS Client Program

- Informational Process Messages

- Data Field Error Messages

- System Error Messages

  ## Messages Returned to the Remote Gateway

  Message | Description
  --- | ---
  `BEA eLink TCP for CICS server process initiated.` | The Handler process has been started.
  `Welcome to BEA eLink TCP for MVS/CICS.` | The connect process has completed successfully.
  `Goodbye.` | The disconnect process has completed successfully.
  `Service` `svcname` `not found.` | The requested service was not found in the inbound service name file.
  `Client has already logged in.` | A client process has attempted to establish a connection when a connection already existed. (The connection request protocol was resent.)
  `Client has not logged in.` | A client process has made a request to the eLink TCP for CICS gateway but has not yet established a login connection. (The connection request protocol was never sent.)
  `BEA eLink TCP MVS/CICS server is active.` | This message is returned to the remote TUXEDO gateway when a PING request is sent to the eLink TCP for CICS gateway from the tmadmin administration tool.
  `Invalid password.` | The password specified in the eLink TCP for TUXEDO configuration file does not match the password specified when the CICS supplied listener was configured.
  `Invalid client account.` | The account code specified in the eLink TCP for TUXEDO configuration file does not match the account code specified when the CICS supplied listener was configured.
  `Sorry-System Resource is protected by CICS.` | The mode command was executed through the tmadmin tool on TUXEDO and the administrative request specified is not available in the CICS region.
  `Data too long, please check message header.` | A message received is larger than the maximum allowable message length.
  `Data too short, please check message header.` | A message was received and was smaller than the smallest expected message.
  `Message header is incorrect.` | An invalid protocol header was received. This can occur if there was a transmission error or if a message was sent to the gateway without having gone through the eLink TCP for TUXEDO gateway on the remote TUXEDO node.
  `This transaction is not defined in CICS.` | A CICS transaction code was mapped to a service name in the eLink TCP for TUXEDO configuration file for a transaction code that is unknown to CICS.
  `Application Handler abnormally terminated.` | The Application Handler terminated prior to completing the service request. This message usually occurs when a service has timed out. Verify that you are not expecting a reply from a service that does not send one.
  `Requested Service timed out.` | The requested service did not complete within the time provided in the message header from the remote TUXEDO gateway.
  `Unable to start another session.` | The Handler is already processing the maximum number of service requests configured as the multiplex count.
  `Unable to start transaction.` | A CICS error occurred attempting to start the transaction.
  `Error occurred in Application Handler.` | The Application Handler encountered a CICS error.
  `Security error occurred in Application Handler.` | The Application Handler encountered a CICS security error.

  ## Messages Written to the eLink TCP for CICS Log

  Message | Description
  --- | ---
  `Goodbye.` | The disconnect process has completed successfully.
  `Service` `svcname` `not found.` | The requested service was not found in the inbound service name file.
  `Client has already logged in.` | A client process has attempted to establish a connection when a connection already existed. (The connection request protocol was resent.)
  `Client has not logged in.` | A client process has made a request to the eLink TCP for CICS gateway but has not yet established a login connection. (The connection request protocol was never sent.)
  `Invalid password.` | The password specified in the eLink TCP for TUXEDO configuration file does not match the password specified when the CICS supplied listener was configured.
  `Invalid client account.` | The account code specified in the eLink TCP for TUXEDO configuration file does not match the account code specified when the CICS supplied listener was configured.
  `Data too long, please check message header.` | A message received is larger than the maximum allowable message length.
  `Application Handler abnormally terminated.` | The Application Handler terminated prior to completing the service request. This message usually occurs when a service has timed out. Verify that you are not expecting a reply from a service that does not send one.
  `Requested Service timed out.` | The requested service did not complete within the time provided in the message header from the remote TUXEDO gateway.
  `Unable to start another session.` | The Handler is already processing the maximum number of service requests configured as the multiplex count.
  `Unable to start transaction.` | A CICS error occurred attempting to start the transaction.
  `Error occurred in Application Handler.` | The Application Handler encountered a CICS error.
  `Security error occurred in Application Handler.` | The Application Handler encountered a CICS security error.
  `DNS Lookup Failed for HOST(host) ERRNO(errno)` | The DNS lookup function failed for the given host name.
  `Dotted IP address (address) malformed.` | There was an erroneous IP address passed into the ConvertAddress function.
  `Invalid data pointer (pointer).` | There was an invalid data buffer pointer passed into the BufferHeader function.
  `Socket CONNECT Failed. ERRNO=errno` | The Socket CONNECT function failed.
  `fcntl(F_SETFL) Failed. ERRNO=errno FLAGS=hexcode` | The file control function with the F_SETFL option failed in the connect socket function.
  `fcntl (F_GETFL) Failed. ERRNO=errno` | The file control function with the F_GETFL option failed in the connect socket function.
  `Socket CREATE Failed. ERRNO=errno` | The Socket CREATE function failed.
  `WRITE on Socket Failed. ERRNO=errno` | The Socket WRITE function failed.
  `initapi Failed. ERRNO=errno` | The Socket initialization function failed.
  `RETRIEVE Failed. RESP=hexcode RESP2=hexcode` | The CICS RETRIEVE command failed when it tried to access the buffer passed to the eLink TCP for TUXEDO Handler from the Sockets for CICS Listener.
  `Load Control Failed. RESP=hexcode RESP2=hexcode` | A CICS LOAD PROGRAM command failed. The Handler was unable to load the control programs OTPCICS01 or OTPCICS02.
  `Start Task Failed. RESP=hexcode RESP2=hexcode` | A CICS START command failed when the Handler tried to issue a START on the specified user program.
  `Link Program Failed. RESP=hexcode RESP2=hexcode` | A CICS LINK command failed. The Handler was unable to LINK to the specified user program.
  `GETMAIN Failed. RESP=hexcode RESP2=hexcode` | The CICS GETMAIN command failed.
  `Take Socket Failed. ERRNO=errno` | The eLink TCP Handler was unable to take control of the TCP/IP socket.
  `Error on Select. ERRNO=errno` | The Sockets SELECT function failed.
  `Read on Socket Failed. ERRNO=errno` | An error was encountered while attempting to read from the active socket.
  `Socket SEND Failed. RC=rc ERRNO=errno` | An error was encountered while issuing a send over the active socket.
  `Handler connected successfully.` | The client request is allowed because the account and password codes are authorized to use the eLink TCP gateway.
  `BEA eLink TCP Server CTOS is shutting down.` | The eLink TCP for TUXEDO Handler is shutting down.
  `Verifying User Account.` | The Handler is verifying that the account and password codes supplied by eLink TCP for TUXEDO on the remote TUXEDO gateway are valid.
  `Handler initialization complete.` | The eLink TCP Handler has successfully initialized.
  `Normal shutdown requested, x requests pending.` | The eLink TCP Handler shuts down after the currently pending requests complete.
  `Handler exceeded maximum idle time.` | The eLink TCPHandler has exceeded the configured IDLE TIME.
  `BEA eLink TCP Handler is shutting down.` | The eLink TCP Handler is shutting down.
  `Client disconnected.` | The client has been disconnected from the eLink TCP Handler.
  `Read of file failed, resp(hexcode)` | A CICS READ command failed.
  `Freemain did not work, resp(hexcode)` | A CICS FREEMAIN command failed.
  `Getmain shared failed: resp(hexcode)` | A CICS GETMAIN(SHARED) command failed.
  `Delete from file failed, resp(hexcode)` | A CICS DELETE command failed.
  `Write to file failed, resp(hexcode)` | A CICS WRITE command failed.
  `Rewrite of file failed, resp(hexcode)` | A CICS REWRITE command failed.
  `Read(update) of file failed, resp(hexcode)` | A CICS READ(UPDATE) command failed.
  `Unauthorized Client Rejected.` | The client request are not allowed because the account and/or password codes are not authorized.
  `deleteq ts did not work, resp(hexcode)` | A CICS DELETEQ TS command failed.
  `Unable to start transaction` | A CICS error occurred attempting to start the transaction.
  `Security Violation: Invalid user for this transaction` | The userid sent with a request by the client does not match the userid set in the mainframe security for this transaction.
  `The Handler is designed to run in the background.` | A user has attempted to start the Handler from a terminal.
  `The appHandler is designed to run in the background.` | A user, from a terminal, has attempted to start the transaction that initiates the Application Handler.
  `App Handler received corrupted header, exiting.` | The Application Handler is terminating on initialization because there is a problem with the header it received. This would occur, for example, if the transaction for the Application Handler was given in the Inbound Service Information screen as the transaction to start a service with no reply.
  `opcode is not CONNECT on connection.` | The Requester has received a reply that should be the acknowledgment of a connection request; however, the message does not contain the correct opcode.
  `Trying connection, but already connected.` | The Requester has received a reply containing an opcode indicating a response to a connection request; however, the connection already exists.
  `Read on sockets failed. Connection closed by other side.` | The Handler terminated because the socket status indicated that the client side had closed the connection.

  ## Codes Returned to a CICS Client Program

  The following codes are returned to a CICS client program on return from a LINK to eLink TCP. For system level problems, please notify your CICS administrator.

  Message | Description
  --- | ---
  `BEA_NORMAL` | Value 0 Successful Return From Service Call.
  `BEA_ERR_LENGTH` | Value 1 There was an error regarding the length of the message sent or the length value specified.
  `BEA_ERR_MISSING_SRV_NAME` | Value 2 A service request was made but no service name was provided.
  `BEA_ERR_REQ_CODE` | Value 3 A service call was made with an invalid or missing request code.
  `BEA_ERR_SRC_NOT_FOUND` | Value 4
  `BEA_ERR_READ_UMT` | Value 5 Check the FCT entry for the CONNECTIONS dataset.
  `BEA_ERR_SERVER` | Value 6 There was a problem accessing the Requester. Check that it is enabled.
  `BEA_ERR_POST` | Value 7 A CICS Post error occurred in eLink TCP.
  `BEA_ERR_CANCEL` | Value 8 A CICS Cancel error occurred in eLink TCP.
  `BEA_ERR_WAIT` | Value 9 A CICS Wait error occurred in eLink TCP.
  `BEA_ERR_LMID_NOT_FOUND` | Value 10 The service name provided specified a non-existent LMID.
  `BEA_ERR_START_TRANSID` | Value 11 A CICS Start error occurred in eLink TCP.
  `BEA_ERR_DISABLE_ACQUIRING` | Value 12 There was a problem getting an LMID to use for this service request.
  `BEA_ERR_DISABLE_NOT_FND` | Value 13 The service name provided specifies an invalid LMID or is missing the LMID.
  `BEA_ERR_DISABLE_NOT_RESPOND` | Value 14 The Requester for handling this service name is not responding.
  `BEA_ERR_DISABLE` | Value 15 The LMID associated with the requested service is not enabled.
  `BEA_ERR_ALLOC` | Value 16 The Pre-requester was unable to allocate the memory necessary to process a request.
  `BEA_ERR_TIMEOUT` | Value 17 The Pre-requester has timed out the request. This could occur either during processing by the Pre-requester, before the request is sent, or because the Pre-requester did not receive a response in time.
  `BEA_ERR_TSQ` | Value 18 The Pre-requester was unable to write the request to the appropriate TS queue.
  `BEA_ERR_SOCKET_FAILURE` | Value 19 The Requester closed a socket because the socket was in a state inconsistent with the requested operation.
  `BEA_ERR_PROTOCOL` | Value 20 The Requester closed a socket because the session data was corrupt.
  `BEA_ERR_QUEUE_OVERFLOW` | Value 21 The Requester has aborted a request because the pending request queue for the Requester is too full.

  ## Informational Process Messages

  Message | Description | Action
  --- | --- | ---
  `"RECORD READY FOR UPDATE"` | The record selected is ready to be updated. | Make the changes and press ENTER to process.
  `"UPDATE COMPLETED"` | The changes made to the record selected for update have been processed. | Select another record to update, or press PF3 or PF5.
  `"TO CONFIRM DELETE, PRESS ENTER:AGAIN"` | The record selected is ready to be deleted. | Press ENTER to delete the selected record of press PF3 or PF5 to abort the delete.
  `"DELETE COMPLETED"` | The record selected for delete has been deleted. | Select another record to delete, or press PF3 or PF5.
  `"INQUIRE COMPLETED"` | The record selected for inquiry has been processed. | Select another record to inquiry, or press PF3 or PF5.
  `"INSERT COMPLETED"` | The record entered has been inserted into the file. | Enter another record, or press PF3 or PF5.

  ## Data Field Error Messages

  Message | Description | Action
  --- | --- | ---
  `"INVALID FUNCTION KEY, OPTIONS=(ENTER:, PF3:)"` | The PFKey pressed is not valid in this operation. | Press a valid PFKey. See OPTIONS=.
  `"INVALID FUNCTION KEY, OPTIONS=(ENTER:, PF3:, PF5:)"` | The PFKey pressed is not valid in this operation. | Press a valid PFKey. See OPTIONS=.
  `"INVALID FUNCTION KEY, OPTIONS=(ENTER:, PF3:, PF7:, PF8:)"` | The PFKey pressed is not valid in this operation. | Press a valid PFKey. See OPTIONS=.
  `"INVALID LOGICAL MACHINE NAME"` | The LOGICAL MACHINE NAME entered is not valid. | Enter a valid INVALID LOGICAL MACHINE NAME (i.e., LMIDNJ). Must not start with a SPACE, NULL, or Under_Score.
  `"INVALID HOST ADDRESS"` | The HOST ADDRESS entered is not valid. | Enter a valid HOST ADDRESS (i.e., 1234.1234.99). Must not start with a SPACE, NULL, or Under_Score.
  `"HOST ADDRESS or DNS NAME REQUIRED"` | Neither the HOST ADDRESS nor the DNS NAME have been entered. | Enter either a valid HOST ADDRESS or DNS NAME.
  `"CANNOT HAVE BOTH HOST ADDRESS AND DNS NAME"` | Both HOST ADDRESS and DNS NAME have been entered. | Enter either a valid HOST ADDRESS or DNS NAME.
  `"INVALID MULTIPLEX COUNT OPTIONS=(1-99)"` | The MULTIPLEX COUNT entered is not valid. | Enter a valid number for MULTIPLEX COUNT.
  `"INVALID MAX CONNECTIONS OPTIONS=(1-99)"` | The MAX CONNECTIONS entered is not valid. | Enter a valid number for MAX CONNECTIONS.
  `"TRAN CODE INVALID FOR LMID TYPE (L INTERLINK, I IMS, T TCP)"` | A START TRAN CODE has been entered and the LMID TYPE is not CICS. | Remove the START TRAN CODE or change the LMID TYPE to CICS.
  `"QUEUE NAME REQUIRED"` | The QUEUE NAME has not been entered. | Enter a valid QUEUE NAME.
  `"CICS DATA INVALID FOR LMID TYPE (L INTERLINK, I IMS, T TCP)"` | CICS DATA has been entered and the LMID TYPE is not CICS. | Remove the CICS DATA or change the LMID TYPE to CICS.
  `"INVALID PORT NUMBER OPTIONS=(1 -> 65,535)"` | The PORT NUMBER entered is not valid. | Enter a valid PORT NUMBER (i.e., 1234). It must not start with a SPACE, NULL, or Under_Score and must be within the range (1 -> 65,535)
  `"ACCOUNT ID REQUIRED"` | An ACCOUNT ID is required if you entered a PASSWORD. | Enter an ACCOUNT or erase the PASSWORD.
  `"PASSWORD REQUIRED"` | A PASSWORD is required if you entered an ACCOUNT ID. | Enter a PASWORD or erase the ACCOUNT ID.
  `"INVALID MAX MSG SIZE OPTIONS=(1 -> 32000)"` | The MAX MSG SIZE entered is not valid. | Enter a valid MAX MSG SIZE (i.e., 4096) Must not start with a SPACE, NULL, or Under_Score and must be within the range (1 -> 32000)
  `"INVALID CONNECT RETRY LIMIT"` | The CONNECT RETRY LIMIT entered is not valid. | Enter a valid CONNECT RETRY LIMIT (i.e., 10) Must not start with a SPACE, NULL, or Under_Score
  `"INVALID SELCDE, OPTIONS= (1: INS, 2: UPD, 3: INQ, 4: DEL)` | The SELCDE entered is not valid. | Enter a valid SELCDE. See OPTIONS=.
  `"INVALID SELCDE, OPTIONS= (2: UPD, 3: INQ)` | The SELCDE entered is not valid. | Enter a valid SELCDE. See OPTIONS=.
  `"INVALID SELECTION, OPTIONS=(C2-3, C5, R1-5, S1-5, U2-3, I1-5)"` | The SELECTION entered is not valid. | Enter a valid SELECTION. See the list of valid options in the message.
  `"INVALID SERVICE NAME"` | The SERVICE NAME entered is not valid. | Enter a valid SERVICE NAME. (i.e., EMPLSRV) Must not start with a space, null, or underscore.
  `"INVALID REMOTE SERVICE NAME"` | The REMOTE SERVICE NAME entered is not valid. | Enter a valid REMOTE SERVICE NAME (i.e., EMPLSRV) Must not start with a space, null, or underscore.
  `"INVALID LMID TYPE OPTIONS= (C CICS, I IMS, L INTERLINK, T TCP)"` | The LMID TYPE entered is not valid. | Enter a valid LMID TYPE. See Options
  `"START TRAN CODE REQUIRED FOR LMID TYPE (C CICS)"` | No START TRAN CODE has been entered and the LMID TYPE is CICS. | Enter a valid START TRAN CODE.
  `"INVALID TYPE (I INCOMING, O OUTGOING)"` | The TYPE entered is not valid. | Enter a valid TYPE.
  `"INVALID IBM STACK FLAG (Y/N)"` | The IBM STACK FLAG entered is not valid. | Enter a valid IBM STACK FLAG (Y or N).
  `"INVALID MAX CONNECTIONS FOR STACK TYPE"` | The MAX CONNECTIONS entered is not valid for the STACK TYPE. | Enter a valid MAX CONNECTIONS. If IBM STACK FLAG=N, MAX CONNECTIONS must be 1.
  `"INVALID SECURITY FLAG (Y/N)"` | The SECURITY FLAG entered is not valid. | Enter a valid SECURITY FLAG (Y or N).
  `"INVALID SERVICE TIMEOUT(SEC)"` | The SERVICE TIMEOUT(SEC) entered is not valid. | Enter a valid SERVICE TIMEOUT(SEC) (i.e. 30). Must not start with a SPACE, NULL, or Under_Score.
  `"INVALID STATUS OPTIONS=(E ENABLE, D DISABLE, A ABORT)"` | The STATUS entered is not valid. | Enter a valid STATUS. See OPTIONS=.
  `"NO CHANGE DONE STATUS ENTERED SAME AS ON RECORD"` | The STATUS on the record is 'E' and you entered an 'E'. The STATUS on the record is 'D' and you entered a 'D'. The STATUS on the record is 'A' and you entered a 'A'. | Enter the appropriate STATUS.
  `"BEA_REQ_HDR RECORD NOT FOUND"` | An error occurred within the Connection CSA. | Contact your system administrator.

  ## System Error Messages

  Message | Description | Action
  --- | --- | ---
  `"BEG/END OF FILE"` | The end of file was detected during a browse. | None
  `"DUPLICATE RECORD"` | The record being inserted is already on the file. | Use a different record key.
  `"FILE NOT OPENED"` | The file is not available to CICS. | Contact your system administrator. Check the file status via CEMT.
  `"DSIDERR"` | Refer to the CICS Application Reference Manual. | Contact your system administrator.
  `"ILLOGIC"` | Refer to the CICS Application Reference Manual | Contact your system administrator.
  `"INVREQ"` | Refer to the CICS Application Reference Manual. | Contact your system administrator.
  `"IOERR"` | Refer to the CICS Application Reference Manual. | Contact your system administrator.
  `"LENGERR"` | Refer to the CICS Application Reference Manual. | Contact your system administrator.
  `"MAPFAIL"` | Refer to the CICS Application Reference Manual. | Contact your system administrator. Check the Mapset status via CEMT.
  `"NOSPACE"` | Refer to the CICS Application Reference Manual. | Contact your system administrator.
  `"NOTAUTH"` | Refer to the CICS Application Reference Manual. | Contact your system administrator.
  `"PGMIDERR"` | Refer to the CICS Application Reference Manual. | Contact your system administrator. Check the Program status via CEMT.
  `"RECORD NOT FOUND"` | The record selected is not in the file. | Verify the data you entered for the record key.
  `"SYSIDERR"` | Refer to the CICS Application Reference Manual. | Contact your system administrator.
  `"UNKNOWN ERROR"` | Refer to the CICS Application Reference Manual. | Contact your system administrator.

  TABLE OF CONTENTS | PREVIOUS TOPIC | INDEX