NOTIFY

Section: Maintenance Commands (8C)
Updated: May 8, 1996
Index Return to Main Contents

NAME

notify - HylaFAX user notification script

SYNOPSIS

/var/spool/hylafax/bin/notify qfile why jobtime commid [ 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 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               S1      job was not completed
rejected                     job was rejected for specified reasons
blocked                      job is blocked by concurrent jobs
requeued            S1       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 before kill time expired
format_failed                document conversion failed
no_formatter                 the document conversion program was not found
poll_rejected       S1       a polling request was rejected by the remote side
poll_no_document    S1       a polling request failed because nothing was available
poll_failed         S1       a polling request failed for an unknown reason

S1 A transcript of the failed communication is returned to the sender.

jobtime

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

commid

the communication identifier of the HylaFAX process that processed the job (used for locating communication transcripts).

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''.

FILES


/var/spool/hylafax    spooling area
/usr/sbin/sendmail    for delivering mail

This document was created by man2html, using the manual pages.
Time: 09:07:24 GMT, June 23, 2001