|Oracle Call Interface Programmer's Guide
Release 2 (9.2)
Part Number A96584-01
More OCI Relational Functions, 46 of 106
Listens on one or more queues on behalf of a list of agents.
sword OCIAQListen (OCISvcCtx *svchp, OCIError *errhp, OCIAQAgent **agent_list, ub4 num_agents, sb4 wait, OCIAQAgent **agent, ub4 flags);
The service context handle.
An error handle you can pass to
OCIErrorGet() for diagnostic information in the event of an error.
List of agents for which to monitor messages.
Number of agents in the agent list.
Time-out for the listen call.
Agent for which there is a message. OCIAgent is an OCI descriptor.
Not currently used; pass as OCI_DEFAULT.
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.