Interchange batch jobs can be triggered from the commandline or an Unix cronjob.

Dispatch a job from the commandline:

interchange --runjobs=training=db

Jobs are run asynchronously. The command will return before the job is completed or even started.

Directories and Files

Every job is tied to a directory containing job files. The selection of the files is controlled by the HTMLsuffix and the suffix Jobs attribute. By default all files not matching HTMLsuffix are included.

The following configuration example directs Interchange to execute all files matching jobs/NAME/*.job for the job named NAME.

Jobs base_directory jobs
Jobs suffix .job

Output and Logging

Interchange gathers the output of all job files and passes through the filter(s) specified with filter key of the Jobs directive.

The remaining output is optionally written to the job logfile and/or emailed as specified by the log and email keys of the Jobs directive.

Jobs email
Jobs log logs/job


Tracking jobs into a database table can be enabled with the trackdb key of the Jobs directive.

Jobs trackdb jobs

Required fields for this table are code, name, pid, begin_run, end_run.

DocBook! Interchange!