home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / database / dbs113.zip / DBS.DOC next >
Text File  |  1988-11-01  |  12KB  |  223 lines
  1.  
  2.                             The dBStructure Utility
  3.  
  4.                       A dBase Directory/Structure Utility
  5.                         Copyright (c) David Jaquay 1988
  6.                                911 Deedra Avenue
  7.                             Pensacola, FL 32514-1519
  8.                                  (904) 477-1317
  9.  
  10.           The  dBStructure Utility was written by David Jaquay for the
  11.           IBM PC using DOS 2.x or later.  It has been  made  available
  12.           for personal, private use.  You may freely  distribute  this
  13.           software with the following restrictions:
  14.  
  15.               a)  The  program  shall  be  distributed  ONLY  in   the
  16.                   ORIGINAL    unmodified    form,    including    this
  17.                   documentation.
  18.  
  19.               b)  NO FEE may be charged.
  20.  
  21.               c)  FOR-PROFIT use without a License is PROHIBITED.
  22.  
  23.               d)  The  program  may  NOT  be  INCLUDED  or  BUNDLED or
  24.                   otherwise  sold  with  with  other goods or services.
  25.                   Exceptions may be granted ONLY upon written request.
  26.  
  27.               e)  Commercial  users  MUST  register.  Site  License is
  28.                   available, call.
  29.  
  30.           This is USER SUPPORTED SOFTWARE.  If you use it, and find it
  31.           of value,  please  register  your  copy  by  sending  $20.00
  32.           ($35.00  Commercial)  along with the filled out registration
  33.           form,  to the author  at  the  above  address.  Make  checks
  34.           payable to David Jaquay.  Registration applies to all future
  35.           versions.
  36.  
  37.           I  would  like  to thank Mark Starkweather and Gregory Besch
  38.           their suggestions, and their assistance in beta testing.
  39.  
  40.           DBS - Page 2
  41.  
  42.           DBS with no arguments will show a directory of the  database
  43.           files in the current directory with a DBF  extension.   This
  44.           directory closely resembles the directory you  receive  when
  45.           you execute a DIR or LIST FILES  command  in  dBASE  III  or
  46.           dBASE III+.  This listing includes the name of the file, the
  47.           number of records in the file, the date of last  update  and
  48.           the size of the file.  When you provide  a  filename  as  an
  49.           argument, the structure of that file will be displayed as if
  50.           you executed a DISPLAY STRUCTURE or LIST STRUCTURE in  dBASE
  51.           III/III+.  If the file extension is omitted, it will default
  52.           to ".DBF".
  53.  
  54.           Arguments may also be used on the command line.   These  may
  55.           be preceded with a "/" or a "-".  If  filenames  are  given,
  56.           and a "-D" is included, the filenames will be  displayed  in
  57.           directory form, rather than structure form.
  58.  
  59.           The "-F" parameter, when followed by either "C",  "N",  "D",
  60.           "L", or "M", only those fields with data  types  represented
  61.           by these characters  will  be  displayed  in  the  structure
  62.           listing.  (If the "-D" option is provided, the  "-F"  option
  63.           will be ignored.)
  64.  
  65.           The "-H" parameter will display a help screen,  listing  the
  66.           following text:
  67.  
  68. Syntax:
  69.  
  70.   DBS [-D][-F[CNDLM]][-H] [filespec1 [filespec2 [...]]]
  71.  
  72.       -D : prints directory using filespec, rather than structure.
  73.       -F{[CNDLM]} : specifies which field types to include when printing
  74.                     structures.  Valid types are [C]haracter, [N]umeric,
  75.                     [D]ate, [L]ogical and [M]emo, and may be given in any
  76.                     order or combination.
  77.       -H : displays syntax (this display).
  78.  
  79.   If no extension is given, it defaults to .DBF
  80.  
  81.  
  82.        Version  Date      Changes
  83.        -------  ----      -------
  84.        1.00     08/21/87  Initial Release.  Prints structure of specified
  85.                            dBASE III/III+ file to stdout.  If filename is not
  86.                            specified, the program name, author and version
  87.                            number are displayed, syntax is given, and control
  88.                            is returned to the calling program, (usually
  89.                            COMMAND.COM).
  90.        1.01     08/27/87  Bug Fix.  Added Unsigned Char type cast to the
  91.                            calculations for reccount in read_struct() to
  92.                            access the byte value.
  93.                           Enhancement.  If .DBF extension is not included,
  94.                            program adds it automatically.
  95.        1.02     09/08/87  Bug Fix.  DOS redirection caused parts of the
  96.                            output to be placed in odd parts of the file.  The
  97.                            cause of this was using putch(), (which outputs to
  98.                            the console), rather than putchar(), (which outputs
  99.                            to stdout).
  100.                           Bug Fix.  Now handles record counts in excess of 32k.
  101.        1.03     09/14/87  Enhancement.  When user omits filename on command
  102.                            line, dBS prints dBASEIII-like directory instead
  103.                            of error message.  User must still enter correct
  104.                            filename if any parameter is given on the command
  105.                            line.
  106.        1.04     09/23/87  Enhancement.  Accepts more than one filename as a
  107.                            parameter from the command line. Each parameter is
  108.                            treated as a separate execution of the program.
  109.                           Enhancement.  Accepts wildcards, as long as they
  110.                            are not in the path, ie. \DBASE\*.DBF is accepted,
  111.                            but \DBASE\*\*.DBF is not.  (This is mentioned in
  112.                            hopes that it will be a future enhancement.  Not
  113.                            Real Soon Now, but long term.)
  114.        1.05     10/16/87  Bug Fix.  Corrected problems concerning searching
  115.                            for and opening files along a user-specified
  116.                            path.  Problem was related to the fact that the
  117.                            path supplied to findfirst() was not returned
  118.                            in the structure and therefore must be added to
  119.                            the name in c_file.name before calling open().
  120.                 10/24/87  Bug Fix.  Corrected problem printing filelengths
  121.                            in excess of 64k.  Involved using %ld format in
  122.                            printf(), rather than %d.
  123.                           Enhancement.  Expands all wildcards and sorts
  124.                            by filename first, then prints the structures
  125.                            specified.  "File Not Found" messages are thus
  126.                            printed at program startup, and not mixed in
  127.                            with the structures as they are being printed.
  128.        1.06     11/22/87  Enhancement.  Added -D option to allow user to
  129.                            supply filespecs on the command line, but list
  130.                            files in directory format rather than structure
  131.                            format.  Files will also be listed in alphabetical
  132.                            order, whether a filespec is specified or DBS
  133.                            is called without options.
  134.  
  135.                 11/24/87  Enhancement.  Added -F option to allow user to
  136.                            view only those data types desired.  Option is
  137.                            entered as -F{types} where {types} specifies
  138.                            in any order and either case the data types
  139.                            desired, from the allowable "CNDLM".  If no
  140.                            fields of the specified types are found, just
  141.                            the header will be displayed.
  142.                 12/11/87  Enhancement.  Checked first byte of file for
  143.                            validity of dBASE III file.  First byte must be
  144.                            0x03 or 0x83, (for w/o & with memo file, resp.)
  145.        1.07     01/30/88  Bug Fix.  Now opens files as binary under
  146.                            read_dir().  Problems were being caused while
  147.                            computing the record count with certain files.
  148.        1.08     02/05/88  Bug Fix.  Now can be used to access the current
  149.                            directory on other drives without entering full
  150.                            path to that dir, just by entering [d:]fname[.dbf]
  151.                            on command line.
  152.        1.09     02/09/88  Enhancement.  Program flow changed drastically to
  153.                            allow all structures to be read into memory before
  154.                            printing commences.  This will allow it to be drawn
  155.                            into a window and scrolled, (V2.00).
  156.        1.10     02/21/88  Bug Fix.  Corrected error involving executing DBS on
  157.                            a .DBF in the root directory with the root as a
  158.                            default.  DBS was attempting to open a file called
  159.                            d:\\filename.DBF, which was in error.
  160.        1.11     04/12/88  Bug Fix.  Corrected error caused by program change
  161.                            1.91.  DBS was attempting to open an invalid file:
  162.                            d:pathnamefilename.ext.  This was a reversal of the
  163.                            problem fixed in 1.91.  Program now works in both
  164.                            the root and subdirectories (we hope).
  165.                           Enhancement, (Kinda.)  Changed to Large model.
  166.        1.12     04/19/88  Enhancement.  Split DBS.C into DBS.C, DBSTREE.C and
  167.                            DBSPRINT.C, and trimmed inclusions accordingly.
  168.                           Enhancement.  Added more error checking to
  169.                            get_struct().  Out of memory errors are curently
  170.                            resulting in an error message and program ending.
  171.                            Future versions, presumably 2.00 and higher, will
  172.                            result in the structure not being read in but the
  173.                            program will be allowed to continue.
  174.                 05/01/88  Enhancement.  Included '/' as allowable option
  175.                            character, i.e., '-D' and '/D' function the same.
  176.                           Enhancement.  Added -H option to display syntax
  177.                            assistance.
  178.        1.13     10/14/88  Enhancement.  Conversion to MicroSoft C 5.1.
  179.  
  180.  
  181.                                 REGISTRATION FORM
  182.  
  183.                             The dBStructure Utility
  184.  
  185.                       A dBase Directory/Structure Utility
  186.                         Copyright (c) David Jaquay 1988
  187.                                911 Deedra Avenue
  188.                            Pensacola, FL  32514-1519
  189.                                  (904) 477-1317
  190.  
  191.                                   Version 1.13
  192.                                 November 1, 1988
  193.  
  194.  
  195.           USER NAME: ________________________________    DATE: ________
  196.  
  197.             ADDRESS: ________________________________
  198.  
  199.            CITY, ST: __________________________   ___    ZIP: _________
  200.  
  201.  
  202.           Check One:  [ ] For Personal Non-Profit Use Only ($20.00)
  203.  
  204.                       [ ] For Commercial USE License Only ($35.00).
  205.  
  206.  
  207.  
  208.                                 Signature: ____________________________
  209.  
  210.  
  211.           I ([ ] DO) / ([ ] DO NOT) wish to receive notices concerning
  212.           enhancements and bug fixes or announcements of other similar
  213.           programs.  Please include name and number of most  currently
  214.           visited Bulletin Board if you do wish to receive notices.
  215.  
  216.  
  217.           COMMENTS/SUGGESTIONS:  ______________________________________
  218.  
  219.           _____________________________________________________________
  220.  
  221.           _____________________________________________________________
  222.  
  223.