home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 001 / hostv11g.arc / FORMGEN.DOC next >
Encoding:
Text File  |  1985-03-31  |  12.4 KB  |  299 lines
  1.  
  2.  
  3.     ---------------------------------------------------------------------
  4.                            FORMGEN VERSION 1.2
  5.     ---------------------------------------------------------------------
  6.  
  7.  
  8.     FORMGEN is a "Mail-Merge" type program intended to be used in
  9.     conjunction with PC-FILE III (or earlier versions).  It interfaces
  10.     with PC-FILE to produce letters with data from your PC-FILE data-
  11.     bases inserted within the body of your letter.
  12.  
  13.   *************************************************************************
  14.                 This program may be obtained by sending $20 to
  15.   *************************************************************************
  16.  
  17.                           William HT Bailey.
  18.                           P.O. Box 29723
  19.                           Elkins Park, PA
  20.                           19117-0923
  21.  
  22.     This version of the documentation was written 2/26/85 by:
  23.  
  24.          Bill Peacock
  25.          Bakersfield, CA 93309
  26.  
  27.  
  28.     CONFIGURING THE PROGRAM:
  29.  
  30.          You can control the screen colors and type of printer that you are
  31.     using, if a file named FORMGSET.FRM is present when you startup FORMGEN.
  32.     A sample FORMGSET.FRM file might look like this:
  33.  
  34.                              7,0
  35.                              27,69
  36.                              27,70
  37.  
  38.          If the program finds FORMGSET.FRM on the default drive upon
  39.     startup, then it will read the screens foreground and background colors
  40.     from line 1.  In the sample, the 7 specifies a foreground color of
  41.     white and the 0 specifies a background color of black.  Lines 2 and 3
  42.     are optional.  Line 2 contains the ASCII codes of the string the
  43.     program will send to the printer before printing.  Line 3 contains
  44.     the ASCII codes of the string the program will send to the printer
  45.     after printing to turn the printing mode off.  In the sample, the 27
  46.     and 69 represents the characters "ESC" and "E".  This string sets the
  47.     emphasized mode on EPSON or EPSON code compatible printers.  The 27
  48.     and 70 on line 3 represents the characters "ESC" and "F".  This string
  49.     turns off the emphasized mode on EPSON code printers.  The entries on
  50.     each line must be separated by commas.  This file allows you to set
  51.     the configuration codes for your monitor and printer with a simple
  52.     file that you can create with "COPY CON" , with your word processor or
  53.     with FORMGEN itself.
  54.  
  55.  
  56.  
  57.                                   - 1 -
  58.  
  59. -
  60.  
  61.                                                                           (2)
  62.     SUGGESTION:
  63.  
  64.          Because FORMGEN is a fairly small file, I would suggest that
  65.     you copy the FORMGEN.EXE and the FORMGSET.FRM files to your PC-FILE
  66.     program disk.
  67.  
  68.  
  69.     RUNNING THE PROGRAM:
  70.  
  71.          After loading the program, the main menu looks like this:
  72.  
  73.                         0. EXIT
  74.                         1. CREATE/EDIT A FORM
  75.                         2. OUTPUT A FORM
  76.  
  77.          After you see the Main Menu, choose "CREATE/EDIT" (1.) and the
  78.     program will prompt you with "Which drive has the data? (A,B,C,D):"
  79.     The program requires that the FORMGEN forms (.FRM extensions) AND the
  80.     PC-FILE data-base files both be on the same drive (or sub directory.)
  81.  
  82.          Answer the drive question and you will be shown the names of the
  83.     data-bases on the drive specified under the message "*** DATA FILE".
  84.     Enter the name of the data-base you wish to work with.  The program
  85.     will then ask which FORMGEN form file you wish to work with under the
  86.     message "*** FORM FILE" (no extension req.).  If you haven't created
  87.     a form yet, hit the enter key and you will get the following.
  88.  
  89.        Ins,Mod,Del,List,Store,Quit, Headers or ? (I,M,D,L,S,Q,H,?)
  90.  
  91.        A more understandable definition of the commands follows:
  92.  
  93.          I - (insert) --- Used to insert lines.
  94.          M - (modify) --- Used to alter line.
  95.          D - (delete) --- Used to delete or remove lines.
  96.          L - (list) ----- Screens 20 lines of the form.
  97.          S - (store) ---- Save file to drive you specified at startup.
  98.          Q - (quit) ----- Returns you to main menu.
  99.          H - (headers) -- Shows the fields and the order of the
  100.                           data-base you loaded at startup.
  101.          ? - (question) - Will display 3 screens of instructions.
  102.  
  103.          Type "H" and press "Enter" and you will get a screen of the
  104.     relative number, name and length of the fields that make up the
  105.     data base you called up.  Jot these down on a piece of paper (or
  106.     hit upper case/PrtSc and print it) so that you can refer to them
  107.     as you create the form.  Otherwise you can execute this "H" option,
  108.     as needed, when you are creating the form.
  109.  
  110.          After you have made your notes, type "M" and press "ENTER".
  111.     The next prompt will be "Line Number:".  I would assume that
  112.     you wish to start a new form at line 1, so type "1" and press
  113.     "Enter".  This option allows you to modify the initially blank
  114.     lines in the form with the contents of your form. You can exit
  115.     the modify mode, at the end of your form or to correct an error on a
  116.     previous line or to review the headers, by pressing the ESC key.
  117.  
  118.          You will now see " 1> " which is telling you that you can
  119.     begin typing your form at line number 1.  If you don't want any
  120.     data on the line, just press "Enter".  Note the reverse video box
  121.     in the lower right hand corner of the screen.  This little beauty
  122.     tells you which vertical space you are in and is a very good guide
  123.     as to the margins.        (continued)
  124.  
  125.                                   - 2 -
  126.  
  127. -
  128.  
  129.  
  130.                                                                           (3)
  131.  
  132.          If your form is less than 66 lines long, enter a "\" in the
  133.     first column of the last line after your last line.
  134.  
  135.          The Insert (Ins), Delete (Del), Home, End and Destructive
  136.     Backspace (<-) keys are all active.
  137.  
  138.  
  139.     INSERTING DATA FROM YOUR DATA-BASE IN THE FORM:
  140.  
  141.          To insert data from your PC-FILE data disk, all you have to
  142.     do is enter "|" (upper case left hand back slash key) followed by
  143.     the number of the field that you desire to be printed and then "\".
  144.  
  145.                                EXAMPLE: |1\
  146.  
  147.          After you have typed this in, the program will show you
  148.     the length of the field.
  149.  
  150.                                EXAMPLE:  |1\~~~~~~~~~~~
  151.  
  152.          If you are using the information in a structured form, this is
  153.     sufficient. If you are inserting the data in a form letter however,
  154.     this command will generate the number of spaces that the data-base uses
  155.     and will create blank spaces in the line.  To prevent this from
  156.     happening, enter the call-up command with a minus sign (-) before the
  157.     field number.
  158.  
  159.                                EXAMPLE: |-1\
  160.  
  161.     ----------------------------------------------------------------------
  162.          An example of the CREATE/EDIT screen follows:
  163.  
  164.      1>
  165.      2>
  166.      3>  |1\~~~~~~~~~~~~~~~~~                 (NAME field)
  167.      4>  |2\~~~~~~~~~~~~~~~~~~~~~~~           (ADDRESS  field)
  168.      5>  |-3\~~~~~~~~~~~~~~, |-4\~~~~~ |5\~~~~  (CITY, ST, ZIP fields)
  169.      6>
  170.      7>
  171.      8>  Dear |1\~~~~~~~~~~~~~                (NAME field inserted)
  172.      9>
  173.     10>       Once in a while a rare opportunity to make your hard
  174.     11>  earned dollars work for you comes along. We feel that
  175.     12>  this rare chance has come to |-3\~~~~~~~~~~~~~~~.
  176.     13>
  177.     14>                Yours Truly,
  178.     15>
  179.     16>
  180.     17>                Herman Swartz
  181.     18>                General Manager
  182.     19>
  183.     20>\
  184.  
  185.                                   - 3 -
  186.  
  187. -
  188.  
  189.  
  190.                                                                           (4)
  191.          Note that the CITY field was inserted at the end of the para-
  192.     graph and the CITY, STATE and ZIP fields were all in one line.
  193.          Remember to put the minus sign before the field number if you
  194.     insert a field in the middle of a line.
  195.  
  196.          Note that a "\" was placed as the first character in line 20.
  197.     This tells the program that you are finished with the form and
  198.    that you are ready for the command line.  The left hand back slash
  199.    key is just left of the "Z" key below your left little finger.  This
  200.    is very important if your form is less that 66 lines.  If you forget
  201.    this, the program will produce a full 66 line page on output regard-
  202.    less of the number of lines that you specified when you made the
  203.    form in first place.
  204.  
  205.  
  206.     STORING (SAVING) THE FORM:
  207.  
  208.          Now choose the "S" (Store) command and the program will ask
  209.     you for a name for your form.  Name the form using eight or less
  210.     characters and don't worry about an extension.  The program will
  211.     automatically add an extension of "FRM" to the name you gave the
  212.     file and will also store it on the drive you specified at startup.
  213.     When this is done, the program will return you to the Main Menu.
  214.  
  215.  
  216.     EDITING A FORM:
  217.  
  218.          To modify, add, or delete lines in your form, just call it
  219.     up in a similar fashion to how you started.  At the second screen,
  220.     when the program asks "Name of Form" enter the name of the form
  221.     you wish to work on and press "Enter".  You will now get the
  222.     commands line.  Enter "L" (List) and you will be asked for the
  223.     line number.  Enter "1" and the screen will fill with the first
  224.     20 lines of your document starting with line #1.  To correct or
  225.     change, enter "M" (Modify) and you will be asked again for a line
  226.     number.  Screening more than one line at a time allows you to see the
  227.     line in context. If you don't wish to change anything on a line, just
  228.     hit "ENTER". Deleting (D) and Inserting (I) a line (or lines) follows a
  229.     very similar format.
  230.  
  231.          Be very careful when using Insert because it will push anything
  232.     you had on the last line into oblivion.  The best thing to do is to
  233.     use List and review the entire document before attempting to insert
  234.     anything.
  235.  
  236.  
  237.  
  238.  
  239.  
  240.                                   - 4 -
  241.  
  242. -
  243.  
  244.  
  245.                                                                           (5)
  246.     OUTPUTTING (PRINTING) A FORM:
  247.  
  248.          Following the same methods described earlier, follow the prompts
  249.     until you get to the questions regarding the output.  The program
  250.     will allow you to "Select" for printout in a manner similar to the
  251.     prompts used in PC-FILE except that Formgen repeats the selection pro-
  252.     cedure on each field.  Most of the screen messages in this section
  253.     are easy to follow so you shouldn't have any problems.
  254.  
  255.  
  256.     NOTES:
  257.  
  258.     1. Forms created with FORMGEN are ASCII files and can be edited
  259.        with your Word Processor.  Imbedded printer commands work
  260.        properly but be very careful with the "Call-Up" commands created
  261.        when you made the form in the FORMGEN program originally.
  262.  
  263.     2. If one of the data fields that you called up in your form is
  264.        empty, the program will append the blank line at the bottom
  265.        of the page.  This insures forms of uniform length.
  266.  
  267.     3. If you need to stop the output for any reason, (ESCAPE key) you
  268.        can re-start printing without starting all over by using the
  269.        sorting options.
  270.  
  271.     4. If you wish to use a window envelope for your mailing and you
  272.        want the name and address printed on your form to appear in
  273.        the window, you would put the name at line 15, the address at
  274.        line 16 and city-state-zip at line 17.
  275.  
  276.     5. If you wish to call the program up easily, you can create a
  277.        small batch file called "FG.BAT."  The file can easily be
  278.        created from DOS using the "COPY CON:" command.  The step-by-
  279.        step procedure would go like this:
  280.  
  281.        a. At the DOS prompt " A> " prompt, type " COPY CON:FG.BAT"
  282.  
  283.        b. Hit "Enter" and the cursor will move down one line.
  284.  
  285.        c. Type "FORMGEN" and hit "Enter" and the cursor will move down
  286.           one more line.
  287.  
  288.        d. Hit the F6 key (or Control Z) and press "Enter."
  289.  
  290.        e. The screen should display the message "One file copied"
  291.  
  292.        Now to call up the FORMGEN program just type "FG" and press
  293.        "Enter" and the program will load.  Sure beats typing "FORMGEN"
  294.        every time.
  295.  
  296.  
  297.  
  298.                                   - 5 -
  299.