Agent Listeners

The Oracle Workflow Business Event System requires agent listeners to be scheduled to receive inbound event messages. An agent listener monitors a Business Event System agent for incoming messages and dequeues messages using the agent's queue handler. You should run agent listeners for your local inbound agents.

When an event message is dequeued, the Event Manager begins subscription processing for the event. 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 agent listener exits after all event messages on the agent's queue have been dequeued.

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.

Running Agent Listeners

You run an agent listener for an agent by submitting the Workflow Agent Listener concurrent program (FNDWFLST). You must specify the agent that you want to monitor. You can submit the Workflow Agent Listener concurrent program several times to schedule agent listeners for different agents.

Navigation: Applications Dashboard > (pull-down menu) Workflow Manager > (B) Go

Parameters

When you submit the Workflow Agent Listener concurrent program, specify the following parameter.

Agent Name

Specify the name of the agent that you want to monitor for inbound event messages.

Viewing Concurrent Requests

When you view the Workflow Agent Listener concurrent requests, the Search Results page shows standard request detail information for these requests. For each request, the list displays the request ID, program short name, description, application short name, phase, status, requestor, duration, and wait time. Click a column heading to sort the list by that column.

Navigation: Applications Dashboard > (pull-down menu) Workflow Manager > (B) Go > Agent Listener