Error and Informational Messages

The following topics describe TMA TCP for CICS messages:

•	Messages Returned to the Remote Gateway

•	Messages Written to the TMA 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

Most of the messages produced from Oracle Tuxedo Mainframe for TCP (CICS) (hereafter referenced as TMA TCP for CICS) are sent back to the remote TMA TCP gateway and written to the ULOG on that system.

 

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

Occasionally, messages are written directly to the CICS log configured specifically for TMA TCP for CICS. For more information about configuring the CICS log, refer to the “Configuring and Administering Oracle TMA TCP for CICS” section.

 

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 TMA 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 TMA TCP gateway configuration file does not match the password specified when the CICS supplied listener was configured.
Invalid client account.	The account code specified in the TMA TCP gateway 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 TMA TCP gateway 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 TMA 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 TMA TCP gateway.
BEA TMA TCP Server CTOS is shutting down.	The TMA TCP gateway Handler is shutting down.
Verifying User Account.	The Handler is verifying that the account and password codes supplied by TMA TCP gateway on the remote Tuxedo gateway are valid.
Handler initialization complete.	The TMA TCP Handler has successfully initialized.
Normal shutdown requested, x requests pending.	The TMA TCP Handler shuts down after the currently pending requests complete.
Handler exceeded maximum idle time.	The TMA TCPHandler has exceeded the configured IDLE TIME.
BEA TMA TCP Handler is shutting down.	The TMA TCP Handler is shutting down.
Client disconnected.	The client has been disconnected from the TMA 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 user ID sent with a request by the client does not match the user ID 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.
LMID is disabled. Auto enabling LMID ,LMID name>	The pre-requester is dynamically enabling an LMID which is disabled. This message will be displayed only when the AUTO ENABLE option is set to E.

Codes Returned to a CICS Client Program

The following codes are returned to a CICS client program on return from a LINK to TMA 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 The service that was called cannot be found in the outbound service table.
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 TMA TCP.
BEA_ERR_CANCEL	Value 8 A CICS Cancel error occurred in TMA TCP.
BEA_ERR_WAIT	Value 9 A CICS Wait error occurred in TMA 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 TMA 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 underscore.
"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 underscore.
"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 (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 (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).Must not start with a space, null, or underscore 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 underscore 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 underscore.
"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, 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 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 underscore.
"INVALID STATUS OPTIONS=(E ENABLE, D DISABLE, A ABORT)"	The STATUS entered is not valid.	Enter a valid STATUS. See OPTIONS=.
"INVALID OPTION=(E ENABLE, D DISABLE)"	The AUTO ENABLE LMID (E|D) option entered is not valid or is empty.	Enter a valid option (E or D).
"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.