home *** CD-ROM | disk | FTP | other *** search
/ Zodiac Super OZ / MEDIADEPOT.ISO / FILES / 13 / DEG.ZIP / DEG.DOC < prev    next >
Text File  |  1996-07-04  |  10KB  |  261 lines
  1.  
  2.  
  3.  
  4.  
  5.                                     DEG.EXE
  6.  
  7.                     A Fixed Format Data Entry Editing tool
  8.  
  9.  
  10.  
  11.                                       by
  12.  
  13.                                 Daniel Bingamon
  14.  
  15.  
  16.                                Kadima Technology
  17.  
  18.                             1573 King Ave. BOX 238
  19.  
  20.                           Kings Mills, OH 45034-0238
  21.  
  22.  
  23.  
  24.  
  25.  
  26.         1.0   Introduction.
  27.  
  28.         2.0   SCN.EXE  - Creating format screen.
  29.  
  30.         3.0   Calling DEG from external programs.  The command line 
  31.               options.
  32.  
  33.         4.0   Position '.POS' files.
  34.  
  35.         5.0   Graphics configuration '.CFG' files.
  36.  
  37.         6.0   Credits, Registration, etc.
  38.  
  39.  
  40.  
  41.         1.0  Introduction
  42.  
  43.         DEG is designed for creating fixed database records up to 
  44.         1000 characters wide.  The only limitations are the screen 
  45.         area and the amount of prompts used.
  46.         DEG can be called by external programs using SPAWN like 
  47.         funtions through 'C' of other languages.  It supports Mouse 
  48.         clicks to move from record to record or function keys.
  49.         PCX display only is provided for pictorial attachments to
  50.         files.  This is limited to one PCX file per record.
  51.  
  52.         DEG operates in EGA mode 16.
  53.  
  54.         The way in which screens are designed is simple.  Run the 
  55.         SCN.EXE program,  type the screen out and put in the prompts 
  56.         and fields, then save.
  57.  
  58.         DEG is great for business record storage, requires little 
  59.         training.  Good for personal lists.
  60.  
  61.         Fixed record formats are IMPORTABLE to almost any database 
  62.         program in existance.
  63.  
  64.         2.0  SCN.EXE
  65.  
  66.         SCN is used for creating the format of the data entry 
  67.         screens.  Usage is simple.
  68.  
  69.         Make sure that your computer has a CONFIG.SYS line saying:
  70.  
  71.           DEVICE=C:\DOS\ANSI.SYS
  72.  
  73.           Note: DEG does not require ANSI.SYS  - it only used by scn.exe.
  74.  
  75.           1.  Run SCN by typing:
  76.  
  77.                 SCN   -  Press ENTER
  78.  
  79.           2.  Enter Filename.  Any name you wish, however, it must 
  80.               end with '*.SCN'.  Don't include the quotes.
  81.  
  82.  
  83.           3.  Type in titles and Prompts any where you please.
  84.  
  85.                 Now, Wherever data field belongs, use the following.
  86.  
  87.                 @@@@@@ The AT signs are for alphabetic and numeric 
  88.                        data.  If there are 25 character, enter 25 of 
  89.                        the AT '@' signs.
  90.  
  91.                 ###### The NUMBER signs are for numeric entry, this 
  92.                        allows the entry of numbers, periods, spaces 
  93.                        and plus/minus signs.
  94.  
  95.                 |||||| The PIPE signs are for the entry of a PCX file 
  96.                        name, this should be 12 characters in a file 
  97.                        name so be sure to have 12 of these together.
  98.  
  99.                 @!!!!! The EXCLAMATION signs are protected data 
  100.                        entry fields, the first character sets the 
  101.                        type and the exclamation point in the second 
  102.                        position and beyond prevents this field from 
  103.                        being edited.  Untouchable.
  104.  
  105.                 @~~~~~ The DUPLICATE sign is for carrying on data 
  106.                        from a previous record in this field.
  107.                        This will only carry when adding a new record 
  108.                        on at the end of the file and will not modify 
  109.                        at any other time.
  110.  
  111.                 &1     This is a category sign.  If &1 is used, the 
  112.                        first item in the category file is displayed 
  113.                        on the screen.  &2 shows the second.  There 
  114.                        are a maximum of 10 categories loaded from a 
  115.                        file with an extension of '.CAT'.  Thus allowing
  116.                        programmable categories without modifying the SCN
  117.                        file each time.
  118.  
  119.           4.  When finished Press the escape key and change or keep 
  120.               the filename and press ENTER.
  121.  
  122.               Note that the record length is displayed, this 
  123.               includes the Carriage Return and line feed.
  124.               Write this down.  If it does not meet your 
  125.               expectations, re-enter SCN and check your field 
  126.               lengths.
  127.         
  128.  
  129.           5.  It's done.  The .SCN file is created, an ASCII file, it will 
  130.           look like this:
  131.  
  132.               P4
  133.               6
  134.               0
  135.               NAME:
  136.               P10
  137.               6
  138.               0
  139.               @@@@@@@@@@@@@@@@@@@@@@@
  140.  
  141.  
  142.         The P30 indicates that the word NAME shows up in col 4, the 
  143.         next number is the row which is 6.  The zero is useless 
  144.         here, it serves as a placeholder in the file.  The zero 
  145.         however is used to indicate before the string of '@' signs, 
  146.         that these will be place starting in col. 0 in the files 
  147.         record.  The 23 at '@' signs make the field 23 characters 
  148.         wide.
  149.  
  150.  
  151.         3.0  Calling DEG from external programs.
  152.  
  153.         The command line format is:
  154.  
  155.         Simple:
  156.         
  157.           DEG filename      - no extension.
  158.  
  159.                 example:  DEG TEST
  160.         
  161.         
  162.               This assumes that the filename is TEST.DAT and the 
  163.               format file is TEST.SCN.
  164.  
  165.           DEG filename screenname [categoryname]
  166.  
  167.                 example:  DEG TEST SCRN
  168.  
  169.               This assumes that the filename is TEST.DAT and the
  170.               format file is SCRN.SCN.
  171.  
  172.               If the Category name is not given and the screen name 
  173.               is, the name would be based in the screen name or in 
  174.               this case 'SCRN.CAT'.   If the screen name is missing, 
  175.               the data filename will be used.
  176.  
  177.               The Category name is a file of up to ten categories.
  178.               This is useful for fields which change meaning or 
  179.               using screen files that look closely alike.  Another 
  180.               application is changing a company name in a package 
  181.               software system without customizing every screen.
  182.  
  183.         4.0   Position POS Files
  184.  
  185.               The purpose of POS files are to show change in a 
  186.               record made by users.  If the file is changed, the DEG 
  187.               program will place a '1' in the position of that record 
  188.               given in the POS file.
  189.               This is a number representing offset to the 
  190.               beginning of the record.  Zero is the first position.  
  191.               Make sure that this does not exceed the length of the 
  192.               actual record.  
  193.         
  194.               The TEST.POS file on this disk contains the number 45 
  195.               as an example.  It is advised that you change the 
  196.               number when your program process the change made by 
  197.               the operator to something other than a '1'.
  198.  
  199.  
  200.               The POS files are geared on the filename.  If the 
  201.               above example were used, the computer would use:  
  202.               TEST.POS.
  203.  
  204.         5.0   Graphics Configuration CFG Files
  205.  
  206.               The purpose of CFG files load the X-offset, Y-offset, 
  207.               Width and Depth of the PCX file of the display.  These 
  208.               coordinates are based on the top left corner of the 
  209.               screen, 640 pixels wide and 480 pixels deep.
  210.  
  211.         6.0   Credits, Registration, etc.
  212.  
  213.                                    CREDITS
  214.  
  215.               This program is coded in the ANSI-C language using the 
  216.               POWER-C compiler by MIX software and uses the 
  217.               C/Windows Toolchest for DOS also by MIX software.
  218.               Originally written about 6 years ago on Commodore 
  219.               Computers in Basic and then the concept rewritten in 
  220.               the C language using ANSI graphics.  The C/Windows 
  221.               Toolchest was later added for mouse support and 
  222.               graphics mode for appearance improvment.
  223.  
  224.               To modify this source code, you will need the C/Windows 
  225.               Toolchest for DOS by Mix Software.  I cannot legally include 
  226.               their library file.  Once linked into the software, the final 
  227.               .EXE file is distributable royalty free but before that, Mix 
  228.               retains their rights.  Mix software is in Richardson, TX.
  229.  
  230.  
  231.               A special version of this software is currently in use at
  232.               a few hospitals. 
  233.  
  234.                                  DISCLAIMER
  235.         
  236.               The creator of this software has provided it and this 
  237.               documentation on an as-is basis and makes no 
  238.               warranties whatsoever although every effort has been 
  239.               made to insure that this information given and 
  240.               software is accurate.  Daniel Bingamon or Kadima 
  241.               Technology can not be help responsible for any damages 
  242.               suffered from the use of this product.
  243.               This disclaimer also applies to the maker of the 
  244.               compiler and the Graphics Software library inclusions.
  245.  
  246.  
  247.               New features are continually being added, eventually, 
  248.               multi-screen entry, Windows Version, etc.
  249.               If you like this software, please consider sending $10.
  250.               It will go to the expense of buying addition equipment for the 
  251.               development of additional utilities.
  252.  
  253.                 Make checks payable to:  Daniel Bingamon
  254.  
  255.                 Address to:              Kadima Technology
  256.                                          1573 King Ave. BOX 238
  257.                                          Kings Mills, OH 45034-0238
  258.  
  259.  
  260.  
  261.