home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 15 / CD_ASCQ_15_070894.iso / vrac / qfax20.zip / QUICKFAX.DOC < prev    next >
Text File  |  1994-02-16  |  13KB  |  339 lines
  1.                             QUICKFAX V 2.0
  2.        Copyright (C) 1993, 1994; CrossWare; All Right Reserved
  3.  
  4.  
  5.     SUMMARY
  6.     -------
  7.     QUICKFAX reads messages and converts them into a format  suitable for
  8.     faxing.   QuickFax requires a command line fax software such as QLINK
  9.     (which probably came with your fax card) that is capable of sending a
  10.     FAX via "command-line" functions.  Check your FAX manual for details.
  11.  
  12.     First create a message area to receive the messages to be faxed.  The
  13.     message area may be in a Fido (*.MSG), Hudson, Squish, Jam, or EZYCon 
  14.     format.  You may make this message area either local or allow others 
  15.     to  send echo mail to the message area.
  16.  
  17.     Also for those that are registered user of Silver Express by Hector
  18.     Santo, you can use the FormTols utility and use Fax forms. See file
  19.     115-Fax for sample files.
  20.     
  21.  
  22.     SETUP
  23.     -----
  24.     1.  Place the QUICKFAX files in any directory you wish.   This
  25.         directory must contain the following QUICKFAX files:
  26.  
  27.             QUICK.EXE
  28.             QUICKFAX.CFG
  29.       
  30.      Depending on the method use for checking you will also need:
  31.            
  32.       For LIMITED Checking (see below for further description)           
  33.            LIMITED.LST - a text file listing allowed numbers to send faxes
  34.  
  35.       For PREFIX Checking
  36.            PREFIX.LST - A text file contain a list of allowed telephone
  37.                         prefixes to send fax message to
  38.  
  39.       For DEFAULT Checking
  40.             SECURE.LST  - A list of users that can send faxes to local 
  41.                           distance numbers
  42.  
  43.             NUMBERS.BAD - A list of numbers that NO faxes may be sent to
  44.  
  45.             Once executed, QUICKFAX will  generate a  log file  called
  46.             QUICKFAX.LOG (original huh????) in this directory.
  47.  
  48.     2.  Edit the configuration file QUICKFAX.CFG either by running QUICKFAX
  49.         with out any parameters and choosing MAKE CONFIGURATION from the
  50.         menu using any text editor. You must be very careful to provide 
  51.         the following data.
  52.  
  53.            Required Data                           Example/Options
  54.           -------------------------------------    ---------------
  55.           Line 1:  SYSOP Name                      Joe Smith
  56.           Line 2:  Name of your BBS                The Great BBS
  57.           Line 3:  BBS Telephone No.               (615) 555-1212
  58.           Line 4:  Location of BBS                 Anywhere, WY.
  59.           Line 5:  Message base directory          FC:\MSG\FAX\
  60.  
  61.              For Fido Message base (*.MSG) directory:
  62.                      F<full path>         (FC:\MSG\FAX\)
  63.  
  64.              For Hudson Message Base (QuickBBS, etc.):
  65.                      H<base #><full path>  (H019C:\BBS\)
  66.  
  67.                     [NOTE:  BASE # MUST CONSIST OF 3 DIGITS]
  68.  
  69.             For Squish Message Base:
  70.                     S<full path> + name of *.SQL file
  71.                         (SC:\SQUISH\MSG\Fax)
  72.  
  73.             For JAM Message Base:
  74.                    J<Full Path>  (JC:\MAIL\LOCAL\)
  75.  
  76.            For EZYComm
  77.                    E<MsgBase><Path> (E0005C:\MAIL)
  78.           
  79.           Line 6:  Path to fax software               C:\FAX\
  80.           Line 7:  Temp files path                    C:\FAX\
  81.           Line 8:  Bad messages path                  C:\FAX\BADMSG\
  82.           Line 9:  Fax text conversion command
  83.  
  84.            Include all commands & necessary parameters. Use ^F to
  85.            indicate the file name for example
  86.  
  87.                                                 CONVERT C:\fax\^F /T
  88.  
  89.            If no conversion is needed, QuickFax produces a TXT format, then           
  90.            enter NONE.
  91.  
  92.            (NOTE: it is recommended to give the path if the
  93.            files to be faxed are stored in a different directory
  94.            than the fax software)
  95.  
  96.  
  97.           Line 10: File extension fax file           .QFX or NONE
  98.           Line 11: Send Fax command
  99.  
  100.              Once again include all commands & necessary
  101.              parameters.  Use ^F to represent the file name and
  102.              ^P for the phone number.
  103.                                                     FAX /S: ^F /N: ^P
  104.           
  105.           Line 12: Errorlevel for successful fax      0
  106.  
  107.           Line 13: Method for Checking - LIMITED, PREFIX, DEFAULT    
  108.           
  109.              Limited a file, LIMITED.LST, contains a list of numbers to
  110.              which faxes are permitted.  Faxes will only be sent to these
  111.              numbers. This is the most sercure but limits users to pre-
  112.              selected numbers. Can be used for ALL Phone numbers.
  113.  
  114.              PREFIX - a PREFIX.LST file contains a listing of phone prefixes
  115.              to which faxes are permitted to be sent.  If allowing long 
  116.              distance or international call be sure to including any special 
  117.              strings and country codes.  For example 1-01-676.  Can be used
  118.              for ALL numbers.
  119.  
  120.              DEFAULT - Checks the phone format, MUST be in either the XXX-XXXX
  121.              or 1-XXX-XXX-XXXX format.  1-800 numbers are automatically allowed
  122.              for long distance calls.  If a call is determined to be long
  123.              distance then Secure.lst name is checked to see if the user is
  124.              allowed long distance service.  Finally a list of numbers in 
  125.              NUMBERS.BAD is checked to see if this is a blocked number.
  126.  
  127.  
  128.     3.  Edit your BBS batch file to execute QUICKFAX upon exit.  A
  129.         file called FAXIT.BAT will be created in the fax  software
  130.         directory (Line 6 of QUICKFAX.CFG).  QUICKFAX also creates
  131.         a text file of the message in the same directory.  To send
  132.         the fax, execute FAXIT.BAT and your fax software will take
  133.         this text file and convert it to a fax compatible file (by
  134.         using the command and options in Lines 9 & 10).  The  file
  135.         will then be faxed (using the command and options in Line
  136.         11).
  137.  
  138.            Example .BAT file:
  139.  
  140.               ....this is where BBS exit occurs
  141.            REM ... Check for fax
  142.            CD \QUICKFAX
  143.            QUICKFAX /A
  144.            IF EXIST C:\FAX\FAXIT.BAT GOTO FAX
  145.            GOTO DONE
  146.  
  147.            :FAX
  148.            CD \FAX
  149.            CALL FAXIT.BAT
  150.  
  151.           :DONE
  152.               ...continue from here
  153.  
  154.     4. Edit the text files as appropriate for you Checking Method.
  155.  
  156.        a. LIMITED.LST - an ascii text file listing the prefixes in a column.
  157.  
  158.        b. PREFIX.LST - an ascii text file listing the prefixes in a column.
  159.  
  160.        c. For DEFAULT -
  161.  
  162.           Edit SECURE.LST, which contains a list of names  that  have
  163.           authority to send a long distance fax. This file MUST exist
  164.           even if it is empty.  If the name does not  appear  in  the
  165.           list then they will only be able to send a local fax and  a
  166.           fax to 1-800 numbers.  If a message is entered for  a  long
  167.           distance fax and the person is not allowed to, then the msg
  168.           will be moved to the BAD directory and an entry made in the
  169.           QUICKFAX.LOG.
  170.  
  171.           Finally edit NUMBERS.BAD.  As you might guess this is a
  172.           list of numbers that you don't want FAXES sent to or
  173.           attempted to be sent to.  Why?  Well unfortunately someone
  174.           may want to send a 100 faxes to your local Police Chief
  175.           who in turn may get upset with you :). Or any other such
  176.           numbers.  Even if empty this file must also exist.
  177.  
  178.  
  179.     USAGE
  180.     -----
  181.     To use QUICKFAX, just enter a message in the designated message
  182.     base.  You MUST enter the following information on the  SUBJECT
  183.     line of the message:
  184.  
  185.     xxx-yyyy / <Subject of Fax>
  186.  
  187.        Where xxx-yyyy is the destination of the fax.  If only a number
  188.        is listed then the Default Subj line of 'RE:' will be added.
  189.        
  190.     
  191.     EPILOG
  192.     ------
  193.     You will have to look through your FAX documentation  carefully
  194.     to ensure you have the proper command line input for CONVERTing
  195.     the text files to fax compatible (if required by your software)
  196.     and SENDING the fax.  Studying examples and typing in  commands
  197.     by themselves may give a "help" listing of options.
  198.  
  199.  
  200.     Running QuickFax
  201.     ----------------
  202.     QuickFax can be ran either from the menu or from the commandline.
  203.     Using the command 'quickfax' will give you an easy to follow menu with
  204.     program information as well as a setup menu and fax generation.
  205.  
  206.     
  207.     To run it as a nightly event from a batch file use the command
  208.     'quickfax /a'.  This will allow for full automation. Using the
  209.     command 'quickfax' will give you an easy to follow menu with
  210.     program information.
  211.  
  212.  
  213.     Register Users
  214.     --------------
  215.     Make sure the file, Quickfax.key is in the same directory as
  216.     the Quickfax program.
  217.  
  218.  
  219.     Hints
  220.     -----
  221.     Some fax software may have difficulty running in a Desqview
  222.     environment. The memory requirements for Quickfax have been
  223.     kept to a minimum.  However some fax software allow for you to
  224.     set as a parameter the time when you would like for the faxes
  225.     to be sent out.  If your software supports this feature then as
  226.     the third fax parameter enter the command required by your
  227.     software ie /T:2300.  Now you can set an event to send the fax
  228.     at a later time and the memory usage will even be less.
  229.  
  230.  
  231.     QuickFax has been tested and regulary used with BGFAX and Silver
  232.     Express.  For example Silver Express setup files see 11-FAX.ARJ.
  233.  
  234.  
  235.     RECOGNITION
  236.     -----------
  237.        QLINK (or QuickLink) is (c) Smith Micro Software, Inc.
  238.        QuickBBS is (c) Pegasus Software, Inc.
  239.        BGFAX is (c) B.J Guillot
  240.        Silver Express (c) Hector Santos
  241.  
  242.        Also many thanks to the beta testers of QUICKFAX who spent
  243.          their time making this what it is......
  244.  
  245.              Jim Timlin, 1:206/2604, Message Center BBS
  246.              Jerry Ferris, 1:206/2602, Jerry's BBS
  247.              Don Kettle, 1:252/120, Barrie Users Group
  248.              Jay Spence, 1:106/6879, Back Draft BBS
  249.  
  250.        Also special acknowledgement to Scott Montle for his many 
  251.           suggestions ( you thank him for the removal of the CLICK in 
  252.           none registered version) and the tremendous help in interfacing
  253.           QUICKFAX with Silver Express.
  254.  
  255.             and yes, the Missus for putting up with all of
  256.                  this..........
  257.  
  258.  
  259.     REGISTRATION
  260.     ------------
  261.     The unregistered version allows for 45 days for you to evaluate the
  262.     program.  If you feel that this is not enough time for you, you may
  263.     send a message to NightShift BBS, 1:3805/13, and I will place on
  264.     hold for you an additional key for you to evaluate the program.
  265.  
  266.  
  267.    Disclaimer & Contract Agreement
  268.    -------------------------------
  269.  
  270.     Although this program has been tested, this software has no warranty,
  271.   either expressed or implied.  The use of this software is at the user's
  272.   own risk.  The author shall in no way be responsible for any special,
  273.   incidental, consequential or other damages resulting from the use and/or
  274.   misuse of this software.  Every effort has been made to test this software
  275.   and its documentation for possible errors, but no guarantee to that effect
  276.   is made.  There are no written or implied guarantees of updates to this
  277.   program.
  278.  
  279.     This program must be distributed AS IS in it's original archive.  This
  280.   program may not be distributed as part of any other software package without
  281.   the expressed written consent of the author, Jack Cross.  It may not be
  282.   altered or reverse engineered in any way, shape, or manner.
  283.  
  284.     By using this program you agree to evaluate it for your continued use as 
  285.   permitted by one trial key.  Use beyond this period is an obligation to 
  286.   register this program.  Failure to do so is a breech of contract subject to
  287.   the laws of your state.
  288.  
  289.  
  290.  
  291.  
  292.  
  293.                -----------------  Registration  -----------------
  294.  
  295. Name___________________________________
  296.  
  297. Address___________________________________
  298.  
  299. City_________________________  State/Prov__________ Country ___________
  300.  
  301.                                                  Zip________________
  302. FidoNet Address________________
  303.  
  304. FamilyNet Address______________
  305.  
  306. BBS Software ____________________
  307.  
  308. Computer Type____________________
  309.  
  310.  
  311.                                      Program
  312.  
  313.                ___ QuickFax               20.00           _______
  314.  
  315.                ___ FileRequest Reporter   15.00           _______
  316.  
  317.                ___ File Reporter          10.00           _______
  318.  
  319.                ___ FreqLeech              15.00           _______                                 
  320.                
  321.                ___ GoGet                  10.00           _______
  322.  
  323.                ___ Any three              25.00           _______
  324.  
  325.                                TX residents, please add
  326.                            7-1/4 % for sales taxes        _______
  327.  
  328.  
  329.                                                   Total   _______
  330.  
  331.  
  332.                        Checks or MO payable to:
  333.  
  334.                             Jack Cross
  335.                             CrossWares
  336.                          103 Galaxy Crt
  337.                      Wichita Falls, TX  76311
  338.  
  339.