Trinzic Corporation
Forest & Trees for Windows
Version 3.1A
May 30, 1994
Standard Provider Release Notes

Dear Forest & Trees User:

Thank you for purchasing Forest & Trees for Windows!

This document describes features of specific providers not found in
the printed documentation.

For information on Exporting, refer to the Export section of the
FTREADME.TXT (Release Notes) document.

==========================================================================
What's New
----------

-  Lotus Notes
   The Lotus Notes provider can now query Notes views in addition to
   forms (previous versions queried forms only).  This allows Forest &
   Trees to take advantage of internal indexing of Notes views and
   greatly improves performance over querying Notes forms.  It is 
   recommended that you take advantage of this performance improvement
   whenever possible by defining views for any Notes data that you plan
   to query.

-  Lotus 1-2-3
   Version 4 of Lotus 1-2-3 is now supported.

-  Btrieve
   The Btrieve provider can access Btrieve version 6 files.  See below
   for details.

-  dBase
   The dBase provider now supports dBase version III memo fields.

==========================================================================
LOTUS 1-2-3 PROVIDER
--------------------

The Forest & Trees for Windows Lotus 1-2-3 Provider now supports version
4 of Lotus 1-2-3.  The new Lotus 1-2-3 provider is included 
in your software.  Also note these comments:

-   Timestamp values are not supported by 1-2-3.  If you have values
    within your spreadsheet that are the sum of a time and date, use the
    CONVERT(var_name,'TIMESTAMP') function to achieve timestamp
    appearance for the data.
-   F&T reports currency values as double from 1-2-3 Rel 2.01
    spreadsheets.
-   F&T does not support three-dimensional ranges in 1-2-3 Rel 3.  You
    may access data in other spreadsheets or in multi-layer spreadsheets
    by declaring a range name in sheet A:  that refers to values in
    another spreadsheet.
-   Column of numbers formatted as text in .WK1 Lotus 1-2-3 file show as
    NULL when queried by FTW.

==========================================================================
MICROSOFT EXCEL PROVIDER
------------------------
Microsoft Excel version 2.x, 3.x, and 4.0 file formats are supported.
Support for Excel version 5.0 will be available soon.  Contact Trinzic
for more information.

-   F&T/W uses the cell format to determine the data type for a given
    column.  Text that is not formatted as "General" will appear
    as NULLs in F&T/W.
-   F&T does not support all alternate format specifiers.
-   F&T does not support use of multiple range selections for a range.
-   Use of CHAR(0) in a range may lead to unpredictable behavior from F&T.
-   If the first column of the worksheet is blank, F&T may only read the 
    column names and not the data.
-   F&T cannot access password protected Excel files.  You will receive
    an "Unknown File Format" error message if you attempt to query a
    password protected file.  We do not have the decryption algorithym
    for Excel passwords.

The following ftw.ini file setting has been added for the Excel provider.
A [Microsoft Excel] section should be added to your ini file for this entry.

-   USE_SHEET_NAMES=N means you cannot use sheet names when specifying
    table name in your queries - and all table lists in the F&T Query tool
    will show only the range names in an Excel file, with no qualifying
    sheet names.  Y restores the default table-naming convention.

==========================================================================
BTRIEVE PROVIDER 
--------------------

-  Btrieve
   The Btrieve provider can access btrieve version 6 files.  The 
   "stand-alone" version of WBTRCALL.DLL is shipped with F&T (about 51K).
   To connect to version 6 btrieve files you must contact Novell and 
   get the "client server" version of WBTRCALL.DLL (about 11K).  The 
   stand-alone version of the Novell DLL doesn't support Btrieve 6.0.  
   (You must load BREQUEST before starting windows when using the client 
   server DLLs.)

