Previous | Next | Contents | Index | Glossary |
Note: These 'Outbound' and 'Inbound' queues are separate from the queues used for the Business Event System. See: Workflow Queue APIs.
After a Java function completes, you must run a background engine to process the 'Inbound' queue and complete the function activity. See: Setting Up Background Engines.
Some standard Workflow activities are external Java function activities and require the Java Function Activity Agent. You can also define your own external Java function activities. See: Standard Activities, To Create a Function Activity, and Standard API for Java Procedures Called by Function Activities.
To run the Java Function Activity Agent, you must have Java Runtime Environment (JRE) Version 1.1.8, or a higher 1.1.x version, installed.
Note: The Java Runtime Environment is available for download from http://www.javasoft.com.
Context: You need to perform this step only once.
To start the Java Function Activity Agent manually, run JRE against oracle.apps.fnd.wf.WFFALsnr, specifying your CLASSPATH and the user name and password of your Oracle Workflow database account.
The CLASSPATH must point to the Java Runtime Environment, the directory containing the Workflow JAR files, the Oracle XML parser, the Oracle JDBC implementation, and the following Workflow JAR files:
Note: If you are using the standalone version of Oracle Workflow with Oracle9i, the Workflow JAR files are located in the <ORACLE_HOME>/jlib directory. If you are using the version of Oracle Workflow embedded in Oracle Applications, the Workflow JAR files are located in the <ORACLE_HOME>/wf/java/oracle/apps/fnd/wf/jar/ directory.
If you define your own external Java function activities, you must also include the JAR files containing your custom Java classes in the CLASSPATH. The custom class files should reside on the same platform where the Java Function Activity Agent is run. The Java Function Activity Agent does not need to reside on the same tier as the database, however.
For example, on UNIX, use the following command to start the Java Function Activity Agent:
jre -classpath "$<JREPATH>/rt.jar:$<Workflow_JAR_file_directory>:
$<Workflow_JAR_file_directory>/wfjava.jar:$<ORACLE_HOME>/wf/
xml/java/lib/xmlparserv2.jar:$<Workflow_JAR_file_directory>/wfapi.jar:$<ORACLE_HOME>/jdbc/lib/classes111.zip:
$<Workflow_JAR_file_directory>/<Share_JAR_file>:
$<Workflow_JAR_file_directory>/<Ewt_JAR_file>:
$<Workflow_JAR_file_directory>/<Swing_JAR_file>:" oracle.apps.fnd.wf.WFFALsnr <user_name>/<password>@<connect_string>
On Windows NT, use the following command:
jre -classpath ";<JREPATH>\rt.jar;<Workflow_JAR_file_directory>;
<Workflow_JAR_file_directory>\wfjava.jar;<ORACLE_HOME>\wf\
xml\java\lib\xmlparserv2.jar;<Workflow_JAR_file_directory>\
wfapi.jar;<ORACLE_HOME>\jdbc\lib\classes111.zip;
<Workflow_JAR_file_directory>\<Share_JAR_file>;
<Workflow_JAR_file_directory>\<Ewt_JAR_file>;
<Workflow_JAR_file_directory>\<Swing_JAR_file>;"
-nojit oracle.apps.fnd.wf.WFFALsnr <user_name>/<password>@<connect_string>
If you are using the standalone version of Oracle Workflow, sample scripts are provided called wfjvlsnr.csh and wfjvlsnr.bat which you can modify to run the Java Function Activity Agent on UNIX or on Windows NT, respectively. These scripts are located on your server in the Oracle Workflow admin subdirectory. Before you can use these sample scripts, you must edit them to include the actual directory paths to your Oracle Home and to the JRE rt.jar file. Also, if you define your own external Java function activities, you must include the path to the JAR files containing your custom Java classes. Then you can run the scripts with the user name and password of your Oracle Workflow database account to submit the Java Function Activity Agent. For example, on UNIX, use the following command:
wfjvlsnr.csh <user_name>/<password>@<connect_string>
On Windows NT, use the following command:
wfjvlsnr.bat <user_name>/<password>@<connect_string>
Note: If you are running more than one Java Function Activity Agent simultaneously, you must run the wfjvstop.sql script once for each Java Function Activity Agent.
Previous | Next | Contents | Index | Glossary |