---
name: "notify"
section: "8hylafax"
platform: "linux"
package: "hylafax-server"
version: "1:4.1.1-3.1"
release: "Debian 3.0 (Woody)"
platforms: ["linux"]
url: "https://new.carta.tech/notify/8hylafax"
---

# notify(8hylafax)

HylaFAX user notification script

## 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	 ¹	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 before kill time expired
  format_failed		document conversion failed
  no_formatter		the 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).

- **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
```

## SEE ALSO

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