home *** CD-ROM | disk | FTP | other *** search
/ ftp.barnyard.co.uk / 2015.02.ftp.barnyard.co.uk.tar / ftp.barnyard.co.uk / cpm / commercial-software / programming / TURBODBT.ZIP / READ.ME < prev    next >
Text File  |  1996-07-15  |  9KB  |  219 lines
  1.  
  2.              Welcome to TURBO DATABASE TOOLBOX Version 1.2
  3.              ---------------------------------------------
  4.  
  5.      If  you  need help with the TURBO DATABASE  TOOLBOX,  please
  6.      read this help file and the Reference Manual thoroughly. The
  7.      sample  programs included on this diskette are also  a  good
  8.      source of information about how to use the TOOLBOX.
  9.  
  10.      If  you still have a question and need technical assistance,
  11.      please  have the following information ready before  calling
  12.      our technical support department:
  13.  
  14.      1)  Product name and version number.  (The version number of
  15.          all TOOLBOX files can be found at the top of each  file.
  16.          The  version  number of TURBO PASCAL appears  above  the
  17.          "Include  error  messages?" prompt when the  program  is
  18.          first loaded.)
  19.      2)  Computer name, model and any additional hardware.
  20.      3)  Operating  system  and  version  number.   (The  version
  21.          number generally is displayed when your system is  first
  22.          booted.)
  23.  
  24.      Technical  assistance  is also available from the  following
  25.      sources:
  26.  
  27.      1)  Type GO BOR100 on the CompuServe bulletin board system.
  28.      2)  Check with your local software dealer or user group.
  29.      3)  Write to:  Borland International
  30.                     TURBO TOOLBOX Technical Support
  31.                     4585 Scotts Valley Drive
  32.                     Scotts Valley, CA  95066
  33.  
  34.  
  35. TURBO PASCAL 2.0 USERS
  36. ----------------------
  37.      We  are  currently  shipping version 3.0  of  TURBO  PASCAL.
  38.      The ACCESS.BOX file included on this diskette is intended to
  39.      be used only with TURBO PASCAL 3.0 or later.  All the sample
  40.      programs are set up for use by 3.0 users --  no installation
  41.      is required.
  42.  
  43.      If you are still using  TURBO  PASCAL  2.0,  please  run the
  44.      batch file  TURBO2.BAT.   To do this,  place a  COPY of your
  45.      original master diskette in drive A, type "TURBO2" and press
  46.      the <ENTER> key.
  47.  
  48.      Please note that the above applies to  16-bit  systems only.
  49.      CP/M-80 users do not require an updated ACCESS.BOX file  to
  50.      use with TURBO PASCAL 3.0 and only one  ACCESS.BOX file  is
  51.      included on this diskette.
  52.  
  53.                              -----------
  54.  
  55.                              CORRECTIONS
  56.                              -----------
  57.  
  58. P- 1, Version 2.0
  59. -----------------
  60.      This is a painful typographical error!   The current version
  61.      of the TURBO DATABASE TOOLBOX is Version 1.2.
  62.  
  63.  
  64. P- 12, ACCESS.BOX, ACCESS2.BOX, ACCESS3.BOX  (MS-DOS only)
  65. ----------------------------------------------------------
  66.      As explained above,  there are different ACCESS routines for
  67.      TURBO PASCAL Versions 2.0 and 3.0:
  68.  
  69.       - Use ACCESS.BOX with TURBO PASCAL 3.0.  The TURBO DATABASE
  70.         TOOLBOX is set up for 3.0 users -- no installation is re-
  71.         quired.
  72.  
  73.       - Run TURBO2.BAT if you use TURBO  PASCAL 2.0.   This batch
  74.         file completely installs the TURBO  DATABASE  TOOLBOX for
  75.         2.0 users.
  76.  
  77.      Please note: The above applies to 16-bit systems only.    No
  78.      special installation is required for  CP/M-80 TOOLBOX  users
  79.      and only one ACCESS.BOX file is included on the distribution
  80.      disk.
  81.  
  82.  
  83. P- 19, Error message numbers
  84. ----------------------------
  85.      The I/O error  numbers returned by IOresult when using TURBO
  86.      PASCAL  Version  2.0 are different than those listed in  the
  87.      TURBO PASCAL Reference Manual.  The following table converts
  88.      these error numbers to the I/O  listed in  the manual.   The
  89.      last error described by this table actually applies to TURBO
  90.      PASCAL 3.0 users ONLY.
  91.  
  92.  
  93.      IOresult#    Error message from TURBO PASCAL manual
  94.      ---------    --------------------------------------
  95.        1          90  Record length mismatch
  96.        2          01  File does not exist
  97.        3          F1  Directory is full
  98.        4          04  File not open
  99.        5          02  File not open for input
  100.        6          03  File not open for output
  101.        7          99  Unexpected end-of-file
  102.        8          F0  Disk write error
  103.        9          10  Error in numeric format
  104.       10          99  Unexpected end-of-file
  105.       11          F2  File size overflow
  106.       12          99  Unexpected end-of-file
  107.       13          F0  Disk write error
  108.       14          91  Seek beyond end-of-file
  109.       15          04  File not open
  110.       16          20  Operation not allowed on a logical device
  111.       17          21  Not allowed in direct mode
  112.       18          22  Assign to std files not allowed
  113.      144          90  Record length mismatch
  114.      145          91  Seek beyond end-of-file
  115.      153          99  Unexpected end-of-file
  116.      240          F0  Disk write error
  117.      243          F3  Too many files open (TURBO PASCAL 3.0 only)
  118.  
  119.  
  120. P- 22, Str[2]
  121. -------------
  122.      Str[2] should be String2 as it is defined  above.   The cor-
  123.      rect declaration for both functions on this page is:
  124.  
  125.        function IntToStr(N : integer) : String2;
  126.  
  127.        function StrToInt(S : String2) : integer;
  128.  
  129.  
  130.                              -----------
  131.  
  132.                                 NOTES
  133.                                 -----
  134.  
  135. The following comments and suggestions  are also  included in the
  136. manual.  They are listed here because they solve most of the prob-
  137. lems reported to our technical support department.
  138.  
  139.  
  140. SizeOf
  141. ------
  142.      Care  must be taken when specifying the size of  your  keys,
  143.      records  and  constants.   You should never count the  bytes
  144.      manually.  Instead, use the function SizeOf to determine the
  145.      actual size of your data structure and then type this  value
  146.      into your  TOOLBOX  program.   Please see  page 15  of  your
  147.      Owner's Handbook for more discussion.
  148.  
  149.  
  150. FindKey & SearchKey
  151. -------------------
  152.      Note  that  the  key  field of  the  FindKey  and  SearchKey
  153.      procedures  is a variable parameter.   Please see page 20 of
  154.      your Owner's Handbook for more discussion.
  155.  
  156.  
  157.                              -----------
  158.  
  159.  
  160.                   TURBO DATABASE TOOLBOX Version 1.2
  161.  
  162.                               File List
  163.  
  164.      The following files are included on your TOOLBOX disk:
  165.  
  166.           README   COM    - simple  program to  read the  READ.ME
  167.                             file
  168.  
  169.           Access Files
  170.           ------------
  171.           ACCESS   BOX    - contains main ACCESS routines for use
  172.                             with  TURBO  3.0  (2.0 or  later  for
  173.                             CP/M-80 users).
  174.           ADDKEY   BOX    - contains  routines  to  add  keys  to
  175.                             index files
  176.           GETKEY   BOX    - contains  routines  to retrieve  keys
  177.                             from index files
  178.           DELKEY   BOX    - contains routines to delete keys from
  179.                             index files
  180.           SETCONST PAS    - program to help you  find appropriate
  181.                             values for constants used by ACCESS
  182.           TBDEMO   PAS    - sample  database  program  for   your
  183.                             study and modification
  184.           BTREE    PAS    - sample  database  program  for   your
  185.                             study and modification
  186.           BTREE    INC    - sample   database   program   include
  187.                             module
  188.  
  189.           QuickSort Files
  190.           ---------------
  191.           SORT     BOX    - contains QuickSort routine
  192.           SORT1    PAS    - sample sorting program for your study
  193.                             and modification
  194.           SORT2    PAS    - sample sorting program for your study
  195.                             and modification
  196.           CUSTOMER DTA    - sample data for sorting program
  197.           STOCK    DTA    - sample data for sorting program
  198.  
  199.           General Installation Files
  200.           --------------------------
  201.           GINST    COM    - general installation program
  202.           GINST    COD    - general installation template
  203.           GINST    DTA    - general installation data file
  204.           GINST    MSG    - general installation message file
  205.           INSTALL  DOC    - documentation to  modify  and distri-
  206.                             bute with your programs.
  207.  
  208.           Miscellaneous Files
  209.           -------------------
  210.           READ     ME     - this file!
  211.       **  TURBO2   BAT    - install program for Turbo Pascal 2.0
  212.       **  ACCESS2  BOX    - contains main ACCESS routines for use
  213.                             with TURBO 2.0.   If  you  are  using
  214.                             TURBO  2.0, please run the TURBO2.BAT
  215.                             file described above.
  216.  
  217.       -----------------------------------------------------------
  218.       ** MS-DOS and PC-DOS only
  219.