Executing a Load Plan from a Command Line

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

2. Select New Scheduling. The Scheduling editor is displayed.

3. On the Definition tab of the Scheduling editor specify the parameters as follows:

The Status parameters define the activation of the schedule. The Execution parameters define the frequency of execution for each execution cycle.

4. On the Execution Cycle tab, specify the parameters for the repeat mode of the

scenario as follows:

5. On the Variables tab, unselect Latest Value for variables for which you want to

provide a Value. Only variables used in the scenario or Load Plan and flagged as parameters for this scenario or Load Plan appear in this tab. Properties Description Context Context into which the scenario or Load Plan is started. Agent Agent executing the scenario or Load Plan. Log Level Level of logging information to retain. Properties Description Active The scheduling will be active when the agent is restarted or when the scheduling of the physical agent is updated. Inactive The schedule is not active and will not run. Active for the period Activity range of the schedule. A schedule active for a period of time will only run within this given period. Properties Description Execution Frequency of execution option annual, monthly,... simple. This option is completed by a set of options that depend on this main option. Properties Description None Execute once The scenario or Load Plan is executed only one time. Many times The scenario or Load Plan is repeated several times. ■ Maximum number of repetitions : The maximum number of times the scenario is repeated during the cycle. ■ Maximum Cycle Duration: As soon as the maximum time is reached, the scenario is no longer restarted, and the cycle stops. ■ Interval between repetitions: The downtime between each scenario execution. Constraints Allows limitations to be placed on one cycle iteration, in the event of a problem during execution. ■ Number of Attempts on Failure : Maximum number of consecutive execution attempts for one iteration. ■ Stop Execution After : Maximum execution time for one iteration. If this time is reached, the scenario or Load Plan is automatically stopped. Running Integration Processes 20-17

6. From the File menu, click Save.

The new schedule appears under the Scheduling node of the scenario or Load Plan. The schedule changes are taken into account by the run-time agent when it starts or when it receives a schedule update request.

20.9.1.2 Updating an Agent’s Schedule

An agent reads schedules when starting on all the repositories attached to the master repository it connects to. It is possible, if a schedule was added for this agent in a given repository, to refresh the agent schedule. To update an agent’s schedule:

1. In Topology Navigator expand the Agents node in the Physical Architecture

accordion.

2. Select the Physical Agent you want to update the schedule.

3. Right-click and select Update Scheduling...

4. In the Select Repositories dialog, select the repositories from which you want to

read scheduling information. Check Select All Work Repositories to read scheduling information from all these repositories.

5. Click OK.

The agent refreshes and re-computes its in-memory schedule from the schedules defined in these repositories. You can also use the OdiUpdateAgentSchedule tool to update an agent’s schedule.

20.9.1.3 Displaying the Schedule

You can view the scheduled tasks of all your agents or you can view the scheduled tasks of one particular agent. Displaying the Schedule for All Agent To display the schedule for all agents: 1. Select Connect Navigator Scheduling... from the Operator Navigator toolbar menu. The View Schedule dialog appears, displaying the schedule for all agents. Displaying the Schedule for One Agent To display the schedule for one agent:

1. In Topology Navigator expand the Agents node in the Physical Architecture

accordion. 2. Select the Physical Agent you want to update the schedule.

3. Right-click and select View Schedule.

The Schedule Editor appears, displaying the schedule for this agent. Note: The Scheduling Information is retrieved from the Agents in-memory schedule. The Agent must be started and its schedule refreshed in order to display accurate schedule information. 20-18 Oracle Fusion Middleware Developers Guide for Oracle Data Integrator Using the View Schedule Dialog The schedule is displayed in form of a Gantt diagram. Table 20–8 lists the details of the Schedule dialog. If you select a zone in the diagram keep the mouse button pressed, you automatically zoom on the select zone. By right-clicking in the diagram, you open a context menu for zooming, saving the diagram as an image file, printing or editing the display properties.

20.9.2 Scheduling a Scenario or a Load Plan with an External Scheduler

To start a scenario or a Load Plan with an external scheduler, do one of the following: ■ Use the startscen or startloadplan command from the external scheduler ■ Use the web service interface for triggering the scenario or Load Plan execution For more information, see: ■ Section 20.3.2, Executing a Scenario from a Command Line ■ Section 20.11.2, Executing a Scenario Using a Web Service ■ Section 20.6.2, Executing a Load Plan from a Command Line ■ Section 20.11.5, Executing a Load Plan Using a Web Service If a scenario or a Load Plan completes successfully, the return code will be 0. If not, the return code will be different than 0. This code will be available in: ■ The return code of the command line call. The error message, if any, is available on the standard error output. ■ The SOAP response of the web service call. The web service response includes also the session error message, if any. Note: The Scheduling Information is retrieved from the Agents schedule. The Agent must be started and its schedule refreshed in order to display accurate schedule information. Table 20–8 Scheduling Details Selected Agent Agent for which the Schedule is displayed. You can display also the schedule of all agents by selecting All Agents. Selected Work Repository Only the scenarios executed in the selected Work Repository are displayed in the schedule. Default is All Work Repositories. Scheduling from... to... Time range for which the scheduling is displayed. Click Refresh to refresh this schedule. Update Click Update to update the schedule for the selected agents Time Range The time range specified 1 hour, 2 hours, and so forth allows you to center the diagram on the current time plus this duration. This feature provides a vision of the sessions in progress plus the incoming sessions. You can use the arrows to move the range forward or backward. Scenarios details This panel displays the details and execution statistics for each scheduled scenario.