-  Btrieve 6.X Access

   There are two configurations for Btrieve 6.X:

   1) Server-based Btrieve consists of a Record Manager
   that runs at a server and manages data I/O with the file system, and
   Requesters, that run at the workstation and handle data I/O between the
   workstation and the server.  

   2) Client-based Btrieve handles all I/O at the
   workstation and accesses all files through operating system calls.

   For Btrieve versions 5.X, the files WBTRIEVE.FTW, WBTRCALL.DLL, 
   BTRIEV5.EXE, BTRIEV5N.EXE, and B$STOP.EXE are components of the 
   client-based (or "stand-alone") version of Btrieve.  As of this writing,
   the corresponding files for Btrieve 6.X are not available.  As a result,
   it is necessary to run server-based Btrieve when accessing Btrieve 6.X
   files.  This means that the Btrieve Record Manager NLM must be loaded at
   every server that will access files.  Also, you must be running the
   Btrieve Requester software at the workstation to communicate with the
   servers.  The requester files (which are not shipped with F&T, but come
   with Btrieve 6.X) are:

   WBTRCALL.DLL
   WBTRVRES.DLL Btrieve Dynamic Link Libraries file for Windows.  If you 
		wish, you can move these to your Windows SYSTEM directory 
		or to another directory in your DOS path. NOTE that the
                WBTRCALL.DLL that you must use with 6.X is NOT the one
                installed with Forest & Trees.  You should use the one
                provided with Btrieve 6.X.  (The file shipped with F&T is
                about 51K, the Btrieve 6.X version is about 11K.  The size
                difference is due to the fact that the server will be doing
                most of the processing for Btrieve 6.X files.)

   BREQUEST.EXE The DOS Requester, which must be loaded before running
                Windows and Forest & Trees or when you define a Btrieve
		data file with FLIC.  Since this is a requirement of both 
		FLIC and F&T,  it is no longer necessary for BTFLIC.BAT to 
		load the BTRIEV5.EXE Record Manager if you are running FLIC
		from Windows. You should load the Requester before running 
		Windows, and change the icon for FLIC to call the FLIC.EXE
		program directly.  To load the requester, type (at DOS): 
		BREQUEST

   BREQUTIL.EXE Program that removes the Btrieve Requester from memory.
		To use it, type BREQUTIL -STOP.

   For more information on installing configuring server-based Btrieve, 
   refer to the Btrieve Installation and Operations guide.

==========================================================================
LOTUS NOTES PROVIDER 
--------------------

-  The Lotus Notes provider can now query Notes views in addition to
   forms (previous versions queried forms only).  This allows Forest &
   Trees to take advantage of internal indexing of Notes views and
   greatly improves performance over querying Notes forms.  It is 
   recommended that you take advantage of this performance improvement
   whenever possible by defining views for any Notes data that you plan
   to query.


-  Notes fieldnames must be less than 61 characters.

-  Notes can function only as a DDE Client application, not as a server 
   application.  This means Notes can be the target of DDE links, but not 
   the source.

-  Specifying both the Notes UI and FTW in the Windows Startup group 
   (or the Load or Run statements in WIN.INI) can cause FTW Error #5 loading
   the Notes provider.  To correct this problem, load Forest & Trees
   BEFORE loading the Notes UI.

New Notes INI settings
These settings go in the [NOTES] section of the ftw.ini file

-  The Notes provider can be configured to access non-English Notes Servers.

   SELECT_FORMULA=SELECT @uppercase(Form) = @uppercase("%s")

   where the words "SELECT" and "uppercase" are to be translated into
   the appropriate local language terms.

-  SHOW_HIDDEN_VIEWS=YES(NO) determines whether or not hidden Notes views
   are shown in the Query tool's table list. NO is the default

-  CHANGE_TABLENAME_CASE=(YES)NO controls the case in which Notes view and
   form names appear in the Query tool's table list.  YES means forms are
   listed in upper case, views in lower case.  NO means they are listed
   as they are defined in Notes.

-  VIEW_SAMPLES=(50) dictates the number of documents in a Notes view that
   will be read in order to determine each column's data type.

-  TEXT_LENGTH=(254) sets the absolute length of all Notes Text values in
   all of your F&T views, new or existing.

API PROBLEMS
------------

-   The Notes API incorrectly allows a Forest & Trees user to cancel from
    the Notes Password dialog and continue to access Notes databases.  This
    condition can occur if the Notes UI has been loaded and a correct
    password has been entered through that program.  THE NOTES UI 
    OPTIONS-USER LOGOFF FEATURE WILL NOT CLEAR THE USER INFORMATION FOR 
    FOREST & TREES, AND WILL NOT PREVENT A FOREST & TREES USER FROM 
    ACCESSING A NOTES DATABASE.  This problem must be addressed by Lotus
    Development Corp.

============================================================================
DBASE PROVIDER
--------------------

-  dBase
   The dBase provider now supports dBase version III memo fields.

============================================================================

For more information on these and other issues, call our Technical Support 
department at 1-603-427-0444.

Thank you again for purchasing Forest & Trees for Windows.

Brad Haigis
Product Manager
