home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / alib / d6xx / d619 / afaxdemo.lha / AFaxDemo / AFaxDemo.lha / docs / UserGuide < prev    next >
Text File  |  1992-02-09  |  39KB  |  1,149 lines
  1.  
  2.  
  3.  
  4.  
  5.                                 AmigaFax
  6.  
  7.  
  8.                            The Amiga Fax System
  9.  
  10.  
  11.  
  12.                           C-Born Software Systems
  13.  
  14.  
  15.  
  16.                             February 9, 1992
  17.  
  18.  
  19.  
  20. ===========================================================================
  21.  
  22.  
  23.  
  24.  
  25.  
  26.      Copyright (C) 1992 by C-Born Software Systems
  27.  
  28.      All right reserved.  No part of this document may be reproduced,
  29.      stored in a retrieval system, or transmitted, in any form or by any
  30.      means, electronic, mechanical, photocopying, recording, or otherwise,
  31.      without the prior written permission of the publisher.
  32.      Printed in Australia.
  33.  
  34.  
  35.  
  36.      PRODUCTION NOTE
  37.  
  38.      This document was produced using the LaTEX document preparation
  39.      system macro package for AmigaTEX , Tomas Rokicki's implementa-
  40.      tion of Donald Knuth's TEX typesetting system, running entirely on
  41.      Commodore Amiga computers. 
  42.  
  43.      (This particular version was run through dvi2tty, hence it's not
  44.       as pretty as it could be. The original can be supplied as a TeX
  45.       DVI file, for those with TeX.)
  46.  
  47.  
  48. ===========================================================================
  49.  
  50.  
  51.  
  52.                                 Contents
  53.  
  54.  
  55.  
  56. 1  Introduction                                             1
  57.    1.1 What is AmigaFax?   : : : : : : : : : : : : : : : : : : : : : :   1
  58.    1.2 Summary of Features : : : : : : : : : : : : : : : : : : : : : :   1
  59.    1.3 System Requirements   : : : : : : : : : : : : : : : : : : : : :   3
  60.  
  61.  
  62. 2  Installation                                              5
  63.    2.1 Installing the Software  : : : : : : : : : : : : : : : : : : : : :   5
  64.    2.2 Basic Configuration    : : : : : : : : : : : : : : : : : : : : : :   6
  65.    2.3 Hardware   : : : : : : : : : : : : : : : : : : : : : : : : : : : :   6
  66.    2.4 ARP  : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : :   7
  67.    2.5 Extra FONTS    : : : : : : : : : : : : : : : : : : : : : : : : : :   7
  68.    2.6 Printer Setup  : : : : : : : : : : : : : : : : : : : : : : : : : :   7
  69.    2.7 Configuring for Hardware and User Preferences        : : : : : : :   7
  70.  
  71.  
  72. 3  Configuring the System                                  9
  73.    3.1 General Configuration  : : : : : : : : : : : : : : : : : : : : :   9
  74.    3.2 AmigaFax User Interface  : : : : : : : : : : : : : : : : : : : :  10
  75.    3.3 Fax Page Layout Options    : : : : : : : : : : : : : : : : : : :  10
  76.    3.4 Fax Viewer Configuration   : : : : : : : : : : : : : : : : : : :  11
  77.    3.5 Fax Spooler Configuration  : : : : : : : : : : : : : : : : : : :  11
  78.    3.6 Fax Receiver Configuration   : : : : : : : : : : : : : : : : : :  11
  79.    3.7 Fax Transmitter Configuration    : : : : : : : : : : : : : : : :  12
  80.  
  81.  
  82. 4  The Workbench Interface                                13
  83.    4.1 AmigaFax   : : : : : : : : : : : : : : : : : : : : : : : : : : : :  13
  84.    4.2 FaxAutoAnswer    : : : : : : : : : : : : : : : : : : : : : : : : :  15
  85.    4.3 FaxSpool   : : : : : : : : : : : : : : : : : : : : : : : : : : : :  15
  86.  
  87. 5  Operating from the Shell                                17
  88.    5.1 AFAX  : : : : : : : : : : : : : : : : : : : : : : : : : : : : :  18
  89.    5.2 NEWFAX  : : : : : : : : : : : : : : : : : : : : : : : : : : : :  18
  90.    5.3 AFAXSPL : : : : : : : : : : : : : : : : : : : : : : : : : : : :  18
  91.    5.4 MKAFAX  : : : : : : : : : : : : : : : : : : : : : : : : : : : :  18
  92.    5.5 AmigaFax Command File Format      : : : : : : : : : : : : : : :  19
  93.        5.5.1 Fill Mode   : : : : : : : : : : : : : : : : : : : : : : :  20
  94.    5.6 AFAXSEND    : : : : : : : : : : : : : : : : : : : : : : : : : :  20
  95.    5.7 AFAXPRT   : : : : : : : : : : : : : : : : : : : : : : : : : : :  21
  96.    5.8 FAA   : : : : : : : : : : : : : : : : : : : : : : : : : : : : :  21
  97.    5.9 AFAXILBM  : : : : : : : : : : : : : : : : : : : : : : : : : : :  22
  98.  
  99.  
  100. A  Configuration Specifics                                  23
  101.    A.1 FAXLIB:Aliases : : : : : : : : : : : : : : : : : : : : : : : : :  23
  102.    A.2 FONTS  : : : : : : : : : : : : : : : : : : : : : : : : : : : : :  23
  103.  
  104.  
  105. B  Integration with other software                          25
  106.    B.1 UUCP   : : : : : : : : : : : : : : : : : : : : : : : : : : : : : :  25
  107.    B.2 TEX  : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : :  25
  108.    B.3 PostScript   : : : : : : : : : : : : : : : : : : : : : : : : : : :  25
  109.    B.4 Printer Driver : : : : : : : : : : : : : : : : : : : : : : : : : :  26
  110.    B.5 BBS Systems    : : : : : : : : : : : : : : : : : : : : : : : : : :  26
  111.  
  112.  
  113. C  FaxModem Specifics                                    27
  114.    C.1 ZyXEL U-1496  : : : : : : : : : : : : : : : : : : : : : : : : :  27
  115.    C.2 Maestro 9600XR  : : : : : : : : : : : : : : : : : : : : : : : :  28
  116.  
  117.  
  118. ===========================================================================
  119.  
  120.  
  121. Chapter  1           Introduction
  122.  
  123.  
  124.  
  125. 1.1    What is AmigaFax?
  126.  
  127.  
  128. AmigaFax is a software package that, in combination with a FaxModem,
  129. allows you to send and receive facsimile information from your Amiga com-
  130. puter. Received faxes can be viewed, printed, forwarded to other fax ma-
  131. chines, and saved as ILBM files which can then be accessed using many
  132. standard Amiga programs.  You can transmit text, ILBM graphics, and
  133. combinations of these as faxes.  Using the AmigaFax command language
  134. you can add text from any Amiga font, along with logos and ILBM graphics,
  135. to create high quality multi-page fax documents.
  136.    AmigaFax can be set up to automatically send documents to multiple
  137. recipients, to send faxes at or after set times, and to answer incoming fax
  138. calls automatically.
  139.    Faxes can be printed on plain paper, using your normal Amiga printer.
  140.    AmigaFax is highly configurable, allowing you to set up a custom envi-
  141. ronment that best suits your hardware and way of working.
  142.  
  143.  
  144.  
  145. 1.2    Summary of Features
  146.  
  147.  
  148.    o Automatic Reception
  149.      AmigaFax may be configured to receive faxes in the background, or to
  150.      answer an already ringing line in Fax mode. Autoanswer may also be
  151.      integrated with a UUCP or BBS environment, where incoming calls
  152.      may be Fax or data, by using a specially modified version of the getty
  153.      program that recognises Fax calls.
  154.  
  155.    o Automatic Transmission
  156.      Faxes may be queued for transmission after a particular time, to take
  157.      advantage of lower off-peak telecom rates, for example.  You may
  158.      specify the number of times to try before giving up on transmission,
  159.      and the period at which retry attempts should be made.  All call
  160.      progress is logged, and progress may be monitored from the main
  161.      program. Call logging displays when attempts were made, the success
  162.      or failure of the call, and the Called Number ID of the remote Fax
  163.      machine reached.
  164.  
  165.  
  166.    o Multiple Recipients
  167.      Fax numbers may be entered either directly, or using defineable aliases.
  168.      Therefore instead of sending to `99123456', you could send it to `Fred'.
  169.      In the same way, an alias can refer to a list of other aliases, or num-
  170.      bers, so that one fax could be sent to `Customers', representing a list
  171.      of customers.
  172.  
  173.  
  174.    o Flexible Fax Viewer
  175.      The Fax viewer allows you to view a fax document at scales of from
  176.      1:1 to 1:8. A 1:3 scale igenerally gives a quite readable image while
  177.      still fitting the entire Fax width across a standard Amiga screen. You
  178.      can easily zoom in on areas of particular interest if required.
  179.  
  180.  
  181.    o Powerful Document Builder
  182.      This allows you to mix any Amiga font or ILBM graphic on a page,
  183.      include text, ILBM or AmigaFax command files anywhere on a page
  184.      or in a document, perform alignment at character or pixel level, justify
  185.      text regardless of font size, automatically add standard information
  186.      such as address, signature, logo, and current time/date.
  187.  
  188.  
  189.    o Highly User Configurable
  190.      The configuration file allows you to set the system up to suit your
  191.      requirements.  You can define your prefered editor for text and for
  192.      graphics, set a standard file to use as a template when creating new
  193.      Fax documents, customize your dial type (pulse/tone, special prefix
  194.      to get outside line, etc), set the Caller ID string to identify yourself
  195.      to remote Fax machines, define the modem type you are using, and
  196.      set many system default values.
  197.  
  198.  
  199.    o Multiple Serial Port Support
  200.      Using the A2232 multi-serial port card, AmigaFax can support mul-
  201.      tiple FaxModems simultaneously, each modem being able to transmit
  202.      and receive facimiles and data.
  203.  
  204.    o Uses Preferences Printer
  205.      Because the Amiga Preferences printer is used to print out the docu-
  206.      ments, you can tradeoff speed for resolution as you require.
  207.  
  208.    o Workbench or CLI interface
  209.      AmigaFax can be run either from the workbench, or from a shell or
  210.      CLI interface. In either case, an easy to use graphical presentation
  211.      makes operation straightforward.
  212.  
  213.  
  214.  
  215. 1.3    System Requirements
  216.  
  217.  
  218. AmigaFax requires AmigaDOS version 1.3 or greater.  It operates with
  219. AmigaDOS 2.0, and will run on Amigas from the original A1000 through
  220. to the A3000.  It is possible to run on an unexpanded A1000 with 512K
  221. RAM and 1 disk drive, but in this case memory and disk restraints will
  222. limit the number and size of faxes that may be generated or received. In
  223. general the more memory and disk available the better.  For unattended
  224. Auto-receive operation a hard disk system is highly desirable.
  225.  
  226.  
  227. ===========================================================================
  228.  
  229.  
  230. Chapter  2               Installation
  231.  
  232.  
  233.  
  234. Warning: Be sure to back up your original disks, and use working copies
  235. of the disks for normal operation.
  236.  
  237.  
  238.  
  239. 2.1    Installing the Software
  240.  
  241.  
  242. Information on installing the AmigaFax software on your system is given
  243. in the ReadMe file on the distribution disk. Insert the distribution disk, and
  244. from the WorkBench double-click on the ReadMe icon for instructions.
  245.    The installation script should automatically handle most installations.
  246. To use it, from the WorkBench double-click the Install_Now icon, or from
  247. a Shell window type amigafax:install. The script will prompt you for
  248. information required to complete the installation.
  249.    If you are updating to a later revision, the installation procedure will not
  250. overwrite your configuration or alias files, so you will not lose information.
  251. However in this case you may want to examine the files in the directories
  252. lib.user and s.user on the distribution disk for examples of more recent
  253. configuration options.
  254.    The AmigaFaX software requires certain logical assignments to be made.
  255. The installation procedure will create a file afax:s/User-Startup.  You
  256. must edit your S:User-Startup (2.0) or S:Startup-Sequence (1.3)
  257. to include the contents of that file, which will be typically something like:
  258.  
  259. assign afax: Work:AmigaFax
  260. mount null:
  261. run >nil: <nil: l:fifo-handler
  262. if exists afax:s/AFAX-Startup
  263.         execute afax:s/AFAX-Startup
  264. endif
  265.  
  266.  
  267.    If your devs:MountList doesn't contain an entry for the NULL: device,
  268. append the MountList file from the devs directory on the AmigaFax to it.
  269.  
  270.  
  271.  
  272. 2.2    Basic Configuration
  273.  
  274.  
  275. There are many possible ways to operate the AmigaFax software. You may
  276. wish to operate it as the only software using your FaxModem, or have it
  277. share the modem with other software such as AmigaUUCP. The AmigaFax
  278. spooler may be started when you boot up your computer, or only when you
  279. want to send a fax. Fax Auto-Answer may be left on all the time, started
  280. only when you are expecting a fax, or not used at all.
  281.    If you want the fax-spooler to start when you boot up your system, you
  282. must add the line
  283.  
  284.  
  285. run >nil: <nil: AFAX:C/afaxspl
  286.  
  287.  
  288.    to your startup sequence. This can be done in the AFAX:s/AFaxAssign
  289. file, for example. Normally this would only be necessary if you send a lot
  290. of faxes with delayed spooling, and your computer may be rebooted often,
  291. as the spooler is automatically started when sending a fax.
  292.    If you want auto-answer with Fax detection running constantly in back-
  293. ground, you may either use the modified Getty command, or use faa di-
  294. rectly, by adding the line
  295.  
  296.  
  297. run >nil: <nil: faa
  298.  
  299.  
  300. somewhere in your startup sequence.
  301.    Note that the modified getty will allow you to receive data and fax calls
  302. effectively, and is the recommended approach. However if you only wish to
  303. receive faxes, faa is effective and may be started by double-clicking on the
  304. FaxAutoAnswer icon.
  305.  
  306.  
  307.  
  308. 2.3    Hardware
  309.  
  310.  
  311. The cable between your Amiga and Modem MUST connect CTS,RTS,
  312. DTR, DCD, TXD, RXD and GND conductors.  CTS and RTS are used
  313. for flow control handshaking. DTR is used to keep the modem on line -
  314. hangup occurs if it is dropped. DCD is used for carrier detection.
  315.  
  316.  
  317. TXD    2     Transmit Data
  318. RXD    3     Receive Data
  319. RTS    4     Request to Send
  320. CTS    5     Clear to Send
  321. GND    7     Signal Ground
  322. DCD    8     Data Carrier Detect
  323. DTR    20    Data Terminal Ready
  324.  
  325.  
  326.  
  327. 2.4    ARP
  328.  
  329.  
  330. If you have the ARP library installed (Libs:arp.library) the system will
  331. make use of it for file requesters.
  332.    Support for the ASL library under AmigaDOS2.0 will be added to Ami-
  333. gaFax in the near future, and then be used in preference to ARP.
  334.  
  335.  
  336.  
  337. 2.5    Extra FONTS
  338.  
  339.  
  340. Some extra fonts have been included in the FaxFonts directory. You may
  341. let the installation script copy them into your FONTS: directory, or under
  342. AmigaDOS2.0 you may copy them into another directory, and modify your
  343. startup to extend the FONT: assign to that directory. The extra fonts are
  344. from the Computer Modern series, as used with TEX.
  345.  
  346.  
  347.  
  348. 2.6    Printer Setup
  349.  
  350.  
  351. AmigaFax currently uses the standard printer driver, as configured in Pref-
  352. erences.  A future update may allow you to override the default settings
  353. via the configuration file. Using a dot-matrix printer, Halftone Dithering,
  354. Integer Scaling, Black and White, Density 7 appears to work reasonably
  355. well.
  356.  
  357.  
  358.  
  359. 2.7    Configuring for Hardware and User Preferences
  360.  
  361.  
  362. You will need to modify the file FAXLIB:Config to suit your specific hard-
  363. ware and preferences. See Chapter 3 for details on how to do this.
  364.  
  365.  
  366. ===========================================================================
  367.  
  368.  
  369. Chapter  3            Configuring  the  System
  370.  
  371.  
  372.  
  373. The file FAXLIB:Config is used to configure the basic operation of Ami-
  374. gaFax to suit your particular hardware and preferences.  You must edit
  375. this file carefully, using a text editor.  You should always keep a backup
  376. copy of this file. The configuration options are continually being added to
  377. as AmigaFax grows, so if you are upgrading you should look at the latest
  378. copy. This will NOT overwrite your existing configuration as part of the
  379. installation process.
  380.  
  381.  
  382.  
  383. 3.1    General Configuration
  384.  
  385.  
  386.    o Debug
  387.      Debug level, 0-9.  Takes one numeric argument.  Useful for fault-
  388.      finding, observing handshake between the Amiga and your FaxMo-
  389.      dem.
  390.  
  391.    o LogFile
  392.      Specifies the file for logging debug and error information. If not given,
  393.      information will not be logged.
  394.  
  395.    o LocalID
  396.      The rest of the line is used as the local identifier string, which is
  397.      passed to the remote fax machine. This is usually your fax number,
  398.      and is limited to 20 characters.
  399.  
  400.    o Device
  401.      The device to use for connecting to the modem, usually serial.device
  402.      (default). This should only be changed if using a different serial de-
  403.      vice, as with a third-party serial hardware.
  404.  
  405.    o Unit
  406.      Takes one numeric parameter as the unit number to use on the given
  407.      device. Default is 0. For example when using the first port on the
  408.      A2232 multi-serial, set this to 2.
  409.  
  410.  
  411.  
  412. 3.2    AmigaFax User Interface
  413.  
  414.  
  415. These items are used by the afax program.
  416.  
  417.    o Editor
  418.      The name of the your prefered text editor, for example TxEd, ced,
  419.      memacs, dme, mg, or Ed (default). I use mg (MicroGnuEmacs).
  420.  
  421.    o ILBMEditor
  422.      The editor you prefer for editing IFF ILBM graphics, for example
  423.      dpaint.
  424.  
  425.    o Template
  426.      The name of a file to use as a template for building fax documents, If
  427.      given, the editor will be given a copy of this file to work on when you
  428.      ask for a new fax file. This may include references to your address,
  429.      your signature, etc.
  430.  
  431.  
  432.  
  433. 3.3    Fax Page Layout Options
  434.  
  435.  
  436. These items are used by the mkafax program.
  437.  
  438.    o DefaultFont
  439.      This is the default font, used for normal text unless otherwise spec-
  440.      ified.  It takes two parameters, the font name, and size.  The font
  441.      cmtt10 41 looks quite good for standard text.
  442.  
  443.    o HeaderFont
  444.      This is the font used for page headers.
  445.  
  446.    o PHeader
  447.      If given, a header will be printed on each fax page, and the rest of
  448.      the line used as the main text, along with the date, local ID string,
  449.      and page number. If not given, no header will be printed.
  450.  
  451.    o LeftIndent
  452.      The left indentation (border) to be used, in pixels. Many fax machines
  453.      will not print to the full fax width, and typically an indentation of
  454.      at least 50 pixels (approx 1/4 inch) on each size is required to avoid
  455.      losing characters.
  456.  
  457.    o RightIndent
  458.      The right indentation (border) to be used, in pixels.
  459.  
  460.  
  461.  
  462. 3.4    Fax Viewer Configuration
  463.  
  464.  
  465. These items are used by the viewafax program.
  466.  
  467.    o ViewScale
  468.      Takes one numeric argument, 1-8. This is the default scale used by
  469.      the fax viewer when it starts up. A value of three allows a standard
  470.      fax to fit across the screen. A scale of 1 shows maximum detail.
  471.  
  472.  
  473.  
  474. 3.5    Fax Spooler Configuration
  475.  
  476.  
  477. These items are used by the afaxspl program.
  478.  
  479.    o SpoolInterval
  480.      This is the time interval, in minutes, at which the outbound fax queue
  481.      is scanned for untransmitted files.
  482.  
  483.  
  484.  
  485. 3.6    Fax Receiver Configuration
  486.  
  487.  
  488. These items are used by the faa program.
  489.  
  490.    o RSetup
  491.      The receive setup string. This optional string is sent to the modem,
  492.      preceded by AT, when initializing the modem.  This allows you to
  493.      add commands to set such things as speaker use and volume.
  494.  
  495.    o RStatus
  496.      Receive Status. If present, a status window will pop up when a fax is
  497.      being received, showing various details such as name, connect speed,
  498.      transmitter ID, amount of data received. It takes two optional nu-
  499.      meric parameters, which are used for the top and left edge pixel po-
  500.      sitions to place the window.
  501.  
  502.    o DLEmode
  503.      There are many incompatible modems and modem ROM revisions
  504.      about.  This allows you to specify certain things about how your
  505.      FaxModem sends your data. It currently takes one numeric argument,
  506.      (0 or 1).
  507.  
  508.        - 0
  509.          (default) treat DLE in received data as escape (Maestro 3.1,
  510.          ZyXEL 3.99+)
  511.  
  512.        - 1
  513.          Received DLE is g3 data (ZyXEL Vn3.90)
  514.  
  515.  
  516.  
  517. 3.7    Fax Transmitter Configuration
  518.  
  519.  
  520. These items are used by the afaxsend program.
  521.  
  522.  
  523.    o WSetup
  524.      The transmit setup string. This optional string is sent to the modem,
  525.      preceded by AT, when initializing the modem.  This allows you to
  526.      add commands to set such things as speaker use and volume.
  527.  
  528.    o DialType
  529.      Takes the parameters Pulse (default) or Tone.
  530.  
  531.    o DialPrefix
  532.      Prefix to add before number when dialling. I use it to get an outside
  533.      line (dials 0 first), by setting it to ATDP0,DT, which will pulse-dial
  534.      0, then tone-dial the rest of the number.
  535.  
  536.    o DoPadding
  537.      This should not be necessary. However, some FaxModems to not ob-
  538.      serve the minimum scan-time restrictions set by the standard. When
  539.      connecting to slower fax machines, this may result in missed scan-
  540.      lines. Note that if you set this parameter, it will usually result in fax
  541.      transmissions taking longer, as worst-case padding must be added.
  542.  
  543.    o WStatus
  544.      Write Status.  If present, a status window will pop up when a fax
  545.      is being transmitted, showing various details such as name, connect
  546.      speed, receiver ID, percent of file sent. It takes two optional numeric
  547.      parameters, which are used for the top and left edge pixel positions
  548.      to place the window.
  549.  
  550.  
  551. ===========================================================================
  552.  
  553.  
  554.  
  555. Chapter  4         The  Workbench  Interface
  556.  
  557.  
  558.  
  559. Once configured, AmigaFax may be operated either from a Shell or CLI
  560. (Command Line Interface), or from the Workbench. If you choose to op-
  561. erate from the Workbench, you will find three main icons, `AmigaFax',
  562. `FaxAutoAnswer' and `FaxSpool'.
  563.  
  564.  
  565.  
  566. 4.1    AmigaFax
  567.  
  568.  
  569. When you double-click on the `AmigaFax' icon, the main AmigaFax con-
  570. trol window will open.  This allows you to edit, compile and view faxes,
  571. queue them for transmission, review previously queued transmissions, and
  572. so forth. There are currently six string gadgets, six pushbutton gadgets,
  573. and one toggle gadget on the control window.
  574.    The gadget functions are:
  575.  
  576.  
  577.    o FINE/STD
  578.      This toggle gadget allows the user to toggle between Fine (200 DPI)
  579.      and Standard (100 DPI) vertical resolution, when creating AFax files.
  580.      Standard resolution takes half the space, and half the time to trans-
  581.      mit, of Fine mode, but Fine looks MUCH nicer !!
  582.  
  583.    o To:
  584.      This is the intended recipient of the Fax.  It may be just a phone
  585.      number, or it may be an alias. When you enter a string and press
  586.      return, if the first character is a digit it will be treated as a number,
  587.      otherwise it will be checked for aliases. If no aliases are found, the
  588.      string is removed, otherwise the number of aliases found is shown.
  589.      Refer to section A.1 for more information on aliases.
  590.  
  591.    o From:
  592.      This is picked up from the LocalID field in your Config file, if present.
  593.      You may override this value. It is a 20 character string sent to the
  594.      remote Fax to identify you as the sender, usually your phone number
  595.      for return faxes.
  596.  
  597.    o Source:
  598.      This is the name of the fax source document, usually an AmigaFax
  599.      command (.FCOM) file, although plain text or ILBM files may also be
  600.      used. If you press return with an empty string, and ARP is installed,
  601.      a requester will prompt you for a filename.
  602.  
  603.    o AFAX:
  604.      This is the name for the actual fax file. The system will usually pick a
  605.      name for you, but you may wish to override it. Note that the AFAX
  606.      file name will be reserved, but not actually created, until time to send
  607.      the Fax. You may force creation with the "Make" gadget if you wish
  608.      to test that it is created correctly. If a document is to be faxed to
  609.      multiple recipients, only one copy of the AFAX file will be made. It
  610.      is automatically deleted when all recipients have been reached.
  611.  
  612.    o Tries:
  613.      The maximum number of times to try to get a fax through to a
  614.      specific recipient if problems are encountered, such as remote phone
  615.      being engaged. Defaults to three.
  616.  
  617.    o Time:
  618.      The Fax will not be sent until after this time. An empty field means
  619.      send at any time.  Fill in as hh:mm, (24 hour format) then press
  620.      return.  The system will interpret the time, and display the result.
  621.      Time can only be in the future, past time is rounded up by a day.
  622.  
  623.    o New
  624.      Create a new Fax document, and edit it using your configuration
  625.      editor. The file pointed to by the configuration entry "Template" will
  626.      be used as a fax pro-forma. The system will pick a default document
  627.      name for you, which you may keep or override.
  628.  
  629.    o Edit
  630.      Edit a Fax document, using your configuration editor. Note that you
  631.      may set both a text and a graphic editor in your config file.
  632.  
  633.    o Make
  634.      The system will attempt to build an AFAX file from your source
  635.      document. This is not necessary when sending faxes, but does allow
  636.      you to check whether the document will appear as you wish.
  637.  
  638.    o Preview
  639.      Invokes the AFAX viewer program, so you can preview the completed
  640.      document.
  641.  
  642.    o Send
  643.      Your facsimile document will be queued for sending to the appropriate
  644.      recipients. If the fax-spooler is not running, you will be asked if you
  645.      wish to start it.
  646.  
  647.    o QCheck
  648.      This gadget will bring up the queue check window, to monitor the
  649.      progress of outgoing Faxes. From here it is possible to requeue Faxes
  650.      that have exceeded their error allowance, and to remove the spool files
  651.      for faxes that have been successfully sent, or that are still queued for
  652.      transmission.
  653.  
  654.  
  655.  
  656. 4.2    FaxAutoAnswer
  657.  
  658.  
  659. This icon will activate the background automatic-answer facility.  If it is
  660. already operating, you will get the choice of removing the existing applica-
  661. tion (stopping it), or replacing it with the new version. You may wish to
  662. replace it if you have modified the configuration file settings.
  663.    Note that you should only activate the auto-answer system in this fash-
  664. ion if you are not using the GETTY mode of operation, and only want to
  665. receive facimile transmissions, not data.
  666.  
  667.  
  668.  
  669. 4.3    FaxSpool
  670.  
  671.  
  672. This icon will activate the background fax-spooler program. If it is already
  673. operating, you will get the choice of removing the existing application (stop-
  674. ping it), or replacing it with the new version. Note that in normal operation
  675. the main AmigaFax program will start the spooler for you when you queue
  676. a fax for transmission, or you will run it up automatically in your startup
  677. sequence. You may wish to replace it if you have modified the configuration
  678. file settings.
  679.  
  680.  
  681.  
  682. ===========================================================================
  683.  
  684.  
  685.  
  686. Chapter  5         Operating  from  the  Shell
  687.  
  688.  
  689.  
  690. There are 11 separate executable modules included in the release.
  691.  
  692.  
  693.    o afax
  694.      Intuitionized interface for AFAX create/edit/send etc
  695.  
  696.  
  697.    o newfax
  698.      Notifies new fax received, allows print/view/delete, etc [Intuitionized
  699.      interface]
  700.  
  701.  
  702.    o afaxspl
  703.      Fax spooler daemon, many options/features
  704.  
  705.  
  706.    o mkafax
  707.      Convert documents to AmigaFax AFAX IFF file format
  708.  
  709.  
  710.    o afaxprt
  711.      Print and AmigaFax AFAX IFF file using preferences printer
  712.  
  713.  
  714.    o afaxsend
  715.      Send an AmigaFax AFAX IFF file to a remote Fax machine
  716.  
  717.  
  718.    o faa
  719.      Receive Fax documents in auto-answer mode
  720.  
  721.  
  722.    o afaxilbm
  723.      Convert pages from an AmigaFax AFAX IFF file to ILBM format
  724.  
  725.  
  726.    o viewafax
  727.      FAX viewer
  728.  
  729.  
  730. AFAX:c/afax - no command line switches at present. This brings up a win-
  731. dow which you can use to create new Fax documents, edit the documents,
  732. create the actual AFAX files, and send your faxes.
  733.  
  734.  
  735.  
  736. 5.2    NEWFAX
  737.  
  738.  
  739. AFAX:C/newfax faxname This program is automatically invoked by faa
  740. when a fax is received.  It puts up a window informing you of the Fax,
  741. with details about it (name, sender ID, number of pages), and allows you
  742. to view, print or delete the document.
  743.  
  744.  
  745.  
  746. 5.3    AFAXSPL
  747.  
  748.  
  749. [run >nil: <nil:] afax:c/afaxspl  [-s] [-i n]
  750.  
  751.  
  752.    With the -S option, the spooler will run once only, checking for any
  753. faxes waiting to be spooled out. In this mode, it could be launched using
  754. cron/dcron/amicron at whatever times you wish to send faxes.
  755.    Otherwise it will run in background and check for faxes to spool at in-
  756. tervals of every n minutes, where n is the interval in minutes from the con-
  757. figuration file default, optionally overridden by the -i command-line switch.
  758. You could do this perhaps every 1/2 hour, (n = 30), or even at 1 minute
  759. intervals while testing.
  760.    The spooler checks for files of the form FAXSPOOL:*.SPL. These are
  761. human-readable. As calls progress, results are added to the end of the file. If
  762. successfully sent, the file is renamed FAXSPOOL:*.OK . If unsuccessful for
  763. more than the specified number of tries, it is renamed FAXSPOOL:*.ERR
  764. Note that you can re-spool a .ERR file by using an editor to increase the
  765. allowed tries, then renaming it back to .SPL
  766.  
  767.  
  768.  
  769. 5.4    MKAFAX
  770.  
  771.  
  772. mkafax <docfilename> <AFAX_filename>
  773.  
  774.  
  775.    mkafax currently recognizes the IFF file types AFAX and ILBM, plain
  776. text files, and AFAX command text files, as input.
  777.    A plain text file will be converted to an AFAX file using default settings.
  778.    An IFF ILBM will be converted to a single-page FAX document. Only
  779. the first plane is converted, to convert multi-plane (eg DigiView Pics) use
  780. another tool, such as PfiltView (AmigaTeX). May integrate later ?
  781.    An AFAX command file uses lines starting with a dot (.)  as special
  782. commands, similar to TROFF style text processors. The file MUST start
  783. with .FCOM on the first line.
  784.  
  785.  
  786.  
  787. 5.5    AmigaFax Command File Format
  788.  
  789.  
  790. An AFAX command file uses lines starting with a dot (.) as special com-
  791. mands, similar to TROFF style text processors. The file MUST start with
  792. .FCOM on the first line.
  793.  
  794.  
  795.  .FCOM
  796. on the first line to be recognised as a command file.
  797. .FCOM may optionally be followed by a dialstring or target alias.
  798. (Currently unused, future compatability)
  799.  
  800.  
  801. Other commands currently supported are :
  802.  
  803.  
  804.  .PG     Clear out the old page and start a new one
  805.  .LM n   Set the left margin to n characters, in the current font
  806.  .LI n   Set the left  indentation to n pixels (default 50)
  807.  .RI n   Set the right indentation to n pixels (default 50)
  808.  .LJ     Left-justify text and Graphics from now on
  809.  .RJ     Right Justify text and Graphics
  810.  .CT     Center Text and Graphics
  811.  .TS n   Set Tabs every n characters (default 8)
  812.  .PL n   Set page length to n (pixel) rows (default 2292 == A4)
  813.  .FILL   Turn on fill mode
  814.  .NOFILL Turn off fill mode
  815.  
  816.  
  817.  .VERBATIM
  818. All text read in will be printed verbatim, until .ENDVERB
  819.  
  820.  
  821.  .VERBINC filename
  822. Include a file in verbatim mode. Still requires a .ENDVERB
  823.  
  824.  
  825.  .ENDVERB
  826. End verbatim mode
  827.  
  828.  .FONT name size
  829. Set the font as specified. Typical use might be
  830. .FONT topaz 11
  831. .FONT diamond 20
  832. .FONT cmr10 30
  833. and so on.
  834.  
  835.  
  836.  .  (dot followed by white-space) Rest of line is a comment
  837.  
  838.  
  839.  .INC file
  840. Include the named file. File may be text, ILBM, or another command
  841. file. Type is auto-recognised. If a full path is not given to the
  842. include file, the current directory will be searched, then the
  843. FAXLIB: directory. Thus addresses, signatures, etc may be kept
  844. in FAXLIB:
  845.  
  846.  
  847.  .DATE Insert a line with the current date and time, using current font
  848. and line settings.
  849.  
  850.  
  851.  
  852.    Any line not beginning with a . will be processed as normal text, ac-
  853. cording to the current settings.
  854.  
  855.  
  856. 5.5.1   Fill Mode
  857.  
  858. In this mode, lines will be filled from input to full width (inside LR indent)
  859. in the current font. Line filling terminates on a dot command, blank line,
  860. or end of page. Left Margin is disabled while filling.
  861.    See the included test.com file for examples of useage.
  862.  
  863.  
  864.  
  865. 5.6    AFAXSEND
  866.  
  867.  
  868. afaxsend [-t -d -P] <dialstring | alias> <AFAX_filename>
  869.  
  870.    eg afaxsend Jeff MyFaxFile
  871.  
  872.  
  873.  
  874. -D name - Use name for the device  (default serial.device)
  875. -U num  - Use device unit num  (default 0)
  876. -t      - Use Tone Dialing
  877. -P      - Padding on (default)
  878. -p      - Padding off
  879.  
  880.    Attempts to dial out, connect to the remote fax machine, and tranfer
  881. the specified document.
  882.    If the first character of dialstring is not a digit, and not a name alias,
  883. the whole string will we be sent to the modem non-prefixed as a dial string.
  884. If an alias is used, it may be a group alias, resulting in the fax being sent
  885. to everyone in that group.
  886.  
  887.  
  888.  
  889. 5.7    AFAXPRT
  890.  
  891.  
  892. afaxprt [-pnum] <AFAX_filename>
  893.  
  894.  
  895.    eg afaxprt -p2 MyFaxFile
  896.  
  897.    If the -p option is not used, all pages are printed.
  898.    Sends the AmigaFax document to the preferences printer. It is a good
  899. idea to set your printer for high density.  Using a dot-matrix, Halftone
  900. Dithering, Integer Scaling, Black and White, Density 7 appears to work ok.
  901.    Note that this has not been extensively tested with printers other than
  902. the HPLJIII and the Star NX10.
  903.  
  904.  
  905.  
  906. 5.8    FAA
  907.  
  908.  
  909. faa [BaseName]
  910.    Fax auto-answer. Sets up the FaxModem to auto-answer and recognise
  911. Fax or data tranmissions. Incoming Faxes will be saved in AFAX format.
  912. the default BaseName is FAXREC:FAX, so that incoming faxes will be
  913. named
  914.  
  915. FAXREC:FAX0000
  916. FAXREC:FAX0001
  917. FAXREC:FAX0002
  918.  
  919.    etc.
  920.    Note also that although faa recognises the difference between Fax and
  921. Data, it currently does nothing special with data. I hope to integrate this
  922. with the UUCP system in the future. Any other suggestion ?
  923.    To terminate the faa program, send it a CTL_C break.  If you ran it
  924. directly from your shell, just type control-C and wait. If you used RUN or
  925. RUNBACK, send a break to its process number. (eg break 7 all)
  926.    Command Line switches are:
  927.  
  928. -dn     - Set debug on, level n  (default 1)
  929. -D name - Use name for the device  (default serial.device)
  930. -U num  - Use device unit num  (default 0)
  931. -a      - Immediate Answer
  932. -G      - Run from a Getty
  933.  
  934.    The Immediate Answer switch assumes phone is ringing, configures the
  935. modem & answers immediately. It probably makes sense to attach this to
  936. an alias if you use it this way. eg. alias fa "faa -a"
  937.    The Getty option specifies that faa was run from a Getty. It will not
  938. modify the serial port parameters. It assumes that the Getty has answered
  939. the phone, detected a Fax call, and set up the line accordingly. Faa will
  940. connect, collect a Fax document, and return control to the Getty.
  941.  
  942.  
  943. 5.9    AFAXILBM
  944.  
  945.  
  946. afaxilbm [-pnum] <AFAX_filename> <ILBM_filename>
  947.  
  948.  
  949. eg
  950.  
  951.  
  952. afaxilbm -p2 RAM:AFAXR001 FX.ILBM
  953.  
  954.  
  955.    This will extract the specified page from the AFAX file to the named
  956. ILBM file. It may then be viewed using standard ILBM viewing programs,
  957. such as LoadImage from Fish disks 281 and 355, of programs like Deluxe-
  958. Paint.
  959.    If no page number is given, all pages will be extracted to separate files,
  960. and given names of the format base.1 base.2, etc
  961.    The default ILBM file base name is afax_ilbm
  962.  
  963.  
  964. ===========================================================================
  965.  
  966.  
  967. Appendix  A         Configuration  Specifics
  968.  
  969.  
  970.  
  971. A.1     FAXLIB:Aliases
  972.  
  973.  
  974. This file allows you to alias numbers to names, create fax mailing groups,
  975. etc. Aliases may be defined in terms of other aliases.
  976.    For example we could have:
  977.  
  978.  
  979. joe: 1234596
  980.  
  981.  
  982. fred: 9876123
  983.  
  984.  
  985. bill: 0981234
  986.  
  987.  
  988. customers: joe, fred, bill
  989.  
  990.  
  991.    Lines beginning with # are treated as comments, a comma means the
  992. alias list continues.
  993.    The alias system is modelled closely on the one used in Matt Dillon's
  994. UUCP package. See UUCP documentation for more details. Thanks, Matt.
  995.  
  996.  
  997.  
  998. A.2     FONTS
  999.  
  1000.  
  1001. AmigaFax can use all the standard Amiga fonts. Under AmigaDOS2.0 the
  1002. ability to perform font-scaling means that you can generate quite impressive
  1003. documents very easily. The AmigaFax distribution also includes a selection
  1004. of larger sized fonts from the Computer Modern series, which again allows
  1005. very high quality faxes to be produced.
  1006.  
  1007.    These include the fonts cmr10, cmbx10, cmssbx10 and cmtt10 in sizes
  1008. from 29 to 103.
  1009.  
  1010.  
  1011.  
  1012. ===========================================================================
  1013.  
  1014.  
  1015.  
  1016. Appendix  B       Integration  with  other software
  1017.  
  1018.  
  1019. B.1     UUCP
  1020.  
  1021.  
  1022. AmigaFax was designed from the beginning to integrate with UUCP, in
  1023. particular with Matt Dillon's AmigaUUCP1.15D. Using the modified Getty
  1024. program provided, a Fax call will be recognised, and the Fax auto-answer
  1025. program will be called to handle it. Normal logins and UUCP connections
  1026. should function as usual.
  1027.    Other facilities, such as network fax-server capability, can be provided
  1028. to enhance the basic AmigaFax system.
  1029.  
  1030.  
  1031.  
  1032. B.2     TEX
  1033.  
  1034.  
  1035. We have written a dvifax program, which will take a standard TEX .dvi
  1036. file, and transform it to an AmigaFax file, with superb quality output.
  1037. This is not yet provided with the distribution, but is available on request
  1038. to users of the AmigaTEX package, by Radical Eye Software. We hope to
  1039. fully integrate this capability in the future.
  1040.  
  1041.  
  1042.  
  1043. B.3     PostScript
  1044.  
  1045.  
  1046. PostScript support is not yet in place, but it is on the list. Priority given
  1047. depends on demand.
  1048.  
  1049.  
  1050. B.4     Printer Driver
  1051.  
  1052.  
  1053. An AmigaFax printer-driver is also high on the list of things to do. This
  1054. will allow any program that normally produces output using the standard
  1055. Amiga Preferences printer to produce AmigaFax files as output.
  1056.  
  1057.  
  1058.  
  1059. B.5     BBS Systems
  1060.  
  1061.  
  1062. There are scripts provided with the registered version of AmigaFax to al-
  1063. low use of the software as a bulletin-board system.  These make use of
  1064. the excellent VLT communications package, by Willy Langeveld, and the
  1065. fifo.device by Matt Dillon, both available on Fish disks or via ftp for
  1066. those with network access.
  1067.    Writers of other BBS packages are also incorporating support for Ami-
  1068. gaFax in their products, for example the Welmat system, by Russell McOr-
  1069. mond.
  1070.  
  1071.  
  1072. ===========================================================================
  1073.  
  1074.  
  1075.  
  1076. Appendix  C             FaxModem  Specifics
  1077.  
  1078.  
  1079.  
  1080. C.1     ZyXEL U-1496
  1081.  
  1082.  
  1083. The ZyXEL U-1496 provides data rates to v32bis and higher, with v42bis er-
  1084. ror correction and compression. It is capable of facsimile data rates greater
  1085. than 9600bps, currently up to 14400bps. ZeroOne makes ROM upgrades
  1086. available through their BBS, with frequent upgrades. They are very helpful
  1087. and responsive to customer requests.
  1088.    The latest ROM version we have used is V4.00F.
  1089.    With this ROM, it is possible to lock the DCE/DTE data rate for fax
  1090. with the sequence ATS38=8S18=n, where n is the DTE speed as per the S20
  1091. register list, eg 2 for 38.4Kbps, 3 for 19.2Kbps.
  1092.    A few more tips on configuration, with getty. In my standard startup
  1093. line I have been setting the page-length to A4, as my printer is A4, which
  1094. is the standard here. However, it appears that my fax (and most others)
  1095. when appending their header/footer lines, force the page past A4. This has
  1096. not been a problem in the past, but now the U1496 must be obeying the
  1097. page-length setting, and forces out an extra very short page for each A4
  1098. page. This causes handshake problems, etc.
  1099.    So for now, the best solution seems to be setting up for unlimited page-
  1100. length. The AmigaFax software has no problem with this, but your printer
  1101. may, if single-sheet type.
  1102.    Another option allows fax data-rates greater than 9600. Not many fax
  1103. machines support this yet, but we may as well use it, just in case.
  1104.  
  1105.  
  1106. The +FDCC options are as follows:
  1107.  
  1108.  
  1109. +FDCC=1,5,0,2
  1110.  
  1111.       ^ ^ ^ ^
  1112.       | | | +- Page Length: 0=A4(297mm) 1=B4(364mm) 2=unlimited
  1113.       | | +--- Page Width : 0=1728 Pixels in 215mm (Current AmigaFax Limit)
  1114.       | +----- Bit Rate   : 0=2400 1=4800 2=7200 3=9600 4=12000 5=14400
  1115.       +--------Vert. Res. : 0=Normal(98 lpi) 1=Fine(196 lpi)
  1116.  
  1117.  
  1118.  
  1119.    Other options cover compression format, error correction mode, binary
  1120. file transfer, and scan time.  These are not yet supported, probably not
  1121. until the standards are finalized.
  1122.    The line I use to start up Getty is:
  1123.  
  1124.  
  1125. run >nil: <nil: Getty -Mh -B19200 -F2 AT&C1&D2+FDCC=1,5,0,2
  1126.  
  1127.  
  1128.    As I have the FaxModem running from a AS2232 multiport serial card,
  1129. with a maximum baud rate of 19200, I must limit the DCE/DTE rate to
  1130. that.
  1131.  
  1132.  
  1133.  
  1134. C.2     Maestro 9600XR
  1135.  
  1136.  
  1137. This is a low-cost Australian made 2400bps data, 9600bps send/receive fax
  1138. modem, based on the Exar chipset. It does not allow DCE/DTE rate lock-
  1139. ing, and as of the latest version ROMs we have, still has occasional problems
  1140. in correctly synchronising to incoming fax data, resulting in `garbage data'
  1141. faxes, and missing lines from the top of pages. These problems may have
  1142. been fixed in later ROM versions, but we have not been notified of any up-
  1143. grades. The modem software does not appear to observe specified line-scan
  1144. delays, which may result in missing lines when transmitting to older/slower
  1145. fax machines.
  1146.    A typical Getty startup-line for this modem is:
  1147.  
  1148. run >nil: <nil: Getty -Mh -B2400 -F AT&C1&D2+FDCC=1,3
  1149.