function getQueueNavigation return BINARY_INTEGER;
Returns the next dequeue navigation option that should be used, such as FIRST_MESSAGE, NEXT_MESSAGE, and so on. This function is typically used in a queue handler to obtain the appropriate navigation option just before dequeuing.
To ensure that the agent listener parameter NAVIGATION_RESET_THRESHOLD takes effect when you use a custom queue handler, you should call setNavigationParams() to set the dequeue navigation parameters before starting a loop to dequeue messages from a queue, and then call WF_EVENT.getQueueNavigation() before dequeuing to ensure that you use the appropriate navigation option.
For more information about dequeuing messages, see: Oracle Streams Advanced Queuing User's Guide. For more information about the NAVIGATION_RESET_THRESHOLD parameter, see: Scheduling Listeners for Local Inbound Agents.