Summary of the content on the page No. 1
XFAX
User’s Guide 4.3a
Nordic Messaging Technologies, Sweden, http://www.nordicmessaging.se, info@nordicmessaging.se
Summary of the content on the page No. 2
Contents 1. Overview .....................................................................................................6 2. Installation ...................................................................................................8 3. Configuring the software.............................................................................9 3.1 Keywords ............................................................................................9 3.2 Environment variables ....................
Summary of the content on the page No. 3
14.1 Commands.......................................................................................36 14.1.1 faxadm....................................................................................36 14.1.2 fax2bmp .................................................................................36 14.1.3 fax2hp.....................................................................................36 14.1.4 faxclean .................................................................................
Summary of the content on the page No. 4
15.1.32 FAXNO................................................................................49 15.1.33 FLOW ..................................................................................49 15.1.34 FONTDIR ............................................................................49 15.1.35 GROUP ................................................................................49 15.1.36 HTTP_ENABLE..................................................................49 15.1.37 HTTP_PORT ........
Summary of the content on the page No. 5
15.1.82 T30_RTC .............................................................................56 15.1.83 T30_PAGELENGTH...........................................................56 15.1.84 TONE...................................................................................56 15.1.85 USE_SHM ...........................................................................56 15.1.86 USER_FILE.........................................................................56 15.1.87 WAIT_FOR_TONE..............
Summary of the content on the page No. 6
Overview 1. Overview The fax system is constructed in accordance with a client-server principle, with a fax host that is run in the background and a number of client programs that the user utilizes to communicate with the host. Faxmaster, as the fax server is known, keeps order in the user’s fax queues, checks authorizations, gives the user status information etc. In order to receive information from the faxmaster and give instructions to it, programs such as faxlogon, faxsend, faxq, faxrm etc.
Summary of the content on the page No. 7
Overview XFAXDIR Directory for the configuration files (default is /etc/xfax) SPOOLDIR Directory for messages in the outgoing queue (default is /usr/spool/xfax) BINDIR Directory for the executables (default is /usr/bin) Some important files: XFAXDIR/config Configuration file XFAXDIR/stats Statistics file XFAXDIR/LCK.faxmaster The faxmaster lock file that indicates the faxmaster is running XFAX - User’s Guide 4.3a 7
Summary of the content on the page No. 8
Installation 2. Installation The software is distributed in a tar archive, which extracts into a temporary directory, /tmp/xfax. After the extraction you run a installation script, /tmp/xfax/ INSTALL, which asks questions about your configuration and then puts every- thing in its right place. Go to the root directory cd / Extract the archive, xfax42aix.tar for AIX for example tar xvf xfax42aix.tar Execute the installation script sh /tmp/xfax/INSTALL Check the installation by running faxmaster -v
Summary of the content on the page No. 9
Configuring the software 3. Configuring the software The behavior of XFAX is mainly controlled by a number of keywords used in the configuration file, config. You can alter the way XFAX acts by modifying config and then restart faxmaster. You restart the faxmaster by finding the process id, kill the process and then start the daemon again. Do not use the –9 option when killing the faxmaster process. 3.1 Keywords To use a new keyword in the configuration file add the keyword, preferably at the en
Summary of the content on the page No. 10
Configuring the software 3.3 Adding actions You can tell faxmaster that it should execute a specific script or program after a fax has been sent or could not be sent. This could be useful if you want to update your own database or similar and is done by using the EXECUTE_AFTER_SEND keyword in the configuration file: EXECUTE_AFTER_SEND=/usr/local/bin/faxafter The specified program will be called with a number of parameters. 3.4 XFAX and multiple fax devices To use multiple fax devices, or fax lin
Summary of the content on the page No. 11
Configuring the software XFAX - User’s Guide 4.3a 11
Summary of the content on the page No. 12
Sending a fax 4. Sending a fax Many of the fax messages that are sent are of a very simple nature. They may involve confirmation of an agreed time, an order, cancellation or similar, which only takes up a couple of lines. In such cases it should be possible, by means of a simple manipulation, to send just such a fax from the command line or from your favourite word processor, with the minimum of work on the part of the user. The system can convert text files with the HP Laserjet PCL commands - t
Summary of the content on the page No. 13
Sending a fax # cat price list | faxsend 7586535 -or # faxsend 7586535 -
Summary of the content on the page No. 14
Sending a fax This sends the file news.txt to the recipients who are shown in the file customer- fax. If this method is used then only one copy of the fax file is saved, plus a small control file per recipient, which means that a minimum of hard disk space is taken up. 4.4 Scheduled transmissions A particular time for transmission can be given by using the parameter -t with the time as an argument. E.g.: # faxsend -t 12:18 7586535 letter which means that the file letter is put in the queue for t
Summary of the content on the page No. 15
Sending a fax with a cover sheet, in a simple way. The user is requested to feed in the recipi- ent’s fax number, name and company, and then a page with this is created and the sender’s (your) information plus a message which can be entered in. You can also add files that are to be sent after the introductory cover sheet. This is useful if you wish, for example, to send a price list that is stored in a file to a prospec- tive customer together with a few polite words. You can also set up a telep
Summary of the content on the page No. 16
Sending a fax always give the area code, e.g. in the telephone book, without any problems aris- ing during transmission. Thus it is only necessary to give: # cat newsletter | faxsend - It must be borne in mind that the text that contains the document codes must come up as ASCII text, even when printing out. If, for example, a font in Win- dows is used which is not in the printer, screen data will be generated for the text from the font descriptions in Windows. An XFAX cannot interpret this. The
Summary of the content on the page No. 17
Sending a fax LOCAL_ZONE Gives the zone that should be used when the area code is not included in the telephone number, i.e. with local calls. E.g.: LOCAL_ZONE=LOCALLY AREA_CODES<...> Here one area code is given per line and to which zone the area code belongs. E.g. AREA_CODES< 08LOCAL 031AREA 3 009ABROAD 0091USA > The codes above (AREA 3 etc.) are arbitrary and can be changed, see also below under ZONES. It is worth noting that the system goes through all area codes each time and if several lin
Summary of the content on the page No. 18
Receiving faxes 5. Receiving faxes Receiving a fax is simpler than sending one. It does not require any special effort by the user. The faxmaster receives faxes in the background and sends a message to the system administration and possibly other users when this is done. The fax is placed in a queue for received faxes and can be printed out with the command faxprint. What is also necessary is that the reception function is included in your license agreement and that the keywords SEND_ONLY are no
Summary of the content on the page No. 19
Handling faxes 6. Handling faxes The fax system contains a number of commands for handling faxes and fax queues. A description is given below of what can be done by using these com- mands. Generally, commands are run which affect a fax using the fax’s ID num- ber as an argument. The ID number can be found with the aid of the command faxq. 6.1 Fax queues The system separates faxes into four different queues, which can be shown by giving the parameters shown below as an argument to the command fax
Summary of the content on the page No. 20
Handling faxes INTR Transmission interrupted UNKN Unspecified error Numerical error codes above 20 means that a failure has occurred during fax data transmission. Some examples of error code intervals: 20-39 Handshaking before the page failed 40-49 Fault in the transferring of data 50- Handshaking after the page failed 6.2 Reschedule a fax Outgoing faxes that are awaiting transmission can be “given a push”, i.e. the transmission time can be set to the current time, by using the parameter -n to f
