Provided by: hylafax-server_6.0.6-6_amd64 bug

NAME

       sendq/q* - HylaFAX outbound job description

DESCRIPTION

       Files  in  the sendq directory specify transmission job requests.  These files are created
       by hfaxd(8),  when  submitting  a  job  on  behalf  of  sendfax(1)  or  sendpage(1).   Job
       description files also reside in the doneq directory; they are moved there by faxq(8) when
       a job completes.

       Job description files are ASCII files with lines of the form
            tag: value
       where a tag is one of the identifiers described below and a value is either  a  string  or
       number.  Values start at the first non-blank character after the ``:'' and continue to the
       end of the line.  Lines that end with a backslash character ``\''  are  continued  to  the
       next  line.   Numeric  values  are  decimal  integers,  except  for  chophreshold which is
       expressed as a floating point value.

       The following table lists the possible tags and the required type of the associated value.
              Tag             Type       Description
              chopthreshold   float      page chopping threshold (inches)
              commid          string     communication identifier for last call
              company         string     receiver's company
              client          string     host that submitted the job
              cover           string     continuation coverpage file
              data            string     unprocessed document of indeterminate type
              !data           string     processed document of indeterminate type
              dataformat      string     data format used to transmit a facsimile
              desiredbr       integer    desired maximum transmit speed
              desireddf       integer    desired page data format
              desiredec       integer    desired use of Error Correction Mode (ECM)
              desiredst       integer    desired minimum scanline time
              desiredtl       integer    whether or not to use tagline parameter
              doneop          string     operation to perform when job is reaped
              errorcode       string     job status error code
              external        string     external form of dialstring
              fax             string     document ready for transmission
              faxnumber       string     faxnumber to use sending
              groupid         integer    HylaFAX job group identifier
              jobid           integer    HylaFAX job identifier
              jobtag          string     user-specified job identifier
              jobtype         string     job type identification string
              killtime        integer    time to give up trying to send job
              location        string     receiver's location
              mailaddr        string     email address of sender
              maxdials        integer    max number of times to dial
              maxtries        integer    max number of attempts to send job
              minbr           integer    minimum required transmit speed
              modem           string     outgoing modem to use
              ndials          integer    number of consecutive failed attempts to place call
              notify          string     email notification specification
              npages          integer    number of pages transmitted
              ntries          integer    number of attempts to send current page
              number          string     dialstring to use in placing call
              owner           string     user that owns the job
              page            string     PIN in a page operation
              pagechop        string     whitespace truncation handling
              pagehandling    string     page analysis information
              pagelength      integer    facsimile page length (millimeters)
              pagewidth       integer    facsimile page width (millimeters)
              passwd          string     info to send in HDLC PWD frame
              pcl             string     unprocessed PCL document
              !pcl            string     processed PCL document
              poll            string     polling request
              postscript      string     unprocessed POSTSCRIPT document
              !postscript     string     processed POSTSCRIPT document
              priority        integer    user-specified scheduling priority
              receiver        string     receiver's identity
              resolution      integer    vertical resolution of facsimile
              retrytime       integer    time to use between job retries
              returned        integer    indicates return status value for the job
              schedpri        integer    current scheduling priority
              sender          string     identity of sender
              signalrate      string     signalling rate at which a facsimile was sent
              state           integer    job scheduling state
              status          string     job status
              subaddr         string     info to send in HDLC SUB frame
              tagline         string     tagline format string
              tiff            string     unprocessed TIFF/F document
              !tiff           string     processed TIFF/F document
              totdials        integer    total number of phone calls
              totpages        integer    total pages to transmit
              tottries        integer    total number of attempts to send job
              tsi             string     TSI to transmit when sending
              tts             integer    time to send job
              useccover       integer    whether or not to use a continuation cover page
              usexvres        integer    whether or not to use highest vertical resolution

