Registering for Notification

Figure 11-13 Use Case Diagram: Registering for Notification

Text description of the illustration adq11qop5.gif

To refer to the table of all basic operations having to do with the Operational Interface see: "Use Case Model: Operational Interface -- Basic Operations"

Purpose

To register a callback for message notification.

Usage Notes

• 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 OCI_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: OCIAQListen(), OCISubscriptionDisable(), OCISubscriptionEnable(), OCISubscriptionUnRegister()

  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:

• PL/SQL (DBMS_AQ Package): Not available.

• C (OCI): Oracle Call Interface Programmer's Guide OCI Programming Advanced Topics, Publish-Subscribe Notification

• Visual Basic (OO4O) (Oracle Objects for OLE (OO4O) Online Help): From Help Topics, Contents tab, select OO4O Automation Server > OBJECTS > OraAQ Object > Monitoring Messages

• Java (JDBC): Not available.

Examples

See Chapter 3, "AQ Programmatic Environments" for a list of available functions in each programmatic environment. Examples in the following programmatic environments are provided:

• C (OCI): Register for Notifications For Single-Consumer and Multi-Consumer Queries