Starting a batch job based on a job definition file

To explicitly create a batch job based on one or more job definition files, run runbatch.sh with job definition file names as arguments.

Procedure

  1. Navigate to the $home/bin directory that holds the runbatch.sh script.
  2. Run the runbatch.sh script with arguments that follow the format: 
    runbatch.sh -job [-name <name>] <job file 1> [<job file 2>] [<job file 3>] ... [<job file n>]
    Note: If the runbatch arguments contain more than one job definition file name, the batch processor will create chained batch jobs based on the job definition files.

Results

On receiving the runbatch command, the batch processor creates a job chain with the given name and definitions and then processes the specified jobs. If the name is not specified, the batch processor generates a descriptive name.

By default, when you provide more than one job template through the command line, then the jobs are run in the same sequence as provided in the command line. The batch processor sets the sequence by replacing the <<PriorityType>> placeholder in the job templates with incremental priority values. The first job takes the value specified by the Batch.properties file’s priority_min property; the second job uses the value of priority_min plus one; the third job uses the priority_min value plus two; and so on until the value reaches the value specified by priority_max.

Important: If there are more input files than available priorities, then the batch will fail.

You can override the default job sequence by manually replacing the <<PriorityType>> placeholder in the job templates with a specific priority value. If more than one job has the same priority value, then the batch processor determines the sequence using the task definition ID (ascending) and the task ID (ascending).

Tip: Avoid using the same priority type for more than one job template. The batch processor does not control how the task ID is generated, so the sequence of jobs that have the same priority type and task definition ID is unpredictable.