| Previous | Next |  | Contents | Index | Glossary

## Checking the Business Event System Setup

Use the Check Setup web page to verify that the required parameters and components have been set up to enable message propagation for the Business Event System.

#### To Check the Business Event System Setup

1. Use a web browser to connect to the following URL:

    	<webagent>/wf_setup.check_all

Replace `<webagent>` with the base URL of the web agent configured for Oracle Workflow in your Web server. See: Setting Global User Preferences.

> Attention: This URL accesses a secured page, so if you have not yet logged on as valid user in the current web session, you will be prompted to do so before the page appears. You must have workflow administrator privileges to access the Event Manager web pages.

> Note: You can also access the Check Setup web page from the Oracle Workflow home page. See: Accessing the Oracle Workflow Home Page.

2. The Check Setup page appears, displaying the propagation settings and components for your local system.

3. Use the Database Init.ora Parameters region to verify your settings for the database initialization parameters related to AQ. The Check Setup page displays the actual value defined for each parameter as well as the minimum recommended value for Oracle Workflow.

> Note: Setting the init.ora parameters is completed as part of the Oracle Workflow installation steps. After any change to the init.ora parameters, you must restart your database to make the change effective.

- AQ_TM_PROCESSES--This parameter enables the time manager process in Oracle8i Advanced Queuing (AQ). The time manager process is required by Oracle Workflow to monitor delay events in queues, as in the case of the Oracle Workflow standard Wait activity. The minimum recommended number of time manager processes for Oracle Workflow is one.

- JOB_QUEUE_INTERVAL--Specify the job queue interval to determine how frequently each SNP job queue process in your instance wakes up. Oracle Workflow requires the job queue interval to be less than or equal to the latency parameter defined for your AQ propagation schedules, to allow queues to be rechecked for messages with the specified latency. The recommended job queue interval for Oracle Workflow is five seconds.

- JOB_QUEUE_PROCESSES--This parameter defines the number of SNP job queue processes for your instance. Oracle Workflow requires job queue processes to handle propagation of Business Event System event messages by AQ queues. You must start at least one job queue process to enable message propagation. The minimum recommended number of processes for Oracle Workflow is two.

> Note: You can use another initialization parameter, EVENT, for detailed database level tracing of issues related to AQ. Add the following line to your init.ora file:

    		  event = "24040 trace name context forever, level 10"

> Then restart your database to make this change effective. Be aware that using this parameter may generate large trace files.

4. Use the Database Links region to verify your database links. The Check Setup page displays the name and status of each database link. You should create any required database links that do not yet exist. See: Creating Database Links.

5. Use the Local Agents region to verify the queues that are set up for the agents defined on your local system. The Check Setup web page displays the name and direction of each agent, the name of the queue assigned to the agent, whether or not the queue has been created, how many messages on the queue have been processed and are ready to be consumed, and how many messages are still waiting to be processed. You should create any required queues that do not yet exist. See: Agents and Setting Up Queues.

6. Use the Listeners for Local Inbound Agents region to schedule listeners to receive inbound event messages. See: Scheduling Listeners for Local Inbound Agents.

7. Use the Propagations for Local Outbound Agents region to schedule propagations to send event messages. See: Scheduling Propagations for Local Outbound Agents.

### See Also

Oracle8i Reference

Oracle8i Application Developer's Guide - Advanced Queuing

| Previous | Next |  | Contents | Index | Glossary