Contents	Index	Glossary	Master Index	Feedback

When you schedule a listener for an agent, it starts monitoring the agent's queue on the run day you specify, dequeuing any inbound event messages. When an event message is received, 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.

The listener exits after all event messages on the agent's queue have been dequeued. Oracle Workflow reruns the listener indefinitely, at the interval you specify.

After you schedule a listener, you can modify its schedule by updating its settings. You can also stop a listener altogether by deleting it.

You must schedule listeners for the standard WF_DEFERRED and WF_ERROR agents to enable deferred subscription processing and error handling for the Business Event System, respectively. Also, if you want to use the standard WF_IN agent for event message propagation, schedule a listener for that agent as well.

Note: If you are using the version of Oracle Workflow embedded in Oracle Applications, you should use the Concurrent Manager to schedule listeners for your local inbound agents by submitting the Workflow Agent Listener concurrent program. Use the Check Setup web page only to review and verify your setup and to schedule propagations for your local outbound agents.

If you are using the version of Oracle Workflow embedded in Oracle Applications and you have implemented Oracle Applications Manager, you can use Oracle Workflow Manager to submit and manage the Workflow Agent Listener concurrent program. For more information, please refer to the Oracle Applications Manager online help.

If you are using the standalone version of Oracle Workflow available with Oracle9i Release 2, you can use the standalone Oracle Workflow Manager component available through Oracle Enterprise Manager to submit and manage Workflow agent listener database jobs. For more information, please refer to the Oracle Workflow Manager online help.

Note: You must not run an agent listener on the standard WF_SMTP_O_1_QUEUE agent. This agent is defined for the Notification Mailer SMTP queue and is not used by the Business Event System. See: Standard Agents.

See Also

Listen()

Workflow Agent Listener Concurrent Program

Wfagtlst.sql

To Schedule a Listener for a Local Inbound Agent

To Update or Delete a Listener

Copyright © 1996, 2002 Oracle Corporation.
All Rights Reserved.