[interchange-docs] xmldocs - racke modified glossary/jobs
docs at icdevgroup.org
docs at icdevgroup.org
Thu Mar 27 10:46:54 EST 2008
User: racke
Date: 2008-03-27 15:46:54 GMT
Modified: glossary jobs
Log:
more documentation on job facility
Revision Changes Path
1.5 xmldocs/glossary/jobs
rev 1.5, prev_rev 1.4
Index: jobs
===================================================================
RCS file: /var/cvs/xmldocs/glossary/jobs,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- jobs 28 Jun 2007 10:29:12 -0000 1.4
+++ jobs 27 Mar 2008 15:46:54 -0000 1.5
@@ -1,3 +1,6 @@
+Interchange batch jobs can be triggered from the commandline or an Unix cronjob.
+</para>
+<para>
Dispatch a job from the commandline:
<programlisting>
@@ -6,3 +9,45 @@
Jobs are run asynchronously. The command will return before the job is
completed or even started.
+
+</para>
+
+<section id="JobDirectories">
+<title>Job Directories and Files</title>
+<para>
+Every job is tied to a directory containing job files. The selection
+of the files is controlled by the &Conf-HTMLsuffix; and the
+<literal>suffix</literal> &conf-Jobs; attribute. By default all files not
+matching &Conf-HTMLsuffix; are included.
+</para>
+<para>
+The following configuration example directs Interchange to execute
+all files matching
+<literal>jobs/</literal><replaceable>NAME</replaceable><literal>/*.job</literal>
+for the job named <replaceable>NAME</replaceable>.
+<programlisting>
+Job base_directory jobs
+Job suffix .job
+</programlisting>
+</para>
+</section>
+
+<section id="JobOutput">
+<title>Job Output and Logging</title>
+<para>
+Interchange gathers the output of all job files and passes through
+the filter(s) specified with <literal>filter</literal> key of the &conf-Jobs;
+directive.
+</para>
+<para>
+The remaining output is optionally written to the job logfile and/or
+emailed as specified by the <literal>log</literal> and <literal>email</literal>
+keys of the &conf-Jobs; directive.
+<programlisting>
+Job email racke at linuxia.de
+Job log logs/job
+</programlisting>
+</para>
+</section>
+
+<para>
\ No newline at end of file
More information about the docs
mailing list