Progress
External Program
Interfaces


Methods In the Message Consumer Object

Table C–2 provides a brief description of the methods in the Message Consumer object. For complete information and syntax, see the "Message Consumer Objects" section in "Accessing SonicMQ Messaging From the Progress 4GL"or the "4GL–JMS API Alphabetical Reference" section in this appendix.

Table C–2: Methods In the Message Consumer Object
Function or Procedure
Purpose

Procedure causes a message to be forwarded and acknowledged in a single, atomic operation.

Procedure ends the life of a Message Consumer.
Function returns application context information.
Function returns the name of the destination that messages arrive from when the message consumer was passed to subscribe or receiveFromQueue.
Function returns true if setNoAcknowledge was called.
Function returns the handle to a procedure that contains the name of an internal procedure for handling messages.
Function returns the name of the internal procedure for handling messages.
Function returns the values set by setReplyAutoDelete.
Function returns the setReplyPersistency value; it is PERSISTENT if setReplyPersistency was not called.
Function returns the setReplyPriority value; it is 4 if setReplyPriority was not called.
Function returns the setReplyTimeToLive value; it is UNKNOWN if setReplyTimeToLive was not called.
Function returns true if setReuseMessage was called; if not, it returns false.
Function returns a handle to the session.
Function returns true when called from a message handler if the application is handling an error message.
Function returns true when called from a message handler if the application is handling the data in a subscription (or queue) message.
Function returns true when called from a message handler if an application is handling a queue browsing message.
Function returns true when called from a message handler if an application is handling a reply message.
Procedure passes application context to the message handler.
Procedure instructs the 4GL–JMS implementation not to acknowledge this message.
Procedure sets the value for message persistency when the message consumer is passed to requestReply.
Procedure sets the priority of the reply messages when the message consumer is passed to requestReply.
Procedure sets the time to live value of the reply messages when the message consumer is passed to requestReply.
Procedure instructs the Message Consumer object not to create a new message for each received message.


Copyright © 2004 Progress Software Corporation
www.progress.com
Voice: (781) 280-4000
Fax: (781) 280-4095