Advanced Queuing - Oracle

Registering for Notification
See Also:
Purpose
To register a callback for message notification.
Usage Notes
Table 11–1 for a list of operational interface basic operations
"Registering for Notification [Specifying Subscription
Name—Single-Consumer Queue]" on page 11-58
"Registering for Notification [Specifying Subscription
Name—Multiconsumer Queue]" on page 11-59
This call is invoked for registration to a subscription which identifies the
subscription name of interest and the associated callback to be invoked. Interest
in several subscriptions can be registered at one time.
This interface is only valid for the asynchronous mode of message delivery. In
this mode, a subscriber issues a registration call which specifies a callback.
When messages are received that match the subscription criteria, the callback is
invoked. The callback may then issue an explicit message_receive (dequeue)
to retrieve the message.
The user must specify a subscription handle at registration time with the
namespace attribute set to LNOCI_SUBSCR_NAMESPACE_AQ.
The subscription name is the string ’schema.queue’ if the registration is for a
single-consumer queue and ’schema.queue:consumer_name’ if the
registration is for a multiconsumer queues.
Related Functions: LNOCIAQListen(), LNOCISubscriptionDisable(),
LNOCISubscriptionEnable(), LNOCISubscriptionUnRegister()
For more information about the OCI operation Register for
Notification see:
Oracle Call Interface Programmer’s Guide
Syntax
See Chapter 3, "AQ Programmatic Environments" for a list of available functions in
each programmatic environment. Use the following syntax references for each
programmatic environment:
11-56 Oracle9i Application Developer’s Guide - Advanced Queuing