home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / CLIPPER / DATABASE / DBFSTR.ZIP / DISPSTRU.DOC < prev   
Encoding:
Text File  |  1993-05-21  |  2.6 KB  |  66 lines
  1.                            DISPSTRU.COM v1.1
  2.  
  3.   Author:           Dale Thorpe
  4.                     CIS ID: 76520,1400
  5.  
  6.   Date last update: 05/21/93
  7.   Syntax:
  8.          DISPSTRU <Database Name>
  9.          DISPSTRU <Database Name>,  [<pause after screen full>]
  10.          DISPSTRU <Database Name>,  [<write code to file>]
  11.  
  12. This utility will display a database structure from the DOS prompt.
  13. I have seen several utilities that do this before, but they usually
  14. didn't do exactly what I wanted.  So as an excercise with C, I wrote
  15. this program to do what I needed it to do.  I hope it can be of use to
  16. other people during their development cycle also.  It's free, Public
  17. Domain.
  18.  
  19. Options:
  20.  
  21. 1. Appending a " p" after the database name will cause the program to
  22.    pause after each screenfull of data is displayed.  You don't have
  23.    to depend on MORE being available.
  24.  
  25. 2. Appending a " v" after the database name will cause the program to
  26.    create a file named VARIABLE.TXT that contains the necessary code to
  27.    store the database fields to variables and to transfer the variable
  28.    information back to the database and to display and edit the fields.
  29.    If the VARIABLE.TXT file exists, an error will be displayed and no
  30.    processing will occur.
  31.  
  32.    Example:
  33.           // PROCESSING VARIABLES FOR: Tasks
  34.           // Store database information to variables
  35.           mprojnumb     := Tasks->projnumb
  36.           mprojkey      := Tasks->projkey
  37.           mtasknumb     := Tasks->tasknumb
  38.  
  39.           // Store variable information to database
  40.           Tasks->projnumb     :=  mprojnumb
  41.           Tasks->projkey      :=  mprojkey
  42.           Tasks->tasknumb     :=  mtasknumb
  43.  
  44.           // Display fields in database
  45.           @  0,1 SAY Tasks->projnumb
  46.           @  1,1 SAY Tasks->projkey
  47.           @  2,1 SAY Tasks->tasknumb
  48.  
  49.           // Get fields in database
  50.           @  0,1 GET Tasks->projnumb
  51.           @  1,1 GET Tasks->projkey
  52.           @  2,1 GET Tasks->tasknumb
  53.  
  54.    The variables, fields and ":=" are lined up in their own columns for
  55.    readability purposes.  The program will not calculate the width of the
  56.    longest field, instead it allows for maximum length fields.
  57.  
  58. 3. Only one option is allowed.  if options are mixed, all options are then
  59.    ignored.  The database structure will be displayed without pausing and
  60.    the file for variable processing will not be created.
  61.  
  62. This utility program was written in Borland Turbo C++ 3.0
  63.  
  64. This program is provided AS IS without any warranty, expressed or implied,
  65. including but not limited to fitness for a particular purpose.
  66.