Scheduling a Scenario or a Load Plan with an External Scheduler

20-24 Oracle Fusion Middleware Developers Guide for Oracle Data Integrator S:Body S:Envelope

20.11.7 Restarting a Load Plan Instance Using a Web Service

The invokeRestartLoadPlan operation of the agent web service restarts a Load Plan instance identified by the Instance ID in a given work repository. The Load Plan instance is restarted by the agent providing the web service. OdiRestartLoadPlanRequest Credentials OdiUserodi_userOdiUser OdiPasswordodi_passwordOdiPassword WorkRepositorywork_repositoryWorkRepository Credentials RestartLoadPlanRequest LoadPlanInstanceIdload_plan_instance_idLoadPlanInstanceId RestartLoadPlanRequest OdiRestartLoadPlanRequest

20.11.8 Monitoring a Load Plan Run Status Using a Web Service

The getLoadPlanStatus operation of the agent web service returns the status of one or more Load Plans by their Instance ID and Run Number in a given repository. It manages both running and completed Load Plan instances. OdiGetLoadPlanStatusRequest Credentials OdiUserodi_userOdiUser OdiPasswordodi_passwordOdiPassword WorkRepositorywork_repositoryWorkRepository Credentials LoadPlans LoadPlanInstanceIdload_plan_instance_idLoadPlanInstanceId LoadPlanRunNumberload_plan_run_numberLoadPlanRunNumber LoadPlans OdiGetLoadPlanStatusRequest The getStopLoadPlanStatus operation returns the following values in the response: ■ Load Plan Run ID ■ Load Plan Run Count ■ Load Plan Run return code ■ Load Plan message The following is an example of an OdiGetLoadPlanStatus response: S:Envelope xmlns:S=http:schemas.xmlsoap.orgsoapenvelope S:Body ns2:OdiGetLoadPlanStatusResponse xmlns:ns2=xmlns.oracle.comodiOdiInvoke LoadPlanStatusResponse LoadPlanInstanceId3001LoadPlanInstanceId LoadPlanRunNumber1LoadPlanRunNumber LoadPlanStatusELoadPlanStatus LoadPlanReturnCodeODI-1530LoadPlanReturnCode LoadPlanMessageODI-1530: Load plan instance was stopped by user request.LoadPlanMessage Running Integration Processes 20-25 LoadPlanStatusResponse ns2:OdiGetLoadPlanStatusResponse S:Body S:Envelope

20.11.9 Listing Contexts Using a Web Service

The listContext operation of the public web service lists of all the contexts present in a master repository. listContextRequest OdiUserodi_userOdiUser OdiPasswordodi_passwordOdiPassword listContextRequest

20.11.10 Listing Scenarios Using a Web Service

The listScenario operation of the public web service lists of all the scenarios present in a given work repository. listScenarioRequest OdiUserodi_userOdiUser OdiPasswordodi_passwordOdiPassword WorkRepositorywork_repositoryWorkRepository listScenarioRequest

20.11.11 Accessing the Web Service from a Command Line

Oracle Data Integrator contains two shell scripts for UNIX platforms that use the web service interface for starting and monitoring scenarios from a command line via the run-time agent web service operations: ■ startscenremote.sh starts a scenario on a remote agent on its web service. This scenario can be started synchronously or asynchronously. When started asynchronously, it is possible to have the script polling regularly for the session status until the session completes or a timeout is reached. ■ getsessionstatusremote.sh gets the status of a session via the web service interface. This second script is used in the startscenremote.sh script. Before accessing a web service from a command line, read carefully the following important notes: ■ 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. ■ Unlike the startscen.sh command line, these scripts rely on the lightweight WGET utility installed with the UNIX or Linux platform to perform the web service calls. It does not use any java code and uses a polling mechanism to reduce the number of running processes on the machine. These scripts are suitable when a large number of scenarios and sessions need to be managed simultaneously from a command line. Starting a Scenario To start a scenario from a command line via the web service: 1. Change directory to the agentbin directory of the Oracle Data Integrator installation.