home *** CD-ROM | disk | FTP | other *** search
/ RBBS in a Box Volume 1 #2 / RBBS_vol1_no2.iso / add2 / frm_rpt.zip / FRM-RPT.DOC < prev    next >
Text File  |  1989-02-10  |  10KB  |  222 lines
  1.  
  2.        FORMS.EXE  and  REPORTS.EXE
  3.        ---------       -----------
  4.        These programs came about from a need to have documentation for the 
  5.        different screen and report forms that were being designed for some 
  6.        very  extensive  Paradox  v 2.0 applications.   The  programs  will 
  7.        extract the form or information and create a text file that can  be 
  8.        printed  and stored with the other application documentation.   The 
  9.        text  files are replications of the Paradox form or report  design.  
  10.        What you design is what you get.
  11.  
  12.        OPERATION
  13.        ---------
  14.        The  first  thing  you will want to do is copy all  the  screen  or 
  15.        report  form  files (*.F?? or *.R??) into a separate  directory  or 
  16.        onto a separate floppy.  This is to protect your original files and 
  17.        other important data from any possible damage or accidental eraser.  
  18.        The  programs  also creates default output file name that  are  the 
  19.        original name plus an 'A' at the end.  The programs will  automati-
  20.        cally  rename output files for reports and screens which have  more 
  21.        than  3 character extensions. For instance, with Paradox v 2.0  you 
  22.        may  have up to 14 forms plus the standard form.  In this  instance 
  23.        the  output  from EXAMPLE.F would be EXAMPLE.FA,  the  output  from 
  24.        EXAMPLE.F1  would be EXAMPLE.F1A.  Forms and reports from 10 to  14 
  25.        would be renamed following a hexadecimal scheme.  Thus output  from 
  26.        EXAMPLE.F10   would  be  EXAMPLE.FAA  and  EXAMPLE.F14   would   be 
  27.        EXAMPLE.FEA.   In this way output files should not  interfere  with 
  28.        any  other  files.  The file naming conventions are used  with  the 
  29.        program REPORTS.
  30.  
  31.  
  32.        The  programs  are  very simple to operate and have  two  modes  of 
  33.        operation.
  34.  
  35.        Option 1:
  36.        ---------
  37.        At the DOS prompt type FORMS (or REPORTS) hit enter and the program 
  38.        will ask you for an input file name. DOS path are supported if  the 
  39.        files are not in the current directory.  Enter the name you want to 
  40.        copy to a text file and hit enter. 
  41.  
  42.              [drive:][path]filename.ext
  43.  
  44.        Next  the program will ask for an output file name showing  to  the 
  45.        right  that the default is the input filename.  As  previously  de-
  46.        scribed the program will rename the output file appropriately so as 
  47.        not to over-write the input file. 
  48.  
  49.              [drive:][path]filename.ext
  50.  
  51.        All  the  normal limitations for DOS file name apply  (8  character 
  52.        name plus 3 for extension) and if a '.' is not detected one will be 
  53.        added.   Hit  enter  when you have the output file  named  and  the 
  54.        program will continue its operation.  
  55.        
  56.        The  final question that is asked is if you want a  straight  ASCII 
  57.        file  or if graphic characters used for borders and boxes  will  be 
  58.        left  as is or converted to characters between 32 and  127  (normal 
  59.        printing characters).  Answer 'Y' and the conversion will be  done; 
  60.        answer 'N' and the conversion will not be done.
  61.  
  62.        To cancel the programs operation at either of the 3 input lines you 
  63.        may hit ESC and the program will terminate.
  64.  
  65.  
  66.  
  67.        Option 2:
  68.        ---------
  69.        At the DOS prompt type FORMS [drive:][path]filename.ext[,(Y or  N)] 
  70.        and  hit enter.  No other user intervention is required.   The  de-
  71.        fault output file name will be used and the answer to the  straight 
  72.        ASCII question will be answered.  If you don't supply the answer to 
  73.        the  ASCII question the program will ask only that  question.   You 
  74.        must  use  the comma (,) between the filename and the Y or  N.   In 
  75.        this  manner  you may set up a batch file with all  the  forms   or 
  76.        reports you want converted.
  77.  
  78.        Example:  TEST.BAT
  79.  
  80.         FORMS EXAMPLE.F1,Y
  81.         FORMS EXAMPLE.F2,N
  82.         FORMS EXAMPLE.F3,Y
  83.         .
  84.         .
  85.         .
  86.        
  87.        In this way you can process all your screen forms without inputting  
  88.        each individually.  Likewise you may create a similar batch file to 
  89.        process the report designs as well.  The format is identical except 
  90.        proceed  each filename with the program name REPORTS.  The  2  pro-
  91.        grams can be run from the same batch file.
  92.  
  93.  
  94.        PRINTING
  95.        --------
  96.        The text files produced by FORMS.EXE and REPORTS.EXE can be printed 
  97.        on most dot matrix printer or other graphics capable printer.   You 
  98.        may  have  to send special code to the printer in  order  to  print 
  99.        ASCII characters in the range 128-255 if you use them in your forms 
  100.        for borders and such.  As an example for the Epson FX286e the codes 
  101.        ESCt1  (chr$(27)+"t1")  will select the  Epson  character  graphics  
  102.        table.  This will not effect normal characters (ASCII character  1-
  103.        127)  but will print the upper characters as they appear.  You  may 
  104.        also  need  to  edit the text files using  any  ASCII  text  editor 
  105.        (Wordstar in non- document mode) to insert page breaks were you may 
  106.        want then so that large screen files aren't split were they should-
  107.        n't be.  If you don't have a wide carriage printer (and how many of 
  108.        us  do) you may need to reformat some of the calculated  field  de-
  109.        scription lines to print on 80 column paper or print in  compressed 
  110.        mode or both.  This program only extracts the form and puts it into 
  111.        a form that can be edited or just printed as is.
  112.  
  113.        The output text files from the FORMS program contains the  designed 
  114.        screen form as it appears in PARADOX form generator plus:
  115.  
  116.           Form Title
  117.           What line the field appears
  118.           Where the field starts
  119.           Where the field ends
  120.           What form page the field appears on
  121.           What field number (from associated table structure)
  122.  
  123.        The  fields  are  also subdivided into REGULAR,  DISPLAY  ONLY  and 
  124.        CALCULATED  fields.  With CALCULATED field the calculation used  is 
  125.        also displayed.
  126.  
  127.        The  output  text files from the REPORTS program contains  the  de-
  128.        signed report as it appears in the PARADOX report generator plus:
  129.  
  130.           Report Title
  131.           Printer Port
  132.           Right Margin
  133.           Number of Fields used
  134.           Page Length
  135.           Left Margin
  136.           Setup String
  137.           Number of Page Widths
  138.           Field type (Regular, Current Date, etc)
  139.           Summary type (for summary fields)
  140.           Summary Group (for summary fields)
  141.           Start Position
  142.           Line Number defined on
  143.           Display length
  144.           Calculation (for calculated regular and summary fields)
  145.  
  146.        With this information anyone should be able to recreate any  screen 
  147.        form or report design for a damaged or deleted forms or report.
  148.  
  149.  
  150.  
  151.        DISK CONTENTS
  152.        -------------
  153.  
  154.         The files contained on this disk are:
  155.         FORMS.EXE             The forms program
  156.         REPORTS.EXE           The reports program
  157.         FRM-RPT.DOC           This documentation file
  158.         OT.DB                 Sample Tables and Forms or Reports
  159.         OT.F1                   "      "     "   "    "     "
  160.         OT-TEMP.DB              "      "     "   "    "     "
  161.         OT-TEMP.R1              "      "     "   "    "     "
  162.         REVIEW.DB               "      "     "   "    "     "
  163.         REVIEW.F2               "      "     "   "    "     "
  164.         REVIEW.F10              "      "     "   "    "     "
  165.         REVIEW.F6               "      "     "   "    "     "
  166.         REVIEW.R1               "      "     "   "    "     "
  167.         REVIEW.R10              "      "     "   "    "     "
  168.         REVIEW.R11              "      "     "   "    "     "
  169.  
  170.        Questions, comments or inquiries should be directed to the  address 
  171.        on the last page.
  172.  
  173.        Improvements  to  come:  Support for Paradox v 3.0 (as  soon  as  I 
  174.        purchase a copy)
  175.  
  176.  
  177.        Copyright/License/Warranty
  178.        --------------------------
  179.  
  180.        This  document and the program file FORMS.EXE ("the software")  are 
  181.        copyrighted by the author.  The copyright owner hereby licenses you 
  182.        to: use the software; make as many copies of the program and  docu-
  183.        mentation  as you wish; give such copies to anyone; and  distribute 
  184.        the  software and documentation via electronic means.  There is  no 
  185.        charge for any of the above.
  186.  
  187.        However, you are specifically prohibited from charging, or request-
  188.        ing donations, for any such copies, however made; and from distrib-
  189.        uting  the software and/or documentation with  commercial  products 
  190.        without prior permission.
  191.  
  192.        NO  FOR-PROFIT ORGANIZATION IS AUTHORIZED TO CHARGE ANY AMOUNT  FOR 
  193.        DISTRIBUTION  OF  COPIES OF THE SOFTWARE OR  DOCUMENTATION,  OR  TO 
  194.        INCLUDE COPIES OF THE SOFTWARE OR DOCUMENTATION WITH SALES OF THEIR 
  195.        OWN PRODUCTS.
  196.  
  197.        THIS  INCLUDES A SPECIFIC PROHIBITION AGAINST FOR-PROFIT  ORGANIZA-
  198.        TIONS  DISTRIBUTING THE SOFTWARE, EITHER ALONE OR WITH OTHER  SOFT-
  199.        WARE,  AND  CHARGING A "HANDLING" OR "MATERIALS" FEE OR  ANY  OTHER 
  200.        SUCH  FEE  FOR  THE DISTRIBUTION.  NO  FOR-PROFIT  ORGANIZATION  IS 
  201.        AUTHORIZED TO INCLUDE THE SOFTWARE ON ANY MEDIA FOR WHICH MONEY  IS 
  202.        CHARGED.  PERIOD.
  203.  
  204.        There  is no restriction on the use of this software in  commercial 
  205.        or institutional environments.
  206.  
  207.        No  copy of the software may be distributed or given  away  without 
  208.        this document; and this notice must not be removed.
  209.  
  210.        There  is no warranty of any kind, and the copyright owner  is  not 
  211.        liable  for damages of any kind.  By using this free software,  you 
  212.        agree to this.
  213.  
  214.        The software and documentation are:
  215.  
  216.                               Copyright (C) 1989 by
  217.                                    Russ Walter           
  218.                                   RW Enterprises
  219.                                  1175 Hunter Dr.
  220.                                  Elgin, IL  60120
  221.  
  222.