Describes deprecated Oracle Streams Advanced Queuing functions.
Table E-8 lists the deprecated Streams Advanced Queuing functions that are described in this section.
Table E-8 Deprecated Streams Advanced Queuing Functions
Function | Purpose |
---|---|
Listen on one or more queues on behalf of a list of agents. |
This function was deprecated in a release previous to Oracle Database 11g Release 2 (11.2).
Purpose
Listens on one or more queues on behalf of a list of agents. This function is deprecated. UseOCIAQListen2()
.
Syntax
sword OCIAQListen (OCISvcCtx *svchp, OCIError *errhp, OCIAQAgent **agent_list, ub4 num_agents, sb4 wait, OCIAQAgent **agent, ub4 flags);
Parameters
The service context handle.
An error handle that you can pass to OCIErrorGet() for diagnostic information when there is an error.
List of agents for which to monitor messages.
Number of agents in the agent list.
Timeout interval for the listen call.
Agent for which there is a message. OCIAgent
is an OCI descriptor.
Not currently used; pass as OCI_DEFAULT
.
Comments
This is a blocking call that returns when there is a message ready for consumption for an agent in the list. If there are no messages found when the wait time expires, an error is returned.