Handles incoming JMS and error messages.

Syntax

PROCEDURE messageHandler.
DEFINE INPUT PARAMETER message AS HANDLE.      
DEFINE INPUT PARAMETER messageConsumer AS HANDLE. 
DEFINE OUTPUT PARAMETER reply AS HANDLE.

Parameters

message
The message.
messageConsumer
The Message Consumer object that contains this message handler. The application can use the Message Consumer object to get context information about the message (for example, the session handle to the session that received that message) and the context (for example, the session handler).
reply
A handle to the reply message, if any. The application can reply to the message automatically without having to extract the reply to fields. The application can set the reply parameter with a reply message, which is automatically sent to the JMSReplyTo destination of the message. If the setReplyAutoDelete procedure(true) Message Consumer procedure is called, the reply message is automatically deleted after being sent.

Applies to

Message objects

Notes

  • The message handler is written by an application and must be registered with a Message Consumer object.
  • When a message is received, the message handler is called automatically so the application can process the message.

See also

createMessageConsumer procedure, deleteConsumer procedure, messageHandler procedure, waitForMessages procedure

For more information see the Message Consumer objects, the Consuming messages, the Terminating the Message Consumer object, and the Creating a message handler process.