"To Create or Update an Agent (Oracle Workflow Developer's Guide)

Oracle Workflow Developer's Guide
Release 2.6.3
Part Number B10284-02


	Previous	Next		Contents	Index	Glossary

To Create or Update an Agent

1. Navigate to the Create Agent page or to the Update Agent page. The Create Agent page and the Update Agent page are identical, except that the fields in the Update Agent page are populated with previously defined information for the selected agent.

Note: You should not use the Create Agent page to create agent definitions for inbound agents on external systems that have Oracle Workflow installed. Instead, you should use the External System Registration page to automatically register the system identifier information for that external system, including inbound agent definitions. See: Registering External Systems.

2. Enter the internal name of the agent in the Name field. The agent's internal name must be unique within the agent's system.

Attention: The internal name must be all-uppercase and should not include any single or double quotation marks (' or ") or spaces.

3. Enter a display name for the agent.

4. Enter an optional description for the agent.

5. Select the message communication protocol that the agent supports.

6. If the agent supports inbound communication to its system, enter the address for the agent. The format of the address depends on the protocol you select.

For agents that use the SQLNET protocol, the address must be in the following format to enable AQ propagation:

 <schema>.<queue>@<database link>

<schema> represents the schema that owns the queue, <queue> represents the queue name, and <database link> represents the database link to the instance where the queue is located.

Note: You must enter the database link name exactly as the name was specified when the database link was created. See: Creating Database Links, Oracle Workflow Administrator's Guide.

7. Select the system in which the agent is defined. Select the field's search icon to display a list of values from which to choose. You can search by the system internal name or display name. See: Using a List of Values.

8. Enter the queue handler for the agent. The queue handler is the PL/SQL package that translates between the Workflow event message format (WF_EVENT_T) and the message format required by the queue associated with the agent. See: Standard APIs for a Queue Handler.

Enter the queue handler in the following format:

 <package_name>

Attention: You must enter the queue handler name in all uppercase.

Note: For an agent that is not implemented as a queue, such as an agent on a non-Oracle system, you can leave the Queue Handler field blank.

9. Enter the name of the queue that the local system uses to interact with the agent. Since only the local system refers to this queue name, the queue name should be within the scope of this system, without requiring a database link. Use the following format to specify the queue name:

 <schema>.<queue>

<schema> represents the schema that owns the queue, and <queue> represents the queue name.

Attention: You must enter the queue name in all uppercase.

Note: For an agent that is not implemented as a queue, such as an agent on a non-Oracle system, you can leave the Queue field blank.

10. In the Direction field, select In for an agent that supports inbound communication to its system, or select Out for an agent that supports outbound communication from its system.

11. Select Enabled or Disabled as the agent status. If you disable an agent, its definition remains in the Event Manager for reference, but you cannot use the agent in active subscriptions.

12. Select the Apply button to save the agent. You can also select the Cancel button to return to the previous page without saving the agent.


	Previous	Next		Contents	Index	Glossary