Job Control, Data And Notice Files - Captaris FaxPress Supplementary Manual

Job Control, Data and Notice Files

Outgoing fax jobs are presented through a drop directory as a set of control and fax data
files. Periodically the FaxPress server searches for and selects control files from the drop
directories.
Selected control files and the corresponding data files are used by the server to define and
launch outbound fax jobs. As these drop directory jobs are completed, the call information
for each job is reported back through the drop directory in a series of notice files.
Job Control Files
After the FaxPress server has been configured to query a drop directory, the third-party
application can put the job data and control files in the directory. The data files should be
put into the directory before the control files. Jobs are copied into the drop directory one
at a time and FaxPress processes the jobs one at a time.
The originators of drop directory jobs must ensure that names assigned to the control and
data files are unique within their directory for at least the duration of the job's processing,
and that filenames do not exceed 128 characters. The job control files in a drop directory
are distinguished from the other types of files in this directory by their filename extension,
which must be the same as the extension specified along with the drop directory pathname
specified in the Drop Directory configuration dialog above. The first characters of a job
control filename are also used for the name of the notice files generated for the jobs
originating from the control file.
Each job control file consists of a series of ASCII lines (each terminated with an ASCII line
feed character) that specify how the job is to be handled. Each line should contain a
directive of the form:
##Directive [parameter 1] [parameter 2]
The directive must begin with a ## followed immediately by the directive keyword (in
either upper or lower case). The keywords may include an embedded dash to enhance
readability. If parameters are included in a directive line, the parameter text follows and
is separated from the directive keyword by a space.
A job control file may contain multiple (possibly overlapping) job control streams. Each job
control stream is concluded with a ##dial directive, and the most closely proceeding
(##cover/##nocover, ##billback/##nobillback, etc.) parameter settings are applied to
the job. Parameter directives do not need to be repeated between ##dial directives if the
parameter selection is not changed.
Note: Control files are to contain strictly ASCII data, and should only be edited
with a plain-text editor.
FaxPress Administrator Guide
Admin Guide > Job Control, Data and Notice Files
278