home *** CD-ROM | disk | FTP | other *** search
/ Boston 2 / boston-2.iso / DOS / PROGRAM / BASIC / VXBASE / README.TXT < prev    next >
Text File  |  1993-12-01  |  8KB  |  187 lines
  1. vxBase 1.05a  March 25, 1992
  2. ----------------------------
  3.  
  4. IMPORTANT NOTE TO EXISTING USERS:
  5.    Function vxDeallocate HAS CHANGED and will
  6.    require some programming changes on your part
  7.    to implement. See the notes on vxDeallocate below.
  8.  
  9.  
  10. This release features 8 new functions:
  11.  
  12.      vxDbfDate      extract the date of last access
  13.      vxInit         initialize multitask manager          
  14.                     This function MUST be called as the
  15.                     first reference to vxBase. SEE THE 
  16.                     NOTES below.
  17.  
  18.      vxIsRecLocked  query record lock status     
  19.      vxJoinNoAuto   Turn off automatic joins when browse
  20.                     window is initialized
  21.      vxReplLogical  replace logical fields using boolean values
  22.      vxSetLanguage  French, Spanish and German support added. All
  23.                     menus, dialog boxes, and error messages may be
  24.                     displayed in your choice of language.
  25.                     More languages coming!
  26.      vxTestNtx      Test the integrity of an index
  27.      vxUseDbfRO     Open a database with Read Only access
  28.  
  29.  
  30. Corrections and Changes:     
  31. ------------------------
  32.    (1) vxBrowsePos vertical size increased by 3 * frame width.
  33.    (2) QuickKey clear corrected if new browse window painted.
  34.    (3) Segment registers explicitly loaded in vxFile to stop
  35.        intermittent enhanced mode general protection fault.
  36.    (4) vxReplLong corrected if number was greater than 32767
  37.    (5) vxTop() and vxBof() corrected when used with filters.
  38.    (6) cleaner drawing of browse menus if modifications made.
  39.    (7) F3 accelerator key attached to Find Again item in Browse menu.
  40.        Instead of having to select the menu item to find another
  41.        instance of a search string, press F3.
  42.    (8) vxPack NOW PACKS MEMO FILES (and does it very well).
  43.    (9) vxCopy now copies with index ON and does not copy deleted
  44.        records. Memo files attached to the database being copied
  45.        are now copied as well (and compressed).
  46.   (10) meter bar added to indexing functions to chart your progress.
  47.   (11) a browse window with filters now proprly handles the 
  48.        vertical scroll bar.
  49.   (12) onscreen edit in browse of numeric fields lost numbers to the
  50.        right of the decimal point. Problem corrected.
  51.   (13) 
  52.  
  53.  
  54.  
  55. VXINIT and VXDEALLOCATE
  56. -----------------------
  57. To properly institute multiple tasks running vxBase, "Call vxInit" MUST
  58. be the first call to vxBase in your program and vxDeallocate() must be 
  59. the last call and must be tested as shown in the example below.
  60.  
  61.      ' Init in first form_load
  62.      ' -----------------------
  63.      Sub Form_Load()
  64.         vxInit
  65.         vxCtlGraySet
  66.      End Sub
  67.  
  68.  
  69.      , on exit, test if unload legal
  70.      ' with vxDeallocate
  71.      ' -----------------------------
  72.      Sub Form_Unload (Cancel As Integer)
  73.  
  74.         ' if vxDeallocate does not return 
  75.         ' TRUE, we may not exit this app
  76.         ' -------------------------------
  77.         If Not vxDeallocate() Then
  78.            Cancel = -1 
  79.            VXFORM1.Show
  80.         Else
  81.            vxCtlGrayReset
  82.            End
  83.         End If
  84.      End Sub 
  85.  
  86.  
  87. Multitasking Memory Usage
  88. -------------------------
  89.    vxDeallocate is now a function instead of a sub procedure. It
  90. must be tested as above. vxInit was added and vxDeallocate was 
  91. changed for the following reasons:
  92.    If running a number of vxBase tasks concurrently, the first
  93. task that calls vxBase has all database memory allocated to it. If
  94. other vxbase tasks are loaded while the first is running, these tasks
  95. SHARE vxbase memory with the first task.
  96.    The new vxInit function registers the current task in a multitasking
  97. list maintained by vxBase. If it is the first vxBase task, that fact
  98. is also recorded.
  99.    vxDeallocate as the last call before exit in your application tests
  100. to see if the task that owns the memory (i.e., the first task) is
  101. being closed. If so, and there are active vxbase tasks that were 
  102. started AFTER the memory owning task, an error message is issued to
  103. the user that the task closure sequence is incorrect. The programmer
  104. must NOT exit the first application until all other tasks subordinate to 
  105. the first have been closed. In other words, the first vxBase application
  106. to be run must be the last to be closed. 
  107.    Use a sequence of code as shown in the example above in your VB
  108. application exit routine (i.e., the last form_unload) to ensure that
  109. the task closure sequence is correct (otherwise - U.A.E.!)
  110.  
  111.  
  112. vxSetLanguage
  113. -------------
  114.    This release adds French, Spanish, and German language support. If
  115.  
  116.           vxSetLanguage(VX_FRENCH)  or
  117.           vxSetLanguage(VX_GERMAN)  or
  118.           vxSetLanguage(VX_SPANISH)
  119.  
  120. is called. all browse and memo menus, dialog boxes, and error messages
  121. generated by vxBase will be in the language of choice. Subsequent startups
  122. of vxBase will also be in the last selected langauge whether vxSetLanguage
  123. is called or not. To set the language back to English, use
  124.  
  125.           vxSetLanguage(VX_ENGLISH) 
  126.  
  127.  
  128. The 1.05 documumentation only mentions VX_FRENCH. VX_GERMAN and VX_SPANISH
  129. were added to release 1.05a.
  130.  
  131. vxBase Installation
  132. -------------------
  133.     vxBase is distributed on a single diskette or on bulletin boards
  134. as two compressed .ZIP files. The first ZIP file is vxbdoc.zip, which
  135. contains the documentation in a Windows Write file. This file is
  136. essential to understanding and using vxBase. If it is missing, contact
  137. the author at the address below.  The documentation is separated from
  138. the rest of vxBase to allow potential users to preview it before
  139. installing and actually using vxBase. This is especially helpful to
  140. potential users who extract vxBase from a bulletin board. They can
  141. evaluate the system from a documentation standpoint before committing to
  142. downloading the larger system.
  143.  
  144.     Unzip vxbdoc.zip and view or print it. The manual is more than
  145. 180 pages long. It was formatted for an Epson 24-pin printer using standard
  146. Roman and Courier fonts. Printed manuals may be obtained for $15.00.
  147. See the end of the documentation for ordering information.
  148.  
  149.     The second ZIP file (vxbase.zip) contains the sample source code
  150. and Visual Basic project files, vxbase.txt which includes all of the Visual
  151. Basic declarations for the routines in the vxBase DLL and the vxBase DLL
  152. itself.
  153.  
  154.     If you are going to upload vxBase to a bulletin board, it must be
  155. sent as it was received - in two ZIP files.
  156.  
  157.     When the system ZIP file is decompressed, it contains this readme.doc
  158. file and 2 more ZIP files. These ZIP files are:
  159.  
  160.     vxbdll.zip    the vxBase DLL
  161.     vxbtest.zip    sample source code and vxbase.txt
  162.  
  163.     To install vxBase, first make a subdirectory under your \vb
  164. directory named \vb\vxbtest and copy the vxbtest.zip file there. Unzip it
  165. and delete the vxbtest.zip file from your hard disk. To run the sample
  166. application it is essential that these files be in directory \vb\vxbtest
  167. because this path is hard-coded into the sample code. If you MUST put it
  168. somewhere else, you'll have to modify the file names in the source code to
  169. reflect your location.
  170.  
  171.     Unzip vxbdll.zip and place the resulting file (VXBASE.DLL) in your
  172. \windows directory.
  173.  
  174.         To run the sample program, see the Sample Application section in the
  175. manual.
  176.  
  177. Terry Orletsky
  178. vxBase (512523 ALberta Ltd)
  179. #200, 10310 - 176 Street
  180. Edmonton, Alberta, Canada
  181. T5S 1L3
  182. Phone (403) 489-5994
  183. Fax (403) 486-4335
  184. Compuserve I.D. 70524,3723
  185.  
  186.  
  187.