[Top] [Previous]

# Appendix A . Error and Informational Messages

Most of the messages produced from Connect TCP for CICS are sent back to the remote TUXEDO Connect TPS Gateway and written to the ULOG on that system. Occasionally, messages are written directly to the CICS log configured specifically for Connect TCP for CICS. (See Chapter 4, "Configuring BEA Connect TCP for CICS," for more information on configuring the CICS log.)

## Messages Returned to the Remote Gateway

Message | Description
--- | ---
`BEA Connect for CICS server process initiated.` | The Handler process has been started.
`Welcome to BEA Connect MVS/CICS.` | The connect process has completed successfully.
`Goodbye.` | The disconnect process has completed successfully.
`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 Connect TCP for CICS gateway but has not yet established a login connection. (The connection request protocol was never sent.)
`BEA Connect MVS/CICS server is active.` | This message is returned to the remote TUXEDO gateway when a PING request is sent to the Connect TCP for CICS gateway from the tmadmin administration tool.
`Invalid password.` | The password specified in the Connect TPS configuration file does not match the password specified when the CICS supplied listener was configured.
`Invalid client account.` | The account code specified in the Connect TPS configuration file does not match the account code specified when the CICS supplied listener was configured.
`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 Connect TPS 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 Connect TPS configuration file for a transaction code that is unknown to CICS.

## Messages Written to the BEA Connect CICS Log

Message | Description
--- | ---
`RETRIEVE Failed RESP=hexcode RESP2=hexcode` | The CICS RETRIEVE command failed when it tried to access the buffer passed to the Connect TPS 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.
`TAKESOCKET Failed RC=rc ERRNO=errno` | The Connect TCP Handler was unable to take control of the TCP/IP socket.
`Socket SELECT Failed RC=rc ERRNO=errno` | The Sockets SELECT function failed.
`Socket READ Failed RC=rc 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.
`Client connected successfully.` | The client request is allowed because the account and password codes are authorized to use the Connect TCP Gateway.
`BEA Connect Server CTOS is shutting down.` | The Connect TPS Handler is shutting down.
`Verifying User Account.` | The Handler is verifying that the account and password codes supplied by Connect TPS on the remote TUXEDO Gateway are valid.
`Unauthorized Client Rejected.` | The client request will not be allowed because the account and/or password codes were not authorized.

## Codes Returned to a CICS Client Program

The following codes are returned to a CICS client program on return from a LINK to BEA Connect 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 BEA Connect TCP.
`BEA_ERR_CANCEL` | Value 8 A CICS Cancel error occurred in BEA Connect TCP.
`BEA_ERR_WAIT` | Value 9 A CICS Wait error occurred in BEA Connect 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 BEA Connect 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.

## 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.
`"INVALID PORT NUMBER OPTIONS=(1 -> 31936)"` | 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 -> 32767)
`"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 -> 31936)"` | 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 -> 32767)
`"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, C3, C5, R1, R2, R3, R4, R5, S1, S2, S3, S4, S5)"` | 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 Under_Score
`"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 Under_Score
`"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)"` | 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'. | Enter the appropriate STATUS.
`"NO CHANGE DONE ERROR OCCURED IN BEAPRERQ"` | An Error occurred in the Pre-Requester program. | Contact your system administrator.
`"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.

[Top] [Previous]