Previous	Next		Contents	Index	Glossary

procedure Listen

    (p_agent_name in varchar2);

Description

Monitors an agent for inbound event messages and dequeues messages using the agent's queue handler.

The standard WF_EVENT_QH queue handler sets the date and time when an event message is dequeued into the RECEIVE_DATE attribute of the event message. Custom queue handlers can also set the RECEIVE_DATE value if this functionality is included in the Dequeue API.

When an event is dequeued, the Event Manager searches for and executes any active subscriptions by the local system to that event with a source type of External, and also any active subscriptions by the local system to the Any event with a source type of External. If no active subscriptions exist for the event that was received (apart from subscriptions to the Any event), then Oracle Workflow executes any active subscriptions by the local system to the Unexpected event with a source type of External.

The Listen procedure exits after all event messages on the agent's queue have been dequeued.

Note: You can use the Check Setup web page to schedule Listen procedures for all active inbound and error queues. See: Scheduling Listeners for Local Inbound Agents.

Arguments (input)

p_agent_name

The name of the inbound agent.

See Also

Any Event

Unexpected Event

Wfagtlst.sql

Standard APIs for a Queue Handler

Copyright © 2002 Oracle Corporation.
All Rights Reserved.