home *** CD-ROM | disk | FTP | other *** search
/ Datatid 1999 #6 / Datatid_1999-06.iso / internet / Tango352Promo / P.SQL / README.TXT < prev    next >
Encoding:
Text File  |  1999-02-01  |  22.1 KB  |  552 lines
  1.                     Pervasive.SQL 7 Workstation Engine
  2.                               February 1999
  3.                              GENERAL RELEASE
  4.                                README.TXT
  5.  
  6. ======================================================================
  7. Contents
  8. ========
  9. 1. General Information
  10. 2. New Features
  11. 3. DOS support using Workstation engine
  12. 4. Installation Notes
  13. 5. Documentation Updates
  14. 6. Known Issues
  15. 7. Technical Support
  16. 8. Disclaimer
  17.  
  18.  
  19. ======================================================================
  20. 1. General Information
  21. ======================
  22.  
  23. Overview
  24. --------
  25.  
  26. This complete installation of Pervasive.SQL 7 Workstation includes 
  27. the updated components from Service Pack III.
  28.  
  29. Pervasive.SQL 7 Workstation is the latest innovation from Pervasive 
  30. Software, combining the Best of Both Worlds -- giving you Btrieve, 
  31. ODBC, and a SQL interface in one desktop product.  With this new 
  32. product, you can take advantage of SQL standards and legendary Btrieve 
  33. performance to access the same data concurrently.  You can even make 
  34. Btrieve calls and SQL calls in the same application.
  35.  
  36. Pervasive.SQL Workstation is a high performance single-user 
  37. database engine designed to be maintenance free and easily
  38. embeddable into third-party software products.
  39.  
  40. Pervasive.SQL includes the latest major upgrade to the MicroKernel
  41. Database Engine(TM), version 7.01.  Exciting new features and 
  42. substantial performance improvements make this release our best ever.
  43.  
  44. In addition, the ODBC driver version 2.54 is included.
  45.  
  46.  
  47. For further information about system requirements, how to install,
  48. and how to configure the database engine, see the
  49. books entitled, "Getting Started" and "User's Guide".  Both 
  50. documents are available on the CD in Windows Help (HLP) format.
  51.  
  52.  
  53. SEE ALSO: READODBC.TXT in the client installation regarding ODBC
  54.           driver issues.
  55.  
  56.           http://www.pervasive.com for announcements, technical
  57.           papers, patch downloads, and other information.
  58.  
  59.  
  60. Supported Operating Systems
  61. ---------------------------
  62.  
  63. Pervasive.SQL v7 Workstation engine is available for:
  64.   - Windows NT 4.0 (Service packs 1-4)
  65.   - Windows 95
  66.   - Windows 98 (official release only)
  67.  
  68.  
  69.   * Installing the Pervasive.SQL Workstation engine and the
  70.     Pervasive.SQL Server engine on the same machine is permitted,
  71.     but you may not run both engines at the same time.
  72.  
  73.  
  74. Disk Space Required
  75. -------------------
  76.  
  77. Platform            Typical Install
  78. --------            ---------------
  79. Windows             9 MB (System directory)
  80.            27 MB (Installation directory)
  81.  
  82. For a listing of all files in the release, see the file
  83.   <CD-ROM>:\DOC\COMMON\MANIFEST.TXT.
  84.  
  85.  
  86. ======================================================================
  87. 2. New Features
  88. ===============
  89. The following features are new to this release.  Detailed information
  90. on these features can be found in the product documentation.
  91.  
  92.      - Engine loading.  The Workstation engine auto loads and unloads
  93.        on application demand. A tray icon on your Windows task bar
  94.        shows when the engine is active.
  95.  
  96.      - Smart Components.  This new internal architecture
  97.        eliminates version conflicts and component incompatibilities
  98.        for Win16 and Win32 applications. A new error logging
  99.        system makes troubleshooting much easier.
  100.        For more information, see "Smart Components" in the "User's
  101.        Guide".
  102.  
  103.      - Internationalization support.  The Btrieve interface 
  104.        supports locale-specific Alternate Collating Sequences (ACSs), 
  105.        and comes with International Sorting Rules (ISRs) for English,
  106.        Spanish, French, German, and Japanese.  Single- and double-byte
  107.        character sets are supported.  Internationalization support is
  108.        not available for the SQL interface in this release.
  109.  
  110.      - Support for 64 GB files.  Data files have a new file size
  111.        limit of 64 GB.
  112.  
  113.      - New and upgraded utilities make your maintenance or recovery
  114.        tasks much easier.
  115.  
  116.      - The DDF Ease utility has been enhanced to allow altering
  117.        table and column definitions, as well as table locations.
  118.  
  119.      - A new operation, Stat Extended (65), allows programmers to
  120.        retrieve the names and paths of extension files associated
  121.        with a large database. For more information, see "Stat Extended
  122.        (65)" in the "Pervasive.SQL Programmer's Reference." (available
  123.        with the Pervasive.SQL SDK).
  124.  
  125.      - Documentation completely updated.  All books available online
  126.        in Windows Help format.
  127.  
  128.      - Pervasive.SQL 7 Workstation supports your DOS Btrieve
  129.        applications through a new virtual DOS device driver that
  130.        allows DOS applications to directly access the 32-bit
  131.        MicroKernel database engine.
  132.  
  133. Service Pack III includes several enhancements to the overall product.
  134. In general, improvements have been made to the SQL cost-based
  135. optimizer, resulting in more efficient query optimization and
  136. increased performance--especially for large tables.
  137.  
  138. The following enhancements have been made with this Service Pack:
  139.  
  140. --The engine allows the file version to be specified on a Create 
  141.   operation. Before this enhancement, you could not rely on the 
  142.   engine's Create File Format configuration to be set properly 
  143.   because another application's installation may have changed this 
  144.   setting.
  145.  
  146.   This feature allows applications that run in a mixed environment
  147.   of versions 6.x and 7.x engines to work exclusively with 6.x files.
  148.   It also eliminates the possibility of other Pervasive.SQL-based 
  149.   applications changing the setting.
  150.  
  151.   Now you can also create a 5.x file format with Pervasive.SQL. 
  152.   Previously, a 506-byte record did not work on a 512-byte page with 
  153.   a 6.x or 7.x format because the engine did not have a setting for 
  154.   Creating files in version 5.x format.
  155.  
  156.   Now the Create operation handles file versioning like the Stat
  157.   operation. For more information about file specifications for
  158.   the Create operation, see the Stat operation "Details" and
  159.   "File Specifications" in the Programmer's Guide. If you use this
  160.   version of the Create operation with earlier versions of the
  161.   MicroKernel, a Status Code 26, "The number of keys specified is
  162.   invalid," will occur.
  163.  
  164. --Long file name support, including support for embedded spaces,
  165.   has been added in this Service Pack for both the NetWare and
  166.   Windows 32 environments. All references to files can contain
  167.   embedded spaces and be longer than 8 bytes.
  168.  
  169.   Previous versions of Btrieve allowed spaces to be added at the
  170.   end of a file name in path-based operations such as Open and
  171.   Create.  This is still the default behavior.  Existing
  172.   applications will not break. However, if you want to take
  173.   advantage of file and directory names with embedded spaces,
  174.   change the Embedded Spaces setting for the Btrieve Requester 
  175.   to "Yes." In the registry, you can locate this setting under
  176.   HKEY_LOCAL_MACHINE->SOFTWARE->Pervasive Software->Btrieve
  177.   Requester->Version 7.0->Settings->Embedded Spaces.
  178.  
  179.   Even when you turn the option "Off," and application that
  180.   accesses a file having a name with embedded spaces can enclose
  181.   that name in double quotes while making the BTRV/BTRVID/BTRCALL/
  182.   BTRCALLID call to open or create the file.
  183.  
  184.   NOTE: It needs to be mentioned that on NetWare long file name 
  185.         support is available only in the MicroKernel and not in 
  186.         any of the other NLM utilities such as BUTIL.NLM. This 
  187.         means that Btrieve data files may be accessed using long 
  188.         names but long names cannot be used for any other kind of 
  189.         files.  For example, in the NLM command:
  190.  
  191.         BUTIL -CREATE <outputFile> <descriptionFile>
  192.  
  193.         The <outputFile> being a Btrieve data file manipulated by 
  194.         the MKDE can have a long name but the <descriptionFile> must 
  195.         have only a short name as BUTIL.NLM does not understand 
  196.         long names.
  197.  
  198.  
  199. --Improved performance now occurs during an xLogin/XQLLogin. Dead
  200.   or disconnected drive mappings no longer impact login speed.
  201.   Also, the performance issue with logging into a local named
  202.   database has been corrected.
  203.  
  204.   With the performance improvements to XQLLogin/xLogin, it is
  205.   possible that a backwards compatibility issue may occur with
  206.   applications that log in using a path. This may happen if the
  207.   application references a drive letter in a SQL statement that was
  208.   1)a networked drive letter, 2) not the same drive as one that 
  209.   was logged into since the application started, and 3) intending
  210.   to reference a subdirectory based from where the current 
  211.   directory resides. (For example, the current subdirectory of 
  212.   network drive M: is M:\TEST; the application knows this and tried
  213.   to reference subdirectory TESTDB inside M:\TEST by specifying
  214.   M:TESTDB.)
  215.  
  216.   When conditions 1 and 2 are met, the SQL engine does not know
  217.   the current subdirectory for the drive letter. For example, if drive
  218.   M: is a network drive (never having been logged into by a path
  219.   since the application was started), and its current directory is
  220.   TEST (containing a subdirectory TESTDB), the user must fully
  221.   qualify any path inside a SQL statement that references this drive
  222.   letter.
  223.  
  224.   Examples:
  225.  
  226.   1. ALTER TABLE MyTest using 'm:\test\data1.dat' ...
  227.      This will always work correctly. This path should always be
  228.      fully qualified.
  229.  
  230.   2. ALTER TABLE MyTest using 'm:test\data1.dat' ...
  231.      This will treat the path as M:\TEST\DATA1.DAT. It works but
  232.      does not work as expected.
  233.  
  234.   3. ALTER TABLE MyTest using 'm:testdb\data1.dat' ...
  235.      This will treat the path as M:\TESTDB\DATA1.DAT and will not
  236.      work correctly unless a directory TESTDB existed at the root
  237.      of M:. This behavior would still be unexpected.
  238.  
  239.   NOTE: This may only become an issue using the Windows 32 version
  240.         of the SQL interface (SIF). If for some reason this does 
  241.         become a problem, there are two simple workarounds:
  242.  
  243.         1. Specify a fully qualified path on the SQL statement when
  244.            referencing drive letters.
  245.         2. Disable the new fast login capability by adding a REG_SZ
  246.            (string) registry entry called 'Fast Login' under
  247.            HKEY_LOCAL_MACHINE->SOFTWARE->Pervasive Software->
  248.            Scalable SQL Requester\Version 4.01->Settings and set
  249.            the value to "No." If this entry is missing (the default)
  250.            or set to anything other than "No," fast login will be
  251.            enabled.
  252.   
  253. --The SQL engine now includes an additional memory allocation scheme
  254.   which, if enabled, will immediately release freed memory back to 
  255.   the operating system instead of caching and reusing it for future
  256.   allocations. This instant "garbage collection" prevents the SQL
  257.   engine from holding on to large amounts of memory which may be
  258.   needed by other applications, resulting in an overall smaller
  259.   memory footprint and more efficient steady-state operation. 
  260.  
  261.   The benefits from this are most noticeable under NetWare. For
  262.   NetWare, the new allocator can be enabled by adding the parameter
  263.   /n:2 to SSQL.NLM in SQLSTART.NCF. For NT/95/98, add a new DWORD
  264.   registry entry called "Memory Allocator" to HKEY_LOCAL_MACHINE->
  265.   SOFTWARE->Pervasive Software->Scalable SQL [Server| Workstation]
  266.   Engine->Version x.xx->Settings and set the value to 2.
  267.  
  268.   Only values 0 (original mode) and 2 (new mode) are valid. If the
  269.   parameter/registry entry is missing or contains an invalid value,
  270.   the original mode is enabled by default.
  271.  
  272.  
  273. --The SQL engine now allows you to perform a CREATE or DROP INDEX
  274.   operation on a table while in use for read access by another
  275.   SQL session.
  276.  
  277. --On the Component Tab in SmartScout, you may right-click on a 
  278.   component and choose "Component ID" to view the internal Pervasive
  279.   Signature for Pervasive DLLs and EXEs.
  280.  
  281.  
  282. ======================================================================
  283. 3. DOS support using Workstation engine
  284. =======================================
  285.  
  286. * Before starting any DOS applications on Windows 9X, you must run
  287.   BTRBOX95. To do this, click Start, point to Programs, and select
  288.   Pervasive SQL 7.  Then select BTRBOX95. A small dialog displays
  289.   to indicate that the support is active.
  290.  
  291.   Next, each time you want to start a DOS application, run BDOSSTUB 
  292.   at the DOS prompt immediately prior to running your DOS 
  293.   application.  Then start your DOS application.
  294.  
  295.   You do not need to run the BTRBOX95 application for DOS apps running
  296.   on Windows NT.
  297.  
  298. * For Windows 9X, you only need to start BTRBOX95 once to support
  299.   multiple DOS applications in multiple DOS boxes.  However, you must
  300.   run BDOSSTUB in every DOS window that will run a DOS application.
  301.  
  302. * The proper order to stop a DOS application is as follows:
  303.  
  304.    1. Stop DOS application
  305.    2. Close DOS box
  306.    3. Stop BTRBOX95
  307.  
  308.   If you do not follow this order, BTRBOX95 or the database engine
  309.   may not reload properly until you reboot.
  310.  
  311. For defects related to DOS support, see the heading "DOS
  312. Support for Btrieve Applications" under the section "Known Issues".
  313.  
  314.  
  315.  
  316. ======================================================================
  317. 4. Installation Notes
  318. =====================
  319.  
  320. * BEFORE INSTALLING, READ THIS SECTION AND REVIEW "KNOWN ISSUES" FOR 
  321.   INSTALLATION, LATER IN THIS DOCUMENT.
  322.  
  323. * This release includes version 7.01 of the MicroKernel,
  324.   version 4.01 of the Scalable SQL engine, and version 2.54 of the
  325.   ODBC driver.
  326.  
  327. * You cannot run a Pervasive.SQL 7 Workstation engine on a
  328.   machine that is already running a Pervasive.SQL 7 Server engine.
  329.  
  330. * You cannot install Pervasive.SQL Workstation on a Windows NT machine
  331.   if Btrieve 6.15 Server is running on that machine.  Be sure to stop 
  332.   the "BTI MicroKernel Engine" service using the Services control in 
  333.   the Control Panel.  The Server engine is normally set for 
  334.   Autostart, so it will usually be running at the time you attempt 
  335.   to install the Pervasive.SQL Workstation. 
  336.  
  337. * If you get the following dialog box during an install:
  338.  
  339.    There was an internal error and one of the windows you were using
  340.    has been closed.  It is recommended that you save your work and
  341.    close all programs, and then restart your computer.
  342.  
  343.   You probably have one or more other applications running at the same
  344.   time as you are running SETUP.EXE.  Your installation likely will
  345.   complete successfully after receiving one or more of these messages.
  346.   However, Pervasive recommends that you quit all other applications
  347.   before installing Pervasive.SQL.
  348.  
  349. * You may experience installation problems if you install in a
  350.   directory path that contains long filenames or embedded spaces in
  351.   the directory path.  Pervasive recommends installing on the default
  352.   path or any path without long file names or embedded spaces.
  353.  
  354. * If you are using Windows NT and you have separate boot and system
  355.   partitions, you may encounter a problem where the AUTOEXEC.BAT file
  356.   on the boot partition is not updated to reflect the PERVASIVE_PATH
  357.   environment variable.  This only applies if you are using Windows
  358.   3.1 applications on the Windows NT machine.  To fix this problem,
  359.   after installing Pervasive.SQL, copy the setting of PERVASIVE_PATH
  360.   from your system AUTOEXEC.BAT to your boot AUTOEXEC.BAT. #12636
  361.  
  362. * You may encounter installation failures (insufficient disk space) if
  363.   your system is low on virtual memory or if the directory specified
  364.   by the %TEMP% environment variable has very limited disk space
  365.   available.
  366.  
  367.   Solution: Quit all programs except the installation. Make sure that
  368.   the file system containing your %TEMP% folder has at least 10 MB of
  369.   free disk space, and your target installation directory has at
  370.   least the amount of free space shown during the installation
  371.   procedure. If the failed installation created an Uninstall program
  372.   item, run it before re-starting the installation.
  373.  
  374.   Note: if you are using a "temporary" Windows swap file (see the
  375.   Virtual Memory section of the "System" controls in the
  376.   Windows Control Panel), the required free space must still be
  377.   available after the swap file has consumed the maximum amount of
  378.   disk space that it is allowed.  A temporary swap file may be small
  379.   at startup, but is allowed to grow to its maximum size setting.
  380.   What appears as "free" space may actually be reserved by the
  381.   temporary swap file.
  382.  
  383.  
  384. ======================================================================
  385. 5. Documentation Updates
  386. ========================
  387. The section provides corrections or additions to the documentation
  388. shipped with the product.
  389.  
  390.  
  391. * You may encounter GPFs in Winhlp32.exe if you attempt to print
  392.   topics of Windows help files from the Contents menu.
  393.  
  394.   Workaround:  None. #14056
  395.  
  396. Please visit ftp://ftp.pervasive.com/documentation/updates for any 
  397. product documentation that may be updated between product releases. 
  398.  
  399.  
  400.  
  401. ======================================================================
  402. 6. Known Issues
  403. ===============
  404.  
  405. Please note that the most up-to-date list of current issues is
  406. available on the Pervasive web site at the following URL:
  407.  
  408. http://www.pervasive.com/support/technical/papers/psql7ftf.html
  409.  
  410. Also see READODBC.TXT installed with the ODBC client.
  411.  
  412.  
  413. Installation
  414. ------------
  415.  
  416. * The Workstation engine program icon located in the "Pervasive SQL 7"
  417.   folder may show as a blank icon in Windows 9X.
  418.  
  419.   Workaround:  None. #14047
  420.  
  421. * If you perform the following steps without restarting your machine,
  422.   you may end with a PATH variable that does not include the 
  423.   \pvsw\bin directory, and thus you may have difficulty running 
  424.   Pervasive.SQL.
  425.     - Install Pervasive.SQL on a machine without a previous
  426.           Pervasive.SQL installation
  427.     - Uninstall Pervasive.SQL
  428.     - Re-install Pervasive.SQL
  429.  
  430.   Workaround:  If you need to un-install and re-install, be sure to
  431.   restart your machine or modify your PATH variable to reflect the
  432.   location of the Pervasive.SQL engine. #14652
  433.  
  434. * On Windows NT, the ODBC Interface can be uninstalled by a Guest
  435.   user even if it was installed by Administrator or a user with
  436.   Administrator privileges.
  437.  
  438.   Workaround: None. #14593
  439.  
  440.  
  441. DOS Support for Btrieve applications
  442. ------------------------------------
  443.  
  444. * If you open a DOS prompt on Windows NT or run btrbox95.exe on
  445.   Windows 9X, WBTRV32.DLL will be loaded.  If you then issue
  446.   the command "butil -stop", additional DLLs will load:
  447.   W3AIFxxx.DLL, W3BIFxxx.DLL, W3UPIxxx.DLL, W3SCMV7.DLL.
  448.  
  449.   Workaround: Close the DOS prompt on NT or stop btrbox95.exe on
  450.   Windows 9X to force these DLLs to unload.  #14502
  451.  
  452. Utilities
  453. ---------
  454.  
  455. * You cannot use the Setup utility (W32MKSET.EXE) provided with the
  456.   Btrieve Workstation Engine version 6.15 to configure the MKDE
  457.   Interface shipped with Pervasive.SQL 7.0.  Any setting change made
  458.   to the 7.0 MKDE Interface component using the 6.15 Workstation Setup
  459.   will be accepted but not saved.  Use the "Setup (Win32)" utility
  460.   (W32SSET.EXE) shipped with Pervasive.SQL 7.0 to configure the MKDE
  461.   Interface shipped with Pervasive.SQL 7.0. Continue to use the setup
  462.   utility shipped with the version 6.15 Workstation Engine to
  463.   configure the MKDE Interface version 6.15.  
  464.  
  465.   No Workaround. #13174
  466.  
  467. * In DDF Ease, if you select the Check Database option, the word
  468.   "Modifiable" is misspelled as "Modiable."  
  469.  
  470.   No Workaround. #14654
  471.  
  472. * In DDF Ease, the Check Database option assumes that an index 
  473.   exists for every number from 0 up.  If a particular index number
  474.   does not exist, Check Database reports errors for the one that 
  475.   is missing and for every index number greater than that.
  476.  
  477.   Workaround: Ensure that your index numbers are sequential from 
  478.   zero.  #14628
  479.  
  480. * In some uncommon cases, DDF Ease may not prompt you to save 
  481.   index changes when you change views, and any changes that you 
  482.   made will be lost.
  483.  
  484.   Workaround: Always save your changes before selecting a new table
  485.   in the database.  #14623
  486.  
  487. * In DDF Ease, if you change a drive mapping while the application
  488.   is open, DDF Ease will display information for the previous
  489.   mapping of the drive, but will correctly access the drive if
  490.   data is accessed.
  491.  
  492.   Workaround: If you change drive mappings, re-start DDF Ease. 
  493.   #14127
  494.  
  495.  
  496. Pervasive.SQL Engine
  497. --------------------
  498.  
  499. * If you use the Setup Utility to configure the MicroKernel Router
  500.   so that Local=On and Requester=On, and you are accessing data on
  501.   a remote file path (using Pervasive.SQL Server), your application
  502.   may cause the local Workstation engine to load into memory if an
  503.   operation 26 or 28 is called.
  504.  
  505.   Workaround: In the Setup Utility, configure the MicroKernel Router
  506.   so that Local=No.  #14032
  507.  
  508. * If the XQLVersion API, option 3, is called with an invalid 
  509.   database name or invalid path, it returns Status Code 0, when
  510.   Status code 2103 is expected.
  511.  
  512.   Workaround: None.  #14160
  513.  
  514.  
  515. Pervasive.SQL APIs
  516. ------------------
  517.  
  518. * Calling XQLLogin may hang your application if it is used from 
  519.   more than one thread at the same time.
  520.  
  521.   Workaround: None. #13998
  522.  
  523. ======================================================================
  524. 7. Technical Support
  525. ====================
  526.  
  527. Please see "Getting Started" for information about how to
  528. contact Pervasive and/or get more information about Pervasive.SQL.
  529.  
  530.  
  531. ======================================================================
  532. 8. Disclaimer
  533. =============
  534. PERVASIVE SOFTWARE INC. LICENSES THE SOFTWARE AND DOCUMENTATION
  535. PRODUCT TO YOU OR YOUR COMPANY SOLELY ON AN "AS IS" BASIS AND SOLELY
  536. IN ACCORDANCE WITH THE TERMS AND CONDITIONS OF THE ACCOMPANYING
  537. LICENSE AGREEMENT.  PERVASIVE SOFTWARE INC. MAKES NO OTHER WARRANTIES
  538. WHATSOEVER, EITHER EXPRESS OR IMPLIED, REGARDING THE SOFTWARE OR THE
  539. CONTENT OF THE DOCUMENTATION; PERVASIVE SOFTWARE INC. HEREBY EXPRESSLY
  540. STATES AND YOU OR YOUR COMPANY ACKNOWLEDGES THAT PERVASIVE SOFTWARE
  541. INC. DOES NOT MAKE ANY WARRANTIES, INCLUDING, FOR EXAMPLE, WITH
  542. RESPECT TO MERCHANTABILITY, TITLE, OR FITNESS FOR ANY PARTICULAR
  543. PURPOSE OR ARISING FROM COURSE OF DEALING OR USAGE OF TRADE, AMONG
  544. OTHERS.
  545.  
  546. (C) Copyright 1999 Pervasive Software Inc.
  547. All Rights Reserved.
  548.  
  549.  
  550.  
  551. **End of README.TXT**
  552.