Executing a Scenario from a Command Line

20-10 Oracle Fusion Middleware Developers Guide for Oracle Data Integrator

20.6 Executing a Load Plan

Load Plans can be executed in several ways: ■ Executing a Load Plan from ODI Studio ■ Executing a Load Plan from a Command Line ■ From a Web Service. See Section 20.11.5, Executing a Load Plan Using a Web Service for more information. ■ From ODI Console. See Section 22.2.4, Managing Load Plans .

20.6.1 Executing a Load Plan from ODI Studio

In ODI Studio, you can run a Load Plan in Designer Navigator or in Operator Navigator. To run a Load Plan in Designer Navigator or Operator Navigator: 1. In the Load Plans and Scenarios accordion, select the Load Plan you want to execute.

2. Right-click and select Execute.

3. In the Start Load Plan dialog, select the execution parameters: ■ Select the Context into which the Load Plan will be executed. ■ Select the Logical Agent that will run the step. ■ In the Variables table, enter the Startup values for the variables used in this Load Plan.

4. Click OK.

5. The Load Plan Started Window appears.

6. Click OK.

A new execution of the Load Plan is started: a Load Plan instance is created and also the first Load Plan run. You can review the Load Plan execution in the Operator Navigator.

20.6.2 Executing a Load Plan from a Command Line

You can start a Load Plan from a command line. Before executing a Load Plan from a command line, read carefully the following requirements: ■ The command line scripts, which are required for performing the tasks described in this section, are only available if you have installed the Oracle Data Integrator Standalone Agent. See the Oracle Fusion Middleware Installation Guide for Oracle Data Integrator for information about how to install the Standalone Agent. Note: To use this command the connection to your repository must be configured in the odiparams file. See Section 4.3, Managing Agents for more information. Note: A Load Plan cannot be executed using the ODI Studio built-in agent called Local No Agent. Running Integration Processes 20-11 ■ To use this command, the connection to your repository must be configured in the odiparams file. See Chapter 4.3, Managing Agents for more information. ■ A Load Plan Run is started against a run-time agent identified by the AGENT_URL parameter. To start a Load Plan from a command line: 1. Change directory to agentbin directory of the Oracle Data Integrator installation. 2. Enter the following command to start a Load Plan. On UNIX systems: .startloadplan.sh load_plan_name context_code -AGENT_ URL=agent_url [-KEYWORDS=keywords] [variable=value] On WINDOWS systems: startloadplan.bat load_plan_name context_code -AGENT_ URL=agent_url [-KEYWORDS=keywords] [variable=value] Table 20–5 lists the different parameters, both mandatory and optional. The parameters are preceded by the - character and the possible values are preceded by the = character. You must follow the character protection syntax specific to the operating system on which you enter the command. Note: On Windows platforms, it is necessary to delimit the command arguments containing = signs or spaces, by using double quotes. The command call may differ from the Unix command call. For example: On UNIX systems: .startloadplan.sh DWLoadPlan DEV -AGENT_ URL=http:localhost:20910oraclediagent On WINDOWS systems: startloadplan.bat DWLoadPlan DEV -AGENT_ URL=http:localhost:20910oraclediagent Table 20–5 Startloadplan Command Parameters Parameters Description load_plan_name Name of the Load Plan to be started mandatory context_code Code of the context used for starting the Load Plan. Note that if this value is not provided, the Load Plan uses the context of the session that calls it mandatory -AGENT_URL=agent_ url URL of the Physical Agent that starts the Load Plan mandatory [-KEYWORDS=Keywords ] Keywords to improve the organization of ODI logs by session folders and automatic classification. Enter a comma separated list of keywords that will be attached to this Load Plan. 20-12 Oracle Fusion Middleware Developers Guide for Oracle Data Integrator

20.7 Restarting a Load Plan Run

Restarting a Load Plan, starts a new run for the selected Load Plan instance. Note that when a Load Plan restarts the Restart Type parameter for the steps in error defines how the Load Plan and child sessions will be restarted. See Section 14.2.4.3, Defining the Restart Behavior and Section 20.4, Restarting a Session for more information.