NAME¶
jobcontrols - per-job controls for
HylaFAX servers
DESCRIPTION¶
The
HylaFAX configuration parameter
JobControlCmd specifies the
script that is used to apply per-job controls on job characteristics such as
the time-of-day to place a call.
The controls program should produce a simple line-based
ASCII
output containing a series of records of the form:
param: value
which is parsed the same manner as all HylaFAX config files. Parameter values
are parsed exactly as specified in
hylafax-config(5); i.e. values with
embedded whitespace may be enclosed in quote marks (``"'').
Comments are introduced with a ``#'' character and extend to the end of the
line.
The order of entries in the output is important. The last parameter value
overrides any previous values. If the requested parameter is defined in the
output, then the last value is returned, otherwise a default value is used
from the
faxq configuration file.
The following parameters may be specified on a per-job basis; consult
hylafax-config(5) for a description of each parameter (except
RejectNotice which is described below).
Tag Type Default Description
MaxConcurrentCalls integer 1 max concurrent jobs to process for a destination
MaxDials integer unlimited max phone calls to make to transmit a job
MaxSendPages integer unlimited max pages to permit in a send
MaxTries integer 3 max attempts to transmit a job
Modem string Any ModemGroup to use for destination
RejectNotice string - rejection notice for transmit job
TimeOfDay string Any default time-of-day restrictions
VRes integer - Vertical resolution
UseXVRes integer - Usage of extended resolutions
The
Modem parameter controls which
ModemGroup is used in sending
faxes to the destination. If the user assigns a
ModemGroup for a
specific job where all modems are outside of this
ModemGroup matching a
destination, then the value of
Modem is overridden by the user's
assignment. Likewise, if the user assigns a
ModemGroup for a specific
job where some, but not all, of the modems are included in this
ModemGroup matching a destination, then the value of
Modem is
overridden by the inclusive set of modems found in both.
The
RejectNotice parameter controls whether or not to reject jobs to the
destination. Jobs that are rejected are done so without placing a phone call
and the associated message is returned to the job submitter. This facility can
be used to disallow calling sensitive phone numbers; for example
RejectNotice: "Calls to emergency numbers are not permitted"
The
VRes parameter controls the vertical resolution. Possible values are
98 (normal resolution, equivalent to
sendfax -l option) and 196 (fine
resolution, equivalent to
sendfax -m option).
The
UseXVRes parameter is used to enable or disable the usage of extended
resolutions supported by the receiver. Possible values are 1 (enable extended
resolutions usage, equivalent to
sendfax -G option) and 0 (disable
extended resolutions usage). This parameter supersedes the usage of
VRes.
In addition to the above parameters, any other parameters that are specified are
automatically accumulated and passed to programs invoked by
faxq, such
as
faxsend and
pagesend. This is a convenient mechanism for
defining configuration parameters for all modems without having to modify each
modem-specific configuration file. For example,
SessionTracing: 0x4f
This mechanism also makes it easy to control transmit-related parameters
according to the destination phone number. For example, to disable use of
ECM and restrict the transmit speed when placing international
phone calls one might use:
DesiredBR: 3
DesiredEC: 0
DesiredDF: 1
NOTES¶
SEE ALSO¶
faxq(8),
hylafax-config(5),
re_format(7).