Configuring the Task Processor to Run in the Background

Overview

You can configure the Task Processor so that it runs as a background task on the server. When configured to run as a background task the Task Processor is not reliant on the Administrator or Task Processor workstation interface. When you use the background method you can control the Task Processor from outside of Financial Analyzer.

Procedure: Configuring the Task Processor to run in the background

Use the following procedure to configure the Task Processor to run in the background. Follow this procedure for each instance of Express Server for which you want to run a Task Processor in the background.

1. Start Oracle Express Instance Manager.

2. Select the Session tab.

3. In the Category box, select Initial Session, then specify the following settings:

   ShutDownSPLScript=oecnn/taskstop.inf
SPLScriptLogging=NO
StartupSPLScript=oecnn/taskini.inf
WakeupMilliseconds=30000
WakeupSPLScript=oecnn/taskrun.inf

   Note: The WakeupMilliseconds setting determines how often the server checks whether the tkstop.flg file is present in the taskfile directory. Oracle Corporation recommends a setting of 30000 milliseconds, which is equal to 10 seconds.

4. Choose Set.

5. Choose OK.

6. In the Express Server Client Support File directory, open the file tkserver.ini and add the location and name of the Task Processor initialization file (ofabgrtk.cfg) for each Administrator.

   Example:

   oracle_home/olap/super/shared/ofabgrtk.cfg

   or

   oracle_home/olap/subdba/shared/ofabgrtk.cfg

   Note: On NT, you must use forward slashes for drive paths.

7. Access the Administrator workstation and add the Persistent Session Initialize username as a valid administrator user.

   Notes: The default values for the Initialize user name are:

   • For the NT operating system: OESinit

   • For Unix operating system: oesinit

8. Run the Task Processor in the foreground to process the username change.

9. Ensure that the Persistent Session Initialize user name has write access to the Financial Analyzer shared directory.

10. Restart Express Server to activate these new settings.

    Once Express Server has been restarted, the Task Processor will initialize on the server in the background. Therefore, anything sent to the Task Processor in Financial Analyzer will be processed immediately.

Using the Task Processor directly on the server

You can start the Task Processor directly on the server by renaming or removing the tkstop.flg file in the taskfile directory. To stop the Task Processor directly on the server, put the tkstop.flg file back in place in the taskfile directory.

Related information

For information about running the Task Processor, refer to the topic "Running the Task Processor in Background Mode," in the Financial Analyzer Help system.