procedure setNavigationParams (p_agentName in varchar2 default null, p_navigationThreshold in number default 0);
Sets the navigation parameters for dequeuing messages from an agent's queue, including the agent name and navigation threshold. The navigation threshold is the maximum number of messages the agent listener should dequeue before resetting its navigation to the FIRST_MESSAGE option.
setNavigationParams() is typically used in a queue handler before a loop that dequeues several messages from an agent's queue. For example, you can call this procedure before calling WF_EVENT.Listen(). For more information about dequeuing messages, see: Oracle Streams Advanced Queuing User's Guide.
| p_agentName | The internal name of the agent. |
| p_navigationThreshold | The maximum number of messages the agent listener should dequeue before resetting its navigation to the FIRST_MESSAGE option. This parameter does not apply for queues that are enabled for transactional grouping. |