Skip Ribbon Commands
Skip to main content
Navigate Up
Sign In

Quick Launch

Average Rating:

(2 Ratings)
facebook Twitter
Print Bookmark Alert me when this article is updated


HOW TO: Run the Informatica Cloud task using Windows batch script/Linux shell script Using RunAJobCli Utility
To run the Informatica Cloud task using Windows batch script/Linux shell script, one should have a 'runAJobCli' Package enabled in the Informatica Cloud org.
To check package 'runAJobCli', log into Informatica Cloud with Cloud credentials and navigate to the Administer Tab > Licenses and check at the bottom for the packages assigned to your ORG. If you do not have Package, please contact Informatica Global Customer Support to enable it. 

After enabling the package, "runAJobCli" secure agent will restart and the package will be downloaded from the Informatica Server and that can be found in secure agent machine at location "{AgentDir}\Downloads\package-runAJobCli "

Following are the steps to run the job using the batch script:
  1. Configure the Login credentials of Informatica Cloud on "" file located in "{AgentDir}\Downloads\package-runAJobCli".All the times are in milliseconds.
     userName=<user name of the org where you want to run the task>
     password=<password of the above user>
  2. Following is the syntax of the command:
     cli.bat runAJobCli -n <task name> -t <task type>
    For example, you might use the following command for Mapping Task :
    cli.bat runAJobCli -n KM_MCT_FF_TO_DB2_02503720  -t MTT

  3. )  To run a job using the task name and location to specify the task:
    cli.bat runAJobCli -t <tasktype> -n <task name> -fp <folder path to the task>

    For example, to run a synchronization task, you might use the following command:
    cli.bat runAJobCli -t DSS -n dss_Arch_2308 -fp myproject/folder
  4. To run a job using the federated task ID to specify the task:
    cli.bat runAJobCli -t <tasktype> -frsId <federated task ID>

    For example, to run a synchronization task using the federated task ID, you might use the following command:
    cli.bat runAJobCli -t DSS -frsId kvOF40yLXyUihm7wYYskmh

Use the following arguments in a RunAJob command:

  ACTIVITYMONITORWAIT and TOTALWAIT are the key parameters in file to be specified in milliseconds.
ACTIVITYMONITORWAIT is used to handle the delay if any for the task to appear in Activity Monitor. 30 seconds is good for this.
TOTALWAIT will set the frequency at which the utility polls for job status. Usually set to 30sec/1min/2min/3min i.e, 30000/60000/120000
RETRYCOUNT is the number of times it polls for the job status. The recommendation is to know the longest running job and set the retry count accordingly


If a task runs around 25 min, set TOTALWAIT=60000 and RETRYCOUNT=30
This means that utility will poll for the task status 30 times in the interval of 1min, so totally it is 30 min.
If by chance task executes more than 30 mins, the command will exit with return code 6 but the task will continue to run in Informatica Cloud.


Error Code is as follows:

 EXCEPTION("Exception", -1) 
 SUCCESS("Success", 0)  
 WARNING("Warning", 1)  
 NOWAIT("NoWait", 2)  
 FAILURE("Failure", 3) 
 TIMEOUT("Timeout", 4)  
 ERROR("Error", 5)  
 RUNNING("Running", 6)  
 START("Failure", 7)

Java 1.8 is required to use this utility. To check the java version in the machine, run the following command:
java -version

If it is not 1.8, please install java 1.8 in the machine/server from where you will be running this command. 
More Information
Applies To
Product: Cloud Data Integration
Problem Type: Configuration
User Type: Administrator
Project Phase: Configure
Product Version:
Operating System:
Other Software:
Last Modified Date:3/29/2019 9:25 AMID:500262
People who viewed this also viewed


Did this KB document help you?

What can we do to improve this information (2000 or fewer characters)