Message Class 0003 - EntireX ACI - Conversation Ended

This page describes messages with message class 0003. The messages have the format:

0003nnnn

where 0003 is the message class, and
nnnn is the message number in the range 0000 - 9999.

This message class indicates the conversation has ended for the following reasons:

  1. The partner issued an EOC or a DEREGISTER operation.

  2. A timeout occurred for the partner (defined by either CLIENT-NONACT or SERVER-NONACT) or the conversation (defined by CONV-NONACT). All resources allocated for the conversation are released.

This document covers the following topics:

Overview of Messages

00030003 | 00030005 | 00030010 | 00030011 | 00030012 | 00030067 | 00030073

00030003 No Matching Conversation Found
Explanation

The conversation cannot be found, or no request is available for processing. This response is returned when:

  1. The wrong conversation ID is specified.

  2. A server issued a non-blocked RECEIVE with CONV-ID=NEW/ANY and no conversation or request is available for processing.

  3. Neither the client nor the server has accessed the conversation for the specified timeout period. The conversation is timed out and does not exist anymore (if a conversation timeout occurs while users are waiting, they are informed with error code 0073). For the Broker, timeout is specified by the CONV-NONACT parameter in the attribute file.

Action

Situation 1 is a user error. Check the program and correct the error.

For situation 2, contact the administrator and check the value supplied for CONV-NONACT. It may have to be increased. However, be sure not to supply too high a value as this can lead to resources being used for a long period of time.

For situation 3, this is an information-type message. How the program continues depends on the application.


00030005 Partner finished the conversation
Explanation

The partner has ended of the conversation by either an EOC or DEREGISTER with OPTION=IMMED. This response is returned when:

  1. The user has retrieved all the data/messages sent by the partner with RECEIVE calls and has attempted to get further data/message with a RECEIVE using the OPTION=NEXT. No more messages are available from the partner.

  2. A function other than RECEIVE is issued and the partner has already ended the conversation.

Action

This is an informational message. How the program continues depends on the application. Messages from the partner not yet received can be received with subsequent RECEIVE calls, that is, when the conversation end is detected by a call other than RECEIVE, it is possible that messages from the partner exist.


00030010 EOC due to DEREGISTER of partner
Explanation

This error comes as the result of a receive function. The particular conversation is already closed because the partner application has DEREGISTERed. This information is intended to tell an application the reason for an EOC:
DEREGISTER of the partner,
LOGOFF of the partner, or
EOC with cancel of the partner

Action

If possible, back out all actions taken for that conversation, since the end does not appear to be graceful.


00030011 Partner cancelled the conversation
Explanation

The partner marked the conversation as cancelled with the EOC operation.

Action

If possible, back out all actions taken for the conversation.


00030012 EOC due to LOGOFF of partner
Explanation

This error results from an attempted receive on a conversation that is already closed because the partner application performed a LOGOFF.

Action

If possible, back out all actions taken for the conversation.


00030067 Partner timeout occurred
Explanation

The partner for the conversation is no longer active. All conversations with this partner are terminated. This occurs when the partner has not issued a call to EntireX Broker for the time defined by either CLIENT-NONACT or SERVER-NONACT. Error code 0002 is returned to the partner when it attempts to access any of its previous conversations.

Action

If this happens repeatedly, contact the administrator and check the value supplied for CLIENT-NONACT or SERVER-NONACT. It may need to be increased. However, do not supply too high a value, as this can lead to resources being used for a long period of time.


00030073 Conversation timeout occurred
Explanation

The timeout defined for the conversation has elapsed without the partner issuing a Broker call against the conversation and therefore the conversation has ended. For the Broker, timeout is specified by the CONV-NONACT value for the service in the attribute file.

Action

Check the following causes:

  • Ensure that the partner is working correctly.

  • Contact the administrator and check the settings of the non-activity timeout. You may need to increase the timeout value. Do not supply too high a value, however, as this can lead to resources being used for a long period of time.