Section: User Commands (1)
Updated: July 11, 1996
Return to Main Contents
faxalter - alter parameters of a HylaFAX job queued for transmission
changes the state of one or more HylaFAX jobs that
are queued for transmission.
Numerous parameters can be altered; see the options below.
is a number that identifies a
that has been submitted to HylaFAX; these numbers are printed by
when jobs are queued for transmission and can also be displayed with
Unprivileged users can alter the parameters of jobs that they own; clients
with administrative privileges on a server can manipulate any job.
contacts the facsimile server on the host specified in the
environment variable; but consult the
option for more information.
- -a time
Specify a new time to send a job.
The syntax for specifying a time is the same as used
- -h host
Force the server to be contacted on a specific
may be either a symbolic name or a network address.
option is supplied,
environment variable to identify the HylaFAX server to contact.
If this variable is not set, then
checks for a setting in the configuration files (first in the
per-user file and then in the system-wide file).
If all of the above fails, then
attempts to contact a server on the machine where it is run.
- -k time
Specify a new time to kill a job;
the syntax is the same as used for the
- -m modem
Assign/reassign the jobs to the specified
Specifying ``any'' for
causes the jobs to be scheduled for any available modem.
The jobs should be
that is, they should be sent immediately
(this is equivalent to ``-a now''.)
- -P pri
Set the scheduling priority for the specified jobs.
The priority is an integer value in the range 0-255;
lower values give a job higher priority.
The default scheduling priority for a job is 127
and priorities are recalculated after each attempt to
process a job.
- -t tries
Set the maximum number of times the
server should call the remote fax machine.
- -n scheme
Select a notification scheme to use for the specified jobs.
Possible schemes are:
``none'' for no notification (default),
``when done'' for notification when the job is completed,
``when requeued'' for notification when the job is requeued
after a failed transmission attempt.
options are shorthand for these notification schemes,
One can also leave off ``when'' when using the
option; e.g., ``done'' instead of ``when done''.
Trace the protocol exchanges between
and the remote
Tracing information is written to the standard output.
reads configuration information from the file
and then from the file
Configuration files follow the conventions described in
The following configuration parameters are recognized:
Tag Type Default Description
Host string localhost host to contact for service
Port integer 4559 port to use in contacting server
Protocol string tcp protocol to use in contacting server
Verbose boolean No whether or not to enable protocol tracing
The configuration parameters are explained below:
The host to contact for service.
(Equivalent to the
The network port to contact for service.
(Eqvuialent to the
The name of the communication protocol to use when contacting a server.
(Equivalent to the
Control protocol tracing.
(Equivalent to the
Setting a job's killtime without also setting the time to send
may cause the wrong value for the killtime to be sent.
This is because the killtime is calculated as the difference in
time between the killtime and time to send: and if the time
to send is not specified, then
uses the current time instead of querying the server for the
job's time to send.
suspends a job before attempting to alter its state.
If a job is active when a suspend request is made there may
be a delay while waiting for the job to enter a consistent
state where it can be suspended.
is interrupted during this time then jobs may be left suspended.
only understands how to alter a subset of the available job
parameters; there are many more client-controllable parameters
that can only be modified by communicating directly with the server
using the underlying protocol.
The continued use of the
notation for specifying times is questionable (it was done for
- CONFIGURATION PARAMETERS
- SEE ALSO
This document was created by
using the manual pages.
Time: 09:07:29 GMT, June 23, 2001