Progress
External Program
Interfaces


subscribe

In Session Objects

This procedure subscribes to topicName. The messages are handled asynchronously by the messageConsumer object. A subscriptionName parameter with a value other than UNKNOWN specifies a durable subscription. Durable subscriptions require the JMS client to have a clientID identifier. The client must call setClientID in the pubsubsession object (or set the default clientID on the server side) if a durable subscription is desired. If the subscriptionName value is UNKNOWN or an empty string, the subscription is not durable. The default of noLocalPublications is false. The session, by default, get its own publications:

SYNTAX
PROCEDURE subscribe. 
DEFINE INPUT PARAMETER topicName AS CHAR. 
DEFINE INPUT PARAMETER subscriptionName AS CHAR.  
DEFINE INPUT PARAMETER messageSelector AS CHAR.    
DEFINE INPUT PARAMETER noLocalPublications AS LOGICAL.  
DEFINE INPUT PARAMETER messageConsumer AS HANDLE.  

NOTE: This procedure executes remotely (sends a message to the SonicMQ Adapter).

For information on this procedure in context, see the "Subscribing To a Topic" section in Accessing SonicMQ Messaging From the Progress 4GL."


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