JOBCONTROL(8)						      System Manager's Manual						     JOBCONTROL(8)

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 Reject-
       Notice 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 match-
       ing 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 num-
       bers; 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 dis-
       able 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).

								   Mar 27, 2006 						     JOBCONTROL(8)