PAGESEND(8)						      System Manager's Manual						       PAGESEND(8)

NAME

       pagesend - HylaFAX IXO/TAP and UCP transmit program

SYNOPSIS

       /usr/sbin/pagesend [ -l ] [ -p ] [ -c config ] -m device-ID qfile

DESCRIPTION

       pagesend  is  the program that implements the IXO/TAP and the UCP transmission protocol for the HylaFAX system.	pagesend is invoked by the
       faxq scheduler process for each pager transmit attempt.	pagesend assumes that its current working directory is the  top  of  the  spooling
       hierarchy  and  that  a suitable modem device has been allocated for its use.  In normal use pagesend will inherit a lockfile for the modem
       from the faxq process.  The format of the job description file specified on the command line is described in sendq(5).

       pagesend initializes the modem before attempting to transmit the pager message using the information in the appropriate modem configuration
       file.   If  the	modem  does  not  respond to this initialization, pagesend will repeatedly try to initialize the modem.  This behaviour is
       required for send-only environments in which a faxgetty(8) process is not run (and the modem would be known to be in a properly initialized
       state).	 pagesend  catches  SIGINT  and SIGTERM and cleans up any resources it controls; this is the mechanism used by faxq to abort a job
       while it is in progress.

       Many aspects of pagesend operation are controlled through a configuration file.	The configuration file is located in the spooler hierarchy
       in  the etc subdirectory and is named config.device-ID; consult hylafax-config(5) for detailed information on the contents of configuration
       files.

       The protocol which must be used for a specific service provider is controled from the hylafax-info(5) file.

OPTIONS

       -c config Treat config as a configuration parameter specification that is interpreted after reading the per-device configuration file.  For
		 example,  ``-c  sessiontracing:0x4f'' would set the SessionTracing configuration parameter to ``0x4f'', overriding any setting in
		 the configuration file.

       -m devID  The device to use in processing the job.  Note that this is a device identifier and not the pathname of the tty special file.	 A
		 device identifier is formed from a device filename by removing any leading ``/dev/'' and converting any ``/'' characters to ``_''
		 characters.

       -l	 Do the UUCP lockfile protocol in pagesend.  By default pagesend assumes that it is invoked with the  device  already  locked  and
		 that it does not need to manage the lockfile.

       -p	 Do  not  change  the  process priority when transmitting.  Normally pagesend will raise its priority to reduce i/o latency.  This
		 option is useful for debugging.

NOTES

       pagesend returns the new job status to faxq through the exit(2) return value of the process: send_retry (0), retry  job;  send_failed  (1),
       job  finished  without  success,  send_done  (2),  job completed successfully, send_reformat (3), job should be retried after documents are
       reformatted.

FILES

       /var/spool/hylafax/etc/config.devID     device-specific configuration file

       Consult hylafax-server(5) for a complete discussion of the structure and content of the spooling area.

SEE ALSO

       faxq(8), hylafax-server(5), hylafax-config(5), hylafax-info(5)

								  October 3, 1995						       PAGESEND(8)