Handbook:Advanced Server Configuration:Per-destination Controls

Note: This feature has been replaced by per-job Controls as of HylaFAX 4.3.0

HylaFAX supports many controls on the operation of the scheduler and related software. For example, outbound jobs may be restricted so that processing is only done at certain times of the day. All of these parameters can be specified in the configuration file used by the central HylaFAX scheduler process. Parameters specified in this way apply to all outbound jobs. It is also possible to specify these parameters on a per-destination basis using the DestControls configuration parameter. This parameter specifies the pathname of a file that holds per-destination control parameters; destctrls(4F).

Per-destination controls are especially useful for controlling which phone numbers can be called. For example, by specifying an entry of the form:

^911$   RejectNotice = "Calls to emergency numbers are not permitted"

any outbound job that would cause HylaFAX to phone 911 would automatically be rejected with the submitter notified by electronic mail using the specified message.

Another useful feature of this facility is the ability to delay toll calls to off-hours so that off-peak phone rates may be used. Entries of the form:

^[+]1415.*      TimeOfDay = "Any"
^[+]1510.*      TimeOfDay = "Any"
.*              TimeOfDay = "Wk1700-0830,Sat,Sun"

might be used to permit calls to US area codes 415 and 510 at any time of day, but force all other calls to be done only during off hours. Note that the parameters specified in the configuration file serve as the default values to use when scheduling an outbound job. That is, if a parameter value is not obtained from the destination controls file then it is taken from any parameters specified in the configuration file. For example, if the above rules had not included the last line that matched ".*", then the time-of-day to use for long-distance calls would have been that specified in the configuration file (by default Any).