home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1993 #2 / Image.iso / database / dbx131.zip / README.DOC < prev    next >
Text File  |  1993-06-24  |  15KB  |  316 lines
  1. dbMAX(tm) Version 1.31
  2. Copyright (c) 1991-1993 David A. Kennedy.
  3. All rights reserved.
  4.  
  5.  
  6. INTRODUCTION
  7. ============
  8.  
  9. dbMAX is an xBASE utility that will allow complete multi-user access to
  10. any xBASE databases and indexes.  The program uses a CUA-type menu system
  11. with Brief(R)-style hot keys and can browse databases in up to 250 moveable,
  12. sizable windows.  Almost every Clipper(R)/dBASE(R) command is available,
  13. allowing dbMAX to replace the dBASE Assist/Control Center or Computer
  14. Associates' DBU utility.  dbMAX also has a partially open architecture,
  15. allowing programmers to create their own menus and operate on dbMAX
  16. internal data structures.
  17.  
  18.  
  19. COMPILE and LINK
  20. ================
  21.  
  22. To compile and link dbMAX you will need Clipper 5.01 or Clipper 5.2.
  23. Batch files (CL50.BAT for Clipper 5.0x and CL52.BAT for Clipper 5.2) are
  24. provided to you to automate this task.  Linking can be performed with
  25. .RTLink, Blinker, or any other dynamic overlay linker.  .RTLink and Blinker
  26. link scripts are provided.  The CL??.BAT files and the .LNK files are set
  27. up assuming you have no other third-party linker or libraries, so you may
  28. want to edit these files.
  29.  
  30. The Clipper 5.0 .OBJs included on this disk support only the DBFNTX driver.
  31. The Clipper 5.2 .OBJs disk support only the DBFNTX, DBFNDX, DBFCDX, and
  32. DBFMDX drivers.
  33.  
  34. See the SHAREWARE section below for information on obtaining the source
  35. code.
  36.  
  37.  
  38. THIRD-PARTY LIBRARIES
  39. =====================
  40.  
  41. A third-party library, either DBMAX50.LIB for Clipper 5.0x users or
  42. DBMAX52.LIB for Clipper 5.2x users, is used by dbMAX.  This library is a
  43. collection of public domain assembly, C, and Clipper routines that can be
  44. used in lieu of other third-party libraries.  The functions in this library
  45. are NOT critical to the operation of the program and can be removed and/or
  46. worked around.  See FIXUP.PRG for details.
  47.  
  48. If you want to use your own libraries, FIXUP.PRG contains all the third-
  49. party functions called by dbMAX re-written using Clipper code, so that none
  50. of the original source code needs to be modified.  Simply remove or modify
  51. the functions in FIXUP.PRG as required for your own libraries and link it
  52. in.  If you do use the FIXUP code, make sure that the dbMAX .LIB is the
  53. last 3rd-party library in your link file.  This allows your routines to be
  54. linked into the .EXE instead of those in the dbMAX .LIB.
  55.  
  56.  
  57. RUNNING dbMAX
  58. =============
  59.  
  60. The only file you need to run the program is DBX.EXE.  All other files are
  61. optional.  A missing DBX.INI file will cause a warning message to appear.
  62. Select Options|Save to make this warning go away.
  63.  
  64. To run dbMAX, type DBX at the DOS prompt.  DBX /? will list all the command
  65. line parameters that can be used.
  66.  
  67.      Syntax:    DBX [database] [index] [switches]
  68.  
  69.      where:     database = name of database, extension not required
  70.                 index    = name of index, extension not required
  71.  
  72.      Switches:  /C<n>    = columns to display      (default=80)
  73.                 /D<name> = database driver name    (default=DBFNTX)
  74.                 /R<n>    = rows to display         (default=25)
  75.                 /S       = single-user             (default=multi-user)
  76.                 /T       = temporary files drive   (default=current)
  77.                 /U<file> = use specified .INI file (default=DBX.INI)
  78.                 /V<file> = use specified .ENV file (default=DBX.ENV)
  79.                 /?       = help screen
  80.  
  81. The parameters can appear in any order, except that the database name must
  82. appear before the index name.  Please note that the following additional
  83. parameters can be specified as long at they appear BEFORE any others:
  84.  
  85.      //E:<nExpanded>     = amount of EMS to use (in KB, default=ALL)
  86.      //F:<nHandles>      = number of file handles to use (default=50)
  87.      //X:<nKbytes>       = amount of conventional RAM to exclude
  88.      //CGACURS           = fixes possible cursor problems (default=ON)
  89.      //SWAPK:<nBytes>    = maximum swap file size
  90.      //SWAPPATH:'<path>' = path where VMM swap files are placed
  91.      //TEMPPATH:'<path>' = path where temp index/sort files are placed.
  92.  
  93.  
  94. NETWORKS
  95. ========
  96.  
  97. When running dbMAX in a network environment, BE SURE to set the temporary
  98. files drive to a LOCAL DRIVE or your personal drive/directory!  The temporary
  99. files drive is not the same as the one specified by //SWAPPATH and //TEMPPATH
  100. above.  Having these three parameters point to a RAM disk will provide the
  101. best performance.
  102.  
  103. Installing dbMAX on a network is not recommended since other users can
  104. overwrite your initialization and environment files.  This can be worked
  105. around by running dbMAX from a batch file as follows:
  106.  
  107.      DBX /U<userdrive:\DBX.INI> /V<userdrive:\DBX.ENV> /TC:\ %1 %2 %3 %4 %5
  108.  
  109.  
  110. TIPS & TRICKS
  111. =============
  112.  
  113. - When entering expressions into dbMAX that contain references to a related
  114.   database, you MUST use the work area number instead of the alias name.  The
  115.   area number is displayed after the file name on the help line.
  116.  
  117. - Since dbMAX does not use report form (.FRM) files, users who want to print
  118.   a "canned" report can use the Window|Heading (F3), Window|Column, and
  119.   environment functions to set up a dbMAX session and then save it to an
  120.   environment file (.ENV).  The file can be reloaded (Ctrl-F10) and the
  121.   database printed when required.  Grouping is not possible.  Subtotals will
  122.   be calculated for all numeric columns automatically; to prevent totals,
  123.   convert the column to a character type by using Window|Heading and the
  124.   STR() function.
  125.  
  126. - Opening database files in exclusive mode on networks will noticeably
  127.   improve performance when browsing, indexing, filtering, etc.  F4 toggles
  128.   the open mode.
  129.  
  130. - The About option (on the Help menu) will indicate the amount of RAM
  131.   available to dbMAX on the help bar.
  132.  
  133. - To run dbMAX under Windows(tm), add a DBX.PIF file that runs dbMAX using
  134.   the following recommended parameters:
  135.  
  136.      Program Filename:     dbx.exe
  137.      Optional Parameters:  /r25 /uc:\dbmax\windows.ini
  138.      Video Memory:         Text
  139.      Memory Requirements:  KB Required: 640   KB Desired: -1
  140.      EMS Memory:           KB Required: 256   KB Limit:   -1
  141.      XMS Memory:           KB Required: 256   KB Limit:   256
  142.      Display Usage:        Windowed
  143.      Execution:            Background
  144.      Close Window on Exit
  145.  
  146.   If you want, set the Multitasking Foreground Priority to 1000+.  A dbMAX
  147.   icon, DBMAX.ICO, is supplied for use with Windows.
  148.  
  149.   If using Blinker 2.00 or earlier make sure you set BLINKER OVERLAY
  150.   PAGEFRAME OFF and BLINKER CACHE EMS 0,100%.  Alternatively, the Program
  151.   Filename in the dbMAX .PIF should be changed to reference the following
  152.   batch file:
  153.  
  154.      @echo off
  155.      set blinker=/op0 /ce0,100
  156.      dbx %1 %2 %3 %4 %5 %6 %7 %8 %9
  157.      set blinker=
  158.  
  159.  
  160. KNOWN PROBLEMS
  161. ==============
  162.  
  163. The software is intended to be used by knowledgable xBASE users/programmers
  164. and as a result error handling has been minimized to reduce the size of the
  165. .EXE file and speed up the program.
  166.  
  167. 1)  Use of BOTH dBASE(R) and any Clipper(R)-based program such as dbMAX
  168.     to edit databases can lead to corrupted files!  DO NOT use dBASE to
  169.     edit, append, or pack records.  dBASE places end-of-file markers at the
  170.     end of database files while Clipper does not:  this can lead to files
  171.     that will contain records that cannot be accessed.  Also, .NTX index
  172.     files and record-locking schemes are not compatible between the two
  173.     systems.  To be safe, do not use dBASE to change any database that is
  174.     used by dbMAX (or any other Clipper system).
  175.  
  176. 2)  Changing files in a network environment may cause other users to
  177.     experience problems.  For example, revising a database with an index
  178.     active while someone else is revising it without the index will cause
  179.     the index file to become corrupted and, as a result, may cause the
  180.     database to become corrupted also.  For best results when editing a
  181.     database on a network, each user must be sure to open all indexes
  182.     associated with that file before making any changes.
  183.  
  184. 3)  Entering an illegal filename or pathname will cause a run-time error.
  185.     Opening a corrupted database or index may cause a run-time error.
  186.  
  187. 4)  Browsing the same database in two windows can lead to problems if you
  188.     do something like ZAP the database in one window and then try to browse
  189.     the other (can only happen on local drives).
  190.  
  191. 5)  Entering invalid color settings may cause menu items to be invisible.
  192.     Quitting dbMAX and re-running the program may restore the original colors
  193.     if they were not saved; otherwise, you will have to delete the DBX.INI
  194.     file to restore the default settings.
  195.  
  196. 6)  Using DOS versions earlier than 3.30 may cause multi-user problems on
  197.     networks due to lack of support for COMMIT and is not supported.
  198.  
  199. 7)  Some users have reported that their PCs lock-up occasionally during
  200.     swapping (swaps occur when shelling to DOS and calling hyperhelp).  This
  201.     appears to be due to an EMS conflict between QEMM and Overlay().  Using
  202.     the BADEMS switch in the DBX.INI file will fix the problem; use of the
  203.     //X switch may also be required.
  204.  
  205. 8)  Environment (.ENV) files created with versions of dbMAX prior to 1.25
  206.     are not compatible with this version!
  207.  
  208. 9)  The Utils|Copy command will allow you to copy a database over another
  209.     open database.  This will definitely corrupt the target file.
  210.  
  211. 10) Attempting to use both DBFCDX and DBFSIX RDDs will cause your computer
  212.     to lock up.  If you have the option, use DBFSIX instead.  Also, unless
  213.     you are a registered user, use of SuccessWare's MachSIx library will
  214.     only improve the performance of the Filter command.  To link in the
  215.     library, follow the instructions provided with the software.  Versions
  216.     of DBFSIX before 1.1c cannot be used concurrently with the HiPer-SIx
  217.     driver.
  218.  
  219. 11) Several "bugs" in dbMAX have been found that are due to Clipper problems.
  220.     To resolve these problems, this author recommends using Clipper 5.01a.
  221.  
  222.     . The ACHOICE() command was revised in Clipper 5.2b and as a result the
  223.       hot-keys on all pulldown menus will not be highlighted properly.
  224.     . When using Clipper 5.2x and opening a file in a networked environment,
  225.       your machine may lock up or reboot.  This happens most frequently when
  226.       opening a database more than once.
  227.     . When opening a database with a large number of fields, you may receive
  228.       a "TBROWSE(0) Limit exceeded" error when dbMAX builds the browse
  229.       object.  Code to trap this error has been implemented in this version
  230.       of dbMAX.  However, when using Clipper 5.2x, opening certain databases
  231.       will lock up your machine when dbMAX builds the browse object.  This
  232.       only happens for certain databases, others (larger or smaller) may
  233.       work fine.  This problem does not occur under Clipper 5.0x.
  234.     . When using Clipper 5.01 and DBFSIX 1.1b, if you attempt to delete a
  235.       tag from a .CDX with the database opened in shared mode, you will get
  236.       an "exclusive required" error.  This error does not occur under
  237.       Clipper 5.2.  Upgrade to DBFSIX 1.1c to solve the problem or only
  238.       delete tags from .CDX files when the database is opened exclusive.
  239.  
  240.  
  241. ETC.
  242. ====
  243.  
  244. If you have any comments/suggestions/fixes for dbMAX, send them to me,
  245. Dave Kennedy, via CompuServe Mail (76300,2164) or regular mail ONLY
  246. (no phone calls, please!) and I'll gladly consider them.  Please keep in
  247. mind that the main goal for dbMAX is maximum performance with minimum
  248. bells/whistles/crap (I hope I've done this).
  249.  
  250.  
  251. "FREEWARE"/"SHAREWARE" LICENSE AGREEMENT
  252. ========================================
  253.  
  254. FREEWARE  - the dbMAX program is considered to be free, in that as long as
  255.             the distribution of the program is performed as detailed below,
  256.             no payments or other licensing agreements need to be made.
  257.  
  258.             If you would like to register your copy of dbMAX, send US$20
  259.             and in return I will send you a master diskette with a compiled
  260.             and linked .EXE (capable of accessing Clipper, dBASE III/IV, and
  261.             FoxPro indexes) and automated installation program, so that dbMAX
  262.             can be used by people without the Clipper compiler or even
  263.             knowledge of what a compiler is.  This disk also includes the
  264.             Clipper 5.01 and 5.2 .OBJs.  Also included is automatic
  265.             notification via CompuServe e-mail/postcard when the next
  266.             version of dbMAX is available.
  267.  
  268. SHAREWARE - By sending a check or money order for US$35, I will send you a
  269.             disk containing a linked .EXE (capable of accessing Clipper,
  270.             dBASE III/IV, and FoxPro indexes), the INSTALL.EXE file along
  271.             with the Builder source code, and the source code for dbMAX and
  272.             the hyperhelp text.  You will also receive notification via
  273.             e-mail or postcard when the next version of dbMAX is available.
  274.  
  275.             The source generally conforms to Computer Associates' coding
  276.             guidelines and is fully commented where necessary, exactly like
  277.             FIXUP.PRG and MYFUNC.PRG.  Recipients of the source are asked not
  278.             to distribute the code or modified executables to any other
  279.             person.
  280.  
  281. The order form is available by printing out ORDERFRM.DOC.
  282.  
  283.                                      * * *
  284.  
  285. This software is an original work by David A. Kennedy and is released into
  286. the public domain with restrictions.  The software, with the exception of
  287. the source code, can be USED, COPIED, and DISTRIBUTED on an UNLIMITED BASIS,
  288. as long as no fee is charged for its use, copying, or distribution.  All
  289. rights to the program worldwide are reserved by David A. Kennedy.
  290. Unauthorized duplication, distribution, modification, or decompilation of
  291. this software is expressly prohibited.
  292.  
  293. You are encouraged to copy and share dbMAX with others.  PLEASE distribute
  294. all the files in the original .ZIP.  This is this a REQUIREMENT for
  295. distribution as SHAREWARE.
  296.  
  297. THE SOFTWARE AND ACCOMPANYING DOCUMENTATION ARE PROVIDED "AS IS" WITHOUT
  298. WARRANTY OF ANY KIND.  THE ENTIRE RISK TO THE RESULTS AND PERFORMANCE OF THE
  299. SOFTWARE IS ASSUMED BY YOU.
  300.  
  301. David A. Kennedy will not be liable for any special, incidental,
  302. consequential, indirect or similar damages due to the loss of data, loss of
  303. business profits, business interruption or any other reason, even if David
  304. A. Kennedy has been advised of the possibility of such damages.
  305.  
  306. This is a legal agreement between you, the end user, and David A. Kennedy.
  307. By using or distributing this package, you are agreeing to be bound by the
  308. terms of this Agreement.  If you do not agree to the terms of this agreement
  309. promptly destroy (erase) all copies of the software.
  310.  
  311. The Help! Engine (HELP.EXE) is property of Flambeaux Software, Inc. and
  312. specifically IS NOT placed into the public domain.  All rights worldwide are
  313. reserved by Flambeaux Software, Inc.  Modifications to the Help! Engine are
  314. prohibited.
  315.  
  316.