PARAMETERS

       Note that all files must be owned by the fax user.  Pathnames for document files  must  be
       relative to the top of the HylaFAX spooling directory and not include ``..''.

       chopthreshold The  minimum  trailing whitespace (in inches) that must appear on a page for
                     it to be considered  for  ``page  chopping''.   If  this  parameter  is  not
                     specified  then  the  value specified by the PageChopThreshold configuration
                     parameter is used; see hylafax-config(5).

       commid        The communication identifier for the last outbound call placed for this job.
                     This string is of the form ``XXXXXXXX'' where XXXXXXXX is a decimal sequence
                     number in the range 1-99999999.

       client        The fully qualified  hostname  for  the  machine  from  which  the  job  was
                     submitted.   If  the  hostname  is unknown at the time the job is submitted,
                     then the host address in Internet standard ``.'' (dot) notation is  supplied
                     instead.

       company       The  receiver's  company name as specified with the -x option to sendfax(1).
                     This value is used only when creating continuation cover pages.

       cover         The pathname of a continuation cover page to send.  The file must be  TIFF/F
                     (i.e.  it must already be prepared for transmission).  This document will be
                     transmitted  before  any  other  documents  listed   in   the   file.    See
                     ContCoverPage and ContCoverCmd in hylafax-config(5).

       data          The  pathname of a document to send.  Once a document has been processed, it
                     is marked as !data so that subsequent retries do not reprocess the document.

       dataformat    The format used to transmit  facsimile  data.   This  item  is  recorded  by
                     faxsend(8) so that notify(8) can return it in a notification message.

       desiredbr     The  desired  signalling rate to use for page data transmissions: 0 for 2400
                     bps, 1 for 4800 bps, 2 for 7200 bps, 3 for 9600 bps, 4 for 12000 bps, 5  for
                     14400  bps,  6  for 16800 bps, 7 for 19200 bps, 8 for 21600 bps, 9 for 24000
                     bps, 10 for 26400 bps, 11 for 28800 bps, 12 for 31200 bps, and 13 for  33600
                     bps (default).

       desireddf     The  desired data format to use for page data transmissions: 0 for 1-D MH, 1
                     for 2-D MR, 3 for  2-D  MR  with  uncompressed  data,  and  4  for  2-D  MMR
                     (default).

       desiredec     Which  type  of  Error  Correction  Mode  (ECM)  to use: 0 to disable, 1 for
                     64-byte ECM, 2 for 256-byte ECM (default).

       desiredst     The desired minimum scanline time to use for page data transmissions: 0  for
                     0  ms  (default), 1 for 5 ms, 2 for 10ms/5ms, 3 for 10ms, 4 for 20ms/10ms, 5
                     for 20ms, 6 for 40ms/20ms, and 7 for 40ms.  This value is used in  selecting
                     the negotiated session parameters.

       desiredtl     Whether  or  not  to  use  the  format  string  specified by the tagline job
                     parameter when imaging taglines on document pages.  If this  value  is  non-
                     zero then per-job format string is used; otherwise the tagline format string
                     specified in the server configuration file is  used;  see  TagLineFormat  in
                     hylafax-config(5).

       doneop        The  treatment  the  job  should  be  given  when  it  is  processed  by the
                     faxqclean(8) job cleaner program.  The may be one of remove (to expunge  the
                     job description file and all associated documents that are not referenced by
                     another job) or archive (to request that the job and associated documents be
                     archived  on  the  server machine).  Consult faxqclean more details on other
                     information that may be included in this string.

       errorcode     The codified form of the status message intended for use  by  clients  which
                     provide customized status messages keyed from this standard index.

       external      The  external  form  of  the dialstring.  This string is used instead of the
                     dialstring in any status and log  messages.   Clients  can  protect  private
                     information  such  as  access  codes  that  must be placed in dialstrings by
                     supplying a ``cleansed'' version of the dialstring.

       fax           The pathname of a TIFF/F document that is ready for  transmission.   If  the
                     pathname  string has a leading ``xx:'', then ``xx'' is interpreted to be the
                     index of the first directory  in  the  file  to  transmit  (directories  are
                     numbered starting at zero).

       faxnumber     The  number  to  use when sending a fax.  Parallel's FAXNumber device config
                     option.

       groupid       The job group identifier, an integer number in the range 1 to 32000 assigned
                     to  each group of jobs by the HylaFAX software.  Each job in a group of jobs
                     submitted at the same time  is  assigned  the  same  value  by  the  HylaFAX
                     software.

       jobid         The job identifier, a unique integer number in the range 1 to 32000 assigned
                     to each job by the HylaFAX software.

       jobtag        A user-specified string that is intended for  identification  purposes.   If
                     this  string is defined, it is returned to the user in notification messages
                     instead of the job identifier.

       killtime      The time to kill this job, expressed in seconds since 00:00:00 GMT,  January
                     1, 1970.

       location      The receiver's location as specified with the -y option to sendfax(1).  This
                     value is used only when creating continuation cover pages.

       mailaddr      The electronic  mail  address  to  which  notification  messages  should  be
                     directed.

       maxdials      The  maximum  number  of times the server should dial the phone.  If the job
                     cannot be completed in this number of calls, it is terminated.

       maxtries      The maximum number of times the server should attempt to send a  job;  where
                     an  attempt  is  defined  to  be a session that makes it past Phase A of the
                     CCITT T.30 protocol (for facsimile), or  similar.   If  the  job  cannot  be
                     completed in this number of tries, it is terminated.

       minsp         The  minimum  signalling  rate to use for transmitting page data: 0 for 2400
                     bps (default), 1 for 4800 bps, 2 for 7200 bps, 3 for 9600 bps, 4  for  12000
                     bps,  5  for 14400 bps, 6 for 16800 bps, 7 for 19200 bps, 8 for 21600 bps, 9
                     for 24000 bps, 10 for 26400 bps, 11 for 28800 bps, 12 for 31200 bps, and  13
                     for 33600 bps.

       modem         The outgoing modem to use to send the job, or ``any'' if any available modem
                     is acceptable.

       owner         The identity of the user that owns the job.  Typically the owner is the user
                     that  created  the  job,  though  clients with administrative privileges can
                     change the ownership of jobs.  The value is the string specified in the USER
                     command passed to hfaxd(8) when a client logins in to the server.

       notify        A  specification  of whether the sender wants notification: whenever the job
                     is requeued after a failed attempt to transmit (``when requeued''), when the
                     job   is   completed   (``when   done''),   either   of  the  above  (``when
                     done+requeued''), or not at all (``none'').

       npages        The number of pages in the facsimile, including the cover  page,  that  have
                     been successfully transmitted.

       ntries        The  number  of  unsuccessful  attempts  that have been made to transmit the
                     current page.

       ndials        The number of consecutive unsuccessful attempts to  establish  carrier  with
                     the the remote device.

       number        The dialstring to use to call the destination device.

       page          a string with PIN and to use in processing a page transmit request.

       pagechop      Whether  or  not  to  automatically truncate trailing whitespace on pages of
                     outbound facsimile; see PageChop in hylafax-config(5).  The possible  values
                     are: ``default'' to use the setting of the PageChop configuration parameter,
                     ``none'' to disable page chopping, ``all'' to enable chopping of all  pages,
                     and ``last'' to enable chopping of the last page of each document.

       pagehandling  A   string   that   contains  per-page  information  used  during  facsimile
                     transmission.  Most of the information is used in the negotiation of session
                     capabilities  with  optional  information used in the implementation of page
                     chopping.  The string has three characters, say xxc, for  each  page  to  be
                     transmitted.   The  xx  characters  are  a  hex-encoded specification of the
                     session capabilities required to transmit the page.  The c character is  one
                     of  ``M'', ``S'', and ``P''; where: ``M'' indicates there is another page to
                     follow and that the page  requires  different  T.30  session  parameters  be
                     negotiated  (an  EOM  code  is to be transmitted).  ``S'' indicates there is
                     another page to follow, but the page uses the same  session  parameters  (an
                     MPS.   code is to be transmitted).  ``P'' indicates this is the last page to
                     be transmitted (an EOP code is to be transmitted).   In  addition,  if  page
                     chopping  has been enabled and the page has enough trailing whitespace to be
                     a candidate, then each three character string will be followed by  a  string
                     of  the form ``ZXXXX'', where ``XXXX'' is a 4 digit hex-encoded count of the
                     number of bytes of data to send for a chopped page.

       pagelength    The desired page length in millimeters.

       pagewidth     The desired page width in millimeters.

       pcl           The pathname of a PCL document to  send.   Once  a  PCL  document  has  been
                     processed by faxsend, it is marked as !pcl so that subsequent retries do not
                     reprocess the document.

       poll          The value is a Caller Identification String (CIS) to use in making a polling
                     request.   If  no  CIS  is  specified  then  faxsend  will form one from the
                     FAXNumber configuration parameter.

       postscript    The pathname of a POSTSCRIPT® document to send.  Once a POSTSCRIPT  document
                     has  been  processed  by  faxsend,  it  is  marked  as  !postscript  so that
                     subsequent retries do not reprocess the document.

       receiver      The receiver's name.  This value is used  only  when  creating  continuation
                     cover pages.

       resolution    The  desired  vertical  resolution  in lines per inch.  This value should be
                     either 98 or 196.

       retrytime     The time, in seconds, to delay between each attempt to transmit a  job  that
                     fails  because  of  a  communication-oriented  problem.   Normally  jobs are
                     scheduled according to a collection of  configuration  parameters  that  are
                     tuned  for  the  specific  reason  of  each failure; e.g. see JobReqProto in
                     hylafax-config(5).

       returned      Used internally to determine the last return value of the job send attempt.

       sender        The ``full name'' of the sender of the facsimile.

       signalrate    The signalling rate used to transmit facsimile data.  This item is  recorded
                     by faxsend(8) so that notify(8) can return it in a notification message.

       state         The  job  scheduling  state.  Recognized values are: 1 (suspended, not being
                     scheduled), 2 (pending, waiting for the time to send), 3 (sleeping,  waiting
                     for a scheduled timeout), 4 (blocked, waiting for concurrent activity to the
                     same destination to complete), 5 (ready, ready to be  processed  except  for
                     available  resources),  6  (active,  actively being processed by HylaFAX), 7
                     (done, processing completed with success).  8 (failed, processing  completed
                     with a failure).

       status        Status  information  about  the current state of the job.  Typically this is
                     the reason why the last attempt to send the facsimile failed.

       subaddr       The SubAddress information to  transmit  when  sending  a  facsimile.   This
                     string should be used by the receiver to route received facsimile documents.

       tagline       The  format  string  to use in imaging taglines on outgoing documents.  Note
                     that this parameter is only used if the desiredtl parameter is non-zero.

       tiff          The pathname of a TIFF/F document to send.  Once a TIFF  document  has  been
                     processed  by  faxsend,  it is marked as !tiff so that subsequent retries do
                     not reprocess the document.

       totdials      The total number of times the server has placed  a  call  to  the  receiving
                     phone number.

       totpages      The total number of pages to be transmitted.

       tottries      The total number of attempts to transmit a job; see maxtries above.

       tsi           TSI  to  use  when  sending.   This  is  only  used  if  the device has been
                     configured to allow it.   Otherwise,  the  configured  LocalIdentifier.   is
                     used.

       tts           The  time  to  send  the  job.   If  this value is non-zero, it is number of
                     seconds since 00:00:00 GMT, January 1, 1970.  Otherwise, a  value  of  0  is
                     interpreted to mean process as soon as possible.

       useccover     1  if  the job should use a continuation cover page during retransmission, 0
                     otherwise.

       usexvres      1 if the  job  should  use  the  highest  possible  vertical  resolution,  0
                     otherwise.   See  hylafax-server(5)  for a description of continuation cover
                     pages.

SEE ALSO

       sendfax(1), faxq(8), faxqclean(8), faxsend(8), pagesend(8), hfaxd(8), hylafax-config(5)

                                           May 12, 1996                                  SENDQ(5)