Restarting a Session from a Command Line

Running Integration Processes 20-13 ■ 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 restarted against a remote run-time agent identified by the AGENT_URL parameter. To restart 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: .restartloadplan.sh load_plan_instance_id -AGENT_ URL=agent_url On WINDOWS systems: restartloadplan.bat load_plan_instance_id -AGENT_ URL=agent_url Table 20–6 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.

20.8 Stopping a Load Plan Run

Any running or waiting Load Plan Run can be stopped. You may want to stop a Load Plan Run when you realize that for example your Load Plan contains errors or when the execution takes a long time. Note that there are two ways to stop a Load Plan Run: ■ Stop Normal : In normal stop mode, the agent in charge of stopping the Load Plan sends a Stop Normal signal to each agent running a session for this Load Plan. Each agent will wait for the completion of the current task of the session and then end the session in error. Exception steps will not be executed by the Load Plan and once all exceptions are finished the load plan is moved to an error state. ■ Stop Immediate : In immediate stop mode, the agent in charge of stopping the Load Plan sends a Stop immediate signal to each agent running a session for this Load Plan. Each agent will immediately end the session in error and not wait for the completion of the current task of the session. Exception steps will not be 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. Table 20–6 Restartloadplan Command Parameters Parameters Description load_plan_instance_id ID of the stopped or failed Load Plan instance that is to be restarted mandatory -AGENT_URL=agent_ url] URL of the Physical Agent that starts the Load Plan optional 20-14 Oracle Fusion Middleware Developers Guide for Oracle Data Integrator executed by the Load Plan and once all exceptions are finished the load plan is moved to an error state. Load Plans can be stopped in several ways: ■ Stopping a Load Plan from ODI Studio ■ Stopping a Load Plan Run from a Command Line ■ From a Web Service. See Section 20.11.6, Stopping a Load Plan Run Using a Web Service for more information. ■ From ODI Console. See Section 22.2.4, Managing Load Plans .

20.8.1 Stopping a Load Plan from ODI Studio

To stop a Load Plan Run from ODI Studio: 1. In Operator Navigator, select the running or waiting Load Plan Run to stop from the Load Plan Executions accordion.

2. Right-click then select Stop Normal or Stop Immediate.

3. In the Stop Load Plan Dialog, select the Agent that stops the Load Plan.

4. Click OK.

The Load Plan run is stopped and changed to Error status.

20.8.2 Stopping a Load Plan Run from a Command Line

Before stopping 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. ■ 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 signal is sent by a remote run-time agent identified by the AGENT_URL parameter. To stop a Load Plan run 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: .stoploadplan.sh load_plan_instance_id [load_plan_run_ count] -AGENT_URL=agent_url [-STOP_LEVEL=normal default | immediate] On WINDOWS systems: stoploadplan.bat load_plan_instance_id [load_plan_run_ count] -AGENT_URL=agent_url [-STOP_LEVEL=normal default | immediate] Table 20–7 lists the different parameters, both mandatory and optional. The parameters are preceded by the - character and the possible values are preceded by