NAME
       notify - HylaFAX user notification script

SYNOPSIS
       bin/notify qfile why jobtime pid number [ nextTry ]

DESCRIPTION
       bin/notify  is the command script invoked by the facsimile
       server to notify a user about the status  of  an  outbound
       job.   The default notification script sends the appropri-
       ate user electronic mail describing the event  or  action.
       The arguments are:

       qfile     the pathname of the job description file.

       why       a  string  that  specifies why the user is being
                 notified; one of:
                 Why                 Notes    Meaning
                 done                         job was completed successfully
                 failed              - =      job was not completed
                 rejected            -        job was rejected for specified reasons
                 blocked                      job is blocked by concurrent jobs
                 requeued            =        job was not completed, but was requeued for retry
                 removed                      job was deleted from the queue
                 killed              -        job was deleted from the queue
                 timedout            -        job could not be sent after repeated attempts
                 format_failed       -        conversion of POSTSCRIPT failed
                 no_formatter        -        the POSTSCRIPT to facsimile conversion program was not found
                 poll_rejected                a polling request was rejected by the remote side
                 poll_no_document             a polling request failed because nothing was available
                 poll_failed                  a polling request failed for an unknown reason
                 - Any pages that were not sucessfully  transmit-
                 ted should be returned to the sender.
                 =  A  transcript  of the failed communication is
                 returned to the sender with  the  transcript(8C)
                 command.

       jobtime   the  total transmission time of a successful job
                 or the connect time of a failed request  (passed
                 as a string).

       pid       the  process  identifier  of the HylaFAX process
                 that processed the job (used for locating commu-
                 nication transcripts).

       number    the canonical phone number of the destination.

       nextTry   the  time (passed as a string) at which the next
                 attempt will be made to complete the job.   This
                 parameter is passed only if why is ``requeued''.

NOTES
       The following programs may be  invoked  to  return  unsent
       documents   to   the   sender:  tar(1),  uuencode(1),  and
       compress(1).  Which programs and the exact format is  site
       dependent.

FILES
       /var/spool/fax    spooling area
       bin/transcript    for returning communication transcript
       /usr/lib/sendmail for delivering mail

SEE ALSO
       faxq(8C), transcript(8C), hylafax(5F), sendq(5F)