Castelle FAXPRESS PREMIER, Administrator'S Manual

Page: 299 / 639

Admin Guide > Drop Directory and the DropFax Service
FaxPress Premier Administrator Guide 283
Gulp Count – For multiple drop directories with different priority settings, this op-
tion can be used to specify the number of fax jobs to be sent from one folder before
the drop directory service moves on to send faxes from the next folder. If, for ex-
ample, the gulp count is set to 25 and there are 4 folders, each with 100 fax jobs,
the drop directory service will send 25 faxes from the first folder, then 25 from the
second, and so on.
Stop Interval – If multiple drop directories with different priorities are set up, the
stop interval setting is used to specify the length of time the drop directory service
will run before returning to the folder with the highest job priority. If, for example,
there are four folders and the stop interval set to 90, the drop directory service
will, after 90 seconds, leave the fax jobs in the lower priority folders and return to
the highest priority folder.
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 has been configured to query a drop directory, the third party applica-
tion can put the job data and control files in the directory. The data files should be put into
the directory before the control files. The names of these files must be DOS format (up to
8 characters long, followed by an extension of up to three characters). Jobs are copied into
drop directory one at a time and FaxPress process 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.
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 spec-
ified 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 direc-
tive of the form:
##Directive [parameter 1] [parameter 2]
The directive must begin with a ## followed immediately by the directive keyword (in ei-
ther upper or lower case). The keywords may include an embedded dash to enhance read-
ability. 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