job execute

The job execute command runs one or more jobs. After the job runs, the job name and job ID are returned in the format:



job execute --j JobNames --f JobPropertyFile --i PollInterval --d ReportDelimiter --n NotificationEmails --o OptionPropertyFile --r ReportTrueOrFalse --t Timeout --w WaitTrueOrFalse --l FileOverrides --v VerboseTrueOrFalse
Required Argument Description
Yes --j JobNames Specifies the name of one or more jobs to run. If you specify more than one job, separate each job with a comma. Jobs run in the order you list them. If the job name contains spaces, enclose the name in quotes.
Tip: If you are unsure of the exact dataflow name you can use the dataflow list command to get a list of the dataflow names.
No --f JobPropertyFile Specifies the path to a job property file. A job property file contains arguments that control the execution of jobs. For more information, see Using a Job Property File.
No --i PollInterval When --w is set to true, use this option to specify how often to check for completed jobs, in seconds. The default is 5.
No --d ReportDelimiter Sets the delimiter character to use in the report output when you also specify --w true or --r true. The default is the pipe character ( | ).
No --n NotificationEmails Specifies one or more email addresses to receive notifications about the status of jobs, as configured in Management Console. Separate each email address with a comma.
No --o OptionPropertyFile

Specifies a path to a dataflow options property file. Use a dataflow options property file to set options for stages in the dataflow. In order to set dataflow options using a property file, you must configure the dataflow to expose stage options at runtime. For more information, see Adding Dataflow Runtime Options.

For example, a dataflow options properties file for a dataflow that contains an Assign GeoTAX Info stage may look like this:

No --r ReportTrueOrFalse Specify true to return a detailed report about the job. This option only works if you also specify --w true . The report contains the following information:
  • Position 1—Name of job
  • Position 2—Job process ID
  • Position 3—Status
  • Position 4—Start Date/Time (MM/DD/YYYY HH:MM:SS)
  • Position 5—End Date/Time (MM/DD/YYYY HH:MM:SS)
  • Position 6—Number of successful records
  • Position 7—Number of failed records
  • Position 8—Number of malformed records
  • Position 9—Currently unused

For example,

MySimpleJob|4|succeeded|04/09/2010 14:50:47|04/09/2010 14:50:47|100|0|0|

The information is delimited using the delimiter specified in the --d argument.

No --t Timeout Sets the timeout value for synchronous mode, in seconds. The default is 3600.
No --w WaitTrueOrFalse Specify true to run jobs one at a time in synchronous mode. Specify false to run all the jobs at the same time. The default is false.
No --l FileOverrides Overrides the input and output file and file format. For more information see Overriding Job Files and Overriding File Format.
No --v VerboseTrueOrFalse Specify true to return information about the arguments used to run the job and other details about the job execution.


This example runs a job named Example1. It returns a comma-delimited report. Note that --w true is specified because this is required to return a report even if only one job is running. The input file specified in the Read from File stage is changed from what is specified in the stage to a different file named CandidateHomes2.csv. Verbose output is also returned.

job execute --j Example1 --w true --d "," --r true --l "Read from File=file://e:/SampleDataflows/DataFiles/DataFiles/CandidateHomes2.csv” --v true