notify.8c - Man Page

HylaFAX user notification program

Synopsis

/var/spool/hylafax/bin/notify qfile why jobtime [ nextTry ]

Description

bin/notify is the program invoked by the facsimile server to notify a user about the status of an outbound job. It is designed to be customizable by the administrator.  (Ideally this is done by creating a customized notify program in a different filename or by copying the default program to a different filename, customizing that new file, and then using NotifyCmd in the scheduler config file to point faxq(8C) at the customized program.  See hylafax-config(5F).)

The default notification program 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:

WhyNotesMeaning
donejob was completed successfully
failed ¹job was not completed
rejectedjob was rejected for specified reasons
blockedjob is blocked by concurrent jobs
requeued¹job was not completed, but was requeued for retry
removedjob was deleted from the queue
killedjob was deleted from the queue
timedoutjob could not be sent before kill time expired
format_faileddocument conversion failed
no_formatterthe document 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

¹ 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).

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 behavior of notify is intended to be customizable via the etc/FaxNotify program, if present.  FaxNotify is sourced after the q-file is parsed and all default values are preset.  Useful settings for FaxNotify are:

WHY

is identical to why mentioned above and can be useful in determining under what conditions various settings should take effect.  For example,

if [ "$WHY" != "done" ]; then
    RETURNFILETYPE=pdf;
fi

This would only set RETURNFILETYPE when the job did not complete successfully.

RETURNFILETYPE

can be set to “tif”, “pdf”, “ps”, or “original”.  If set, this causes notify to return a copy of the submitted documents to the SENDER address along with the notification message.  The “original” setting uses the format type that was used in the submission. Multiple values may be specified by separating them with whitespace. In that case a separate attachment is created for each filetype.

RETURNTECHINFO

defaults to “yes” and is used to indicate whether or not technical information such as the session parameters should be included with the notification message.  If set to anything other than “yes” this information will not be included.

RETURNTRANSCRIPT

defaults to “yes” and is used to indicate whether or not the session transcript (log) should be returned with the notification message on the error conditions noted above.

NOTIFY_FAXMASTER

is used to deliver a notification message to TOADDR (which defaults to “FaxMaster”) that contains technical information about the job.  This is useful in allowing the administrator to be aware of any problems before those problems are reported by the users. Possible settings are “yes”, “always”, “no”, “never”, and “errors”. If “errors” is used then the notification message is only sent to FaxMaster when the job experienced an error.  The default is “no”.

NOTIFICATIONLANGUAGE

The language of the e-mail messages sent by HylaFAX is selected according to the setting of the NOTIFICATIONLANGUAGE variable, which can be assigned a locale name like the LC_* and LANG locale environment variables.

If the NOTIFICATIONLANGUAGE variable is not set or set to the empty value, then, as a default, the value of the LC_MESSAGES category locale name, i.e., the value of the LC_ALL variable (if not empty), else of the LC_MESSAGES variable (if not empty), else of the LANG variable, is used.

A suggestion for NOTIFICATIONLANGUAGE may be:

NOTIFICATIONLANGUAGE="${LC_ALL:-${LC_MESSAGES:-${LC_CTYPE:-${LANG:-}}}}"

Files

/var/spool/hylafaxspooling area
/usr/sbin/sendmailfor delivering mail

See Also

faxq(8C), hylafax-server(5F), sendq(5F)

Info

May 8, 1996