home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1993 #2 / Image.iso / personal / gitarid.zip / GITDB.HLP < prev    next >
Text File  |  1993-04-24  |  7KB  |  188 lines
  1.  
  2.                  The Guitar Database
  3.  
  4.  
  5.   The guitar database will allow the user to enter 
  6.   relevant data about any guitar, then the data can
  7.   be retrieved at any time. Records can be inserted,
  8.   deleted, and edited. Once the record has been
  9.   selected, the user can show a picture tied to the
  10.   guitar data, find another record, browse the entire
  11.   database or quit the database. The database files 
  12.   are located in the AXE \ DB directory. The data
  13.   record has the following format:
  14.  
  15.     Manufacturer:
  16.     Model:
  17.     Year:
  18.     Top Value:
  19.     Mid Value:
  20.     Low Value:
  21.     Picture Path and Name:
  22.     Notes: (4 lines)
  23.  
  24.   As you may have surmised, the database will be
  25.   PARTIALLY filled with existing pictures but any
  26.   number of pictures and or guitar records can be
  27.   added. When you want to add or delete pictures to
  28.   view, simply edit the "Pic" field. This is the
  29.   user's database. It will be as good as the user
  30.   makes it by enhancing the data. Arren-San Software
  31.   will continue to upgrade all included databases and
  32.   make regular distributions available. The guitar
  33.   database currently has about 3000 entries. The
  34.   actual upper limit for any Guitar Data Manager
  35.   database is about one billion records.
  36.  
  37.   While in the existing database, you can request to
  38.   access another database, while closing the current
  39.   db. The commands can be accessed by moving the
  40.   arrow keys to the desired selection and pressing
  41.   <Enter>. To exit the database, simply choose Quit,
  42.   or enter q <Enter> and y for yes at the prompt.
  43.  
  44.   The database one person keeps can be read and used
  45.   by anyone using this db. Utilities also exist to
  46.   transform files into and out of *.dbf format 
  47.   (dBase files) ( See tools below). Finally, just
  48.   about any format picture file can be input and
  49.   viewed by GDS.
  50.  
  51.  
  52.   The actual database functions are as follows:
  53.  
  54.      Use database - the program brings you up in GIT
  55.      Use index    - default is manuf., model, year
  56.      Create database - for new databases
  57.      Create index - sort records in a different order
  58.      Head - first database record
  59.      Tail - last database record
  60.      Browse - search database forward - summary
  61.      Next - next record
  62.      Curr - current record
  63.      Prev - previous record
  64.      Find - search by sort criteria
  65.      Add - add a new record
  66.      Edit - change an existing record
  67.      Delete - delete an existing record
  68.      Show - displays the image in the PIC field.
  69.      Print - Print Inventory, Purchases or Sales.
  70.      Show field names
  71.      Show index names
  72.      Show index definition
  73.      Quit
  74.  
  75.  
  76.   The SHOW function has a limitation that must be
  77.   adhered to. For viewing images from within the
  78.   database, GDS will only allow approximately 10 
  79.   images per session. After 10 showings of any
  80.   combination of images, the viewer stops working.
  81.   Simply exit the database, re-enter the database,
  82.   FIND where you were previously and continue. The
  83.   database SHOW function is for limited quick
  84.   reference, not viewing the entire picture base. The
  85.   suggestion is to use GUITARS (and the LIB???
  86.   pictures) to take in the beauty of the pictures.
  87.   This is a viewer limitation and beyond the control
  88.   of Arren-San Software.
  89.  
  90.  
  91.   DATABASE TOOLS
  92.  
  93.   This set of procedures is applicable to any Guitar
  94.   Data Manager database.
  95.  
  96.   Any database needs basic maintenence procedures,
  97.   and Guitar Data Manager is no exception. Five
  98.   different tools are included, but cannot be invoked
  99.   from within the application. The usage of these
  100.   procedures will be so limited that direct access is
  101.   a waste of program memory. To use these tools,
  102.   simply go to the database directory, AXE \ DB and 
  103.   enter the tool desired.
  104.  
  105.  
  106.   These procedures, in order of relative importance,
  107.   and the necessary parameters are as follows:
  108.  
  109.  
  110.   DATABASE CLEAN-UP
  111.  
  112.   PRESSDB.EXE
  113.  
  114.   This tool will compress and rewrite ( clean up )
  115.   the database. This is usually only necessary when
  116.   heavy alterations have been made to a database. One
  117.   instance where this is not true is when the
  118.   database can only be accessed up to a certain
  119.   point, but more data definitely exists. At that
  120.   point, possibly a record has been corrupted or an
  121.   index pointer is set incorrectly. A good rule of
  122.   thumb is to run pressdb.exe after the addition or
  123.   deletion of about 500 records, when a database is
  124.   obviously not functioning properly, or when the
  125.   database is performing noticeably slower than it
  126.   has previously.
  127.  
  128.   To run pressdb.exe first go to the AXE \ DB
  129.   subdirectory. Simply type "pressdb db", where db is
  130.   the database desired. For example, "pressdb invent"
  131.   will rewrite the inventory database. If the user
  132.   simply types "pressdb", the program will prompt for
  133.   the database desired.
  134.  
  135.  
  136.   As with any utility, ALWAYS MAKE A BACKUP OF THE
  137.   FILE BEING MANIPULATED BEFORE MANIPULATING. For
  138.   sensitive databases, make floppy backups, as 
  139.   the data manager can always be restored; the user's
  140.   data, in the event of some disk malady, cannot.
  141.  
  142.  
  143.   DATABASE EXTRACT
  144.  
  145.   DUMPDATA.EXE
  146.  
  147.   Dumpdata will extract all data from the database
  148.   and display to the screen or redirect to a disk
  149.   file. This is a raw dump where all that comes out
  150.   is each database record, with fields listed in
  151.   database order, delimited by a "|". A dump of the
  152.   guitar database would look like this:
  153.  
  154.   Stk # | Manuf | Model | Year | Serial # | ..  etc.
  155.  
  156.   The dump will use any database and index requested.
  157.   The syntax is as follows:
  158.  
  159.   Dumpdata database index [>outfile].
  160.  
  161.   For example, if the user simply types "dumpdata"
  162.   the program will prompt for the database desired,
  163.   then the index desired ( the default is the
  164.   physical index, or how the data was entered ). At
  165.   this point data will spew out on the screen. If the
  166.   output is desired to be placed into a file, use the
  167.   outfile parameter. For example, "dumpdata git 
  168.   manumod >gitdb" would dump the guitar database
  169.   using the manumod index and create a file named
  170.   gitdb.
  171.  
  172.  
  173.   DATABASE CONVERSION
  174.  
  175.   DBTODBF.EXE
  176.   DBFTODB.EXE
  177.  
  178.   If the user currently uses dBase, or something
  179.   compatible, these utilities will convert data from
  180.   dBase to Guitar Data Manager (dbftodb) or vice 
  181.   versa (dbtodbf). Again, the syntax is "dbf
  182.   "dbtodbf". Both have extensive prompts due to the
  183.   information required ( file from, file to, how to
  184.   handle data, etc ).
  185.  
  186.   These functions are not included with the demo 
  187.   due to space constraints.
  188.