DFfaxq

DFfaxq — Display the members of the outgoing fax queue

Synopsis

DFfaxq [#, #-#] [username...]

Description

DFfaxq reports on the status of requested faxes, either by their fax IDs, or by all faxes owned by the user(s) specified. When invoked with no arguments, DFfaxq reports on all faxes in the queue. For each outgoing fax, DFfaxq reports the unique fax ID number (by which it is referred to when using DFfaxrm), the user name of the fax owner, the scheduled time of sending, the file to be sent, the current status of the entry in the queue, the number of attempts at sending, and the phone number (or email address) to be sent to.

In the case of a fax that is being sent to multiple recipients, the fax ID, owner, scheduled time, and file to be sent, are all displayed on the first line together with the status, attempt, and phone number/email address of the first recipient. For the second and subsequent recipients, only the status, attempt and phone number/email address are displayed. The possible status values are:

  • New: in queue and waiting for scheduled time to arrive

  • Sending: in process of being sent to recipient

  • Retry: in queue as previous tries have failed and waiting for retry delay to expire

  • Sent: successfully sent to recipient

  • Failed: failed and maximum number of retries was exceeded

If the recipient is an email address, the only possible status values are Sending or Sent. It is not possible to reliably track the delivery status of an email message and so the other statuses cannot be reported.

DFfaxq displays the queue information sorted by increasing fax ID#.

Options

#, #-#

report on the status of faxes with the requested fax id numbers.

username

report on the status of faxes owned by username. Multiple usernames can be specified.

Exit Status

DFfaxq exits with one of the following statuses:

0

The command was successful.

> 0

The required command-line arguments were not present or were incorrectly specified.

Examples

Example 3.44. Scheduled but not yet sent fax

% DFfaxq
FaxId Owner Scheduled Time  File       Status Try To
  307 usr1  Nov 30 16:18:23 /etc/fstab New    0   1234567

Example 3.45. In-progress fax to multiple recipients

Here is a queue entry for an in-progress fax to multiple recipients:

% DFfaxq
FaxId Owner Scheduled Time  File       Status Try To 
  202 root  Nov 30 16:18:23 /etc/magic New    0   5432198
                                       Sent   1   abc@hotmail.com
                                       Retry  1   9876543


See Also

DFfaxrm