DESTCTRLS(5F)

NAME
       destctrls - per-destination controls for HylaFAX servers

DESCRIPTION
       The HylaFAX configuration parameter DestControls specifies
       whether or not to apply per-destination  controls  on  job
       characteristics such as the time-of-day to place a call.

       The  controls  file  is  a  simple ASCII file containing a
       series of records of the form:
              dest    param = value ... param = value
       where dest is a regular  expression  matched  against  the
       canonical  form  of a destination phone number and parame-
       ters are specified by named assignments (though the  ``=''
       can  also  be  left  out).   Whitespace may be used freely
       though it is used to identify the  end  of  dest  and  the
       start  of the parameter list.  Parameter values are parsed
       exactly as  specified  in  config(5F);  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.  Parameter lists may be continued
       across lines by starting subsequent lines with  a  whites-
       pace  character  (lines  commented out with ``#'' are also
       considered to be part of a continued record).

       The order of entries in  a  file  is  important.   When  a
       parameter value is needed faxq sequentially scans the file
       until it finds a record that matches the canonical form of
       the  destination phone number.  If the requested parameter
       is defined in this record, then  the  value  is  returned,
       otherwise a default value is used from the faxq configura-
       tion file.

       The following parameters may be specified on a  per-desti-
       nation basis; consult config(5F) for a description of each
       parameter (except RejectNotice which is described  below).
       Tag                  Type       Default      Description
       MaxConcurrentJobs    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
       RejectNotice         string     -            rejection notice for transmit job
       TimeOfDay            string     Any          default time-of-day restrictions

       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 associ-
       ated message is  returned  to  the  job  submitter.   This
       facility  can  be used to disallow calling sensitive phone
       numbers; for example
        .*911$    RejectNotice = "Calls to emergency numbers are not permitted"

       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 exam-
       ple,
        .*    SessionTracing = 0x4f

       This mechanism also makes it  easy  to  control  transmit-
       related parameters according to the destination phone num-
       ber.  For example, to disable use of ECM and restrict  the
       transmit  speed when placing international phone calls one
       might use:
        [+][^1]    DesiredBR=9600 DesiredEC=false

NOTES
       Beware that canonical phone numbers have a  leading  ``+''
       which  is a special character for regular expressions.  An
       easy  way  to  match   ``+''   is   with   ``[+]'';   e.g.
       ``[+]14159657824''.

SEE ALSO
       faxq(8C) config(5F) re_format(7).