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

Dear Forest & Trees User:

Thank you for purchasing Forest & Trees for Windows!

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

-  DB2/2
   The DB2/2 Provider now supports options to stay connected to the server
   and to have the provider stay resident in memory.  Both of these can
   help improve the performance of you DB2/2 queries.

-  Oracle
   Oracle Provider performance has been enhanced by retrieving blocks of
   data.  The size of the blocks that are being retrieved can be dictated
   in the FTW.INI file 

-  ODBC
   There was a minor change made to support the Showcase AS/400 driver

==========================================================================
DB2/2 PROVIDER
---------------

The following options can be controlled in the [DB2/2] section of your
ftw.ini file.

-  STAYCONNECTED=(NO)YES allows you to cause the DB2/2 provider to stay 
   connected to the database as long as possible. NO, the default, forces 
   the DB2/2 provider to connects to the database each time a DB2/2 view 
   is calculated, then disconnects when the calculation is finished. 
   YES forces the DB2/2 provider will remain connected to the database 
   until (1) another DB2/2 view is calculated that uses a different 
   database; or (2) the DB2/2 provider is unloaded from memory.
   Turning on the STAYCONNECTED option may speed up your DB2/2 view
   calculations.

-  STAYRESIDENT=(NO)YES allows you to cause the DB2/2 provider to remain 
   resident in memory for the duration of the Forest & Trees session. 
   (NO), the default, forces the DB2/2 provider to be loaded into memory 
   only when needed, and unloaded when some other provider is needed. 
   YES forces the DB2/2 provider to remain loaded in memory until you 
   quit Forest & Trees.

-  FILTER= is used to limit the tables listed by the Query tool in Query
   Assist, Table Browse, List Columns, and List Accelerators.  A table-name
   filter can also be entered in the Other box of a view's Database window.
   When specified in the FTW.INI file, the filter affects all DB2/2 views
   used with you copy of F&T.  When specified in a view's Other box, the
   filter affects only that view and is added to any filter that may be
   specified in your FTW.INI file.

   The filter becomes part of the WHERE clause in the provider's internal
   SQL query that retrieves table names from DB2/2.  Examples:
       FILTER=CREATOR='JOE' limits the table list to those created by Joe
       FILTER=NAME LIKE 'A%' limites the table list to those starting with A
   
   You may specify multiple conditions using AND and OR.

==========================================================================
INFORMIX PROVIDER
-----------------
-  If you enter an incorrect server name in the REMSQL command, the first 
   time that Forest & Trees attempts to contact the server you will receive
   the error message: 
		"Cannot connect to remote host (%s)."
   If you try again, you will receive the error message:
		"SQL engine terminated unexpectedly."
   On the third and subsequent attempts, you will receive the error message:
		"Back end not found. Or back end is busy."

   You must quit Windows, reboot your PC, and login again with REMSQL to 
   correct this error. 

==========================================================================
INGRES PROVIDER
---------------

-  You must have INGRES/Net, version 6.4 installed on your PC to
   access an Ingres database with Forest and Trees.

-  Rev 5 of the Ingres provider is enabled by default; this revision 
   supports Ingres 6.4/04.  If you need support for Ingres 6.4/03
   you should use Rev 3 of the Ingres provider.  To enable Rev 3,
   MAKE SURE FTW IS NOT RUNNING and type the following commands at a 
   DOS prompt, in the FTW install directory:

        COPY  INGRES.FTW  *.R5
        COPY  INGRES.R3   *.FTW

   These commands will insure you have a copy of each rev available.

-  The Ingres DLL uses 6464 additional bytes of memory each time that a 
   connection and disconnection is made to a database. By default, 
   Forest & Trees connects to the database each time a view is 
   calcu lated. Eventually, all memory is used up, with unpredictable
   results.  This problem can be alleviated using a combination of 
   Ingres environment variable settings and FTW Ingres provider settings.

==========================================================================
NETWARE SQL PROVIDER
--------------------

-   Two DLLs are distributed with this release of F&T/W: WXQLCALL.DLL is 
    for use with Novell Netware version 3.0; WXQLC211.DLL is for use with
    Novell Netware version 2.11.  F&T/W uses WXQLCALL.DLL; if you are
    using Netware 2.11, you must swap the DLLs with the following
    DOS commands (executed in the directory where you installed F&T/W): 

        COPY  WXQLCALL.DLL  WXQLC300.DLL
        COPY  WXQLC211.DLL  WXQLCALL.DLL

    You must also use the NSREQ.EXE (or NSREQS.EXE) distributed with
    the version of Netware you are using.  The minimum revision of the
    Netware Requestor that is Forest & Trees supports is 2.12A. 

    If you are using the wrong DLL/NSREQ, you may see the following errors:

        2103 NetWare SQL is not active on the requested server
        2112 NSREQ.EXE or NSREQS.EXE Not loaded

    Once you have successfully connected to Netware in your environment, 
    you can delete the WXQLC211.DLL and WXQLC300.DLL files.
    

==========================================================================
ODBC PROVIDER
-------------

The following settings can be added to the [ODBC] section of your ftw.ini
file.

-   DEFAULT_TYPES_ONLY=YES(NO) controls whether the provider retains the
    default data types coming from the ODBC driver involved.  NO, the
    default, converts decimal and numeric types to F&T's double data type
    and money types to F&T's currency type.  YES, retains the default
    data types from the ODBC driver involved.

-   OWNER_NAMES=(YES)NO controls whether the name of the table owner
    (creator) is included in the Query tool's table lists.  YES is the
    default.

==========================================================================
ORACLE PROVIDER
---------------

-   A new version of the ORA6WIN.DLL is installed.  Oracle Corp. has
    requested that this file be distributed with FTW.  The previously
    distributed version of this file is installed as ORA6WIN.OLD.  If
    you have problems connecting to an Oracle database, you may need
    to revert to the previous version of the ORA6WIN.DLL; to do so, 
    MAKE SURE FTW IS NOT RUNNING and type the following commands at a 
    DOS prompt, in the FTW install directory:

        COPY  ORA6WIN.DLL  *.NEW
        COPY  ORA6WIN.OLD  *.DLL

    These commands will insure you have a copy of each DLL available.

    Once you have successfully connected to Oracle in your environment, 
    you can delete the ORA6WIN.OLD and ORA6WIN.NEW files.

Two new settings have been added for use in the [ORACLE] section of your
ftw.ini file.  

-   OWNER_NAMES=(YES)NO controls whether the name of the table owner
    (creator) is included in the Query tool's table lists.  YES is the
    default.

-   BUFFER_ROWS= controls the number of rows that ORACLE
    fetches at a time when returning the results of a query. Default
    is 50.

-   If three error messages are produced while attempting a query to the
    Oracle database, Oracle will no longer return valid error messages
    and the user will need to exit from Windows and re-establish the
    connection to Oracle.

-   When using an alias with Oracle, you must put the alias in 
    double-quotes.  

-   Refer to the following table when specifying MACHINE_TYPE in your
    CONFIG.ORA file as described in the Client-Server Provider Guide:

        Bull Micral BM60            D
        Cordata 4200                A
        CSS Labs 386                8
        DEC Vaxmate                 8
        Harris AT                   9
        Intel Aboveboard 386        2
        Multitech Acer 910          G
        OGIVAR System V             G
        Orchid PC Turbo 286e        7
        PC Limited 286              7
        SOTA Mothercard 5.0         3
        TI 1300                     8

        If your machine is not listed above, try the following:

        286                         0
        386                         2
        Quarterdeck QEMM-386/VCPI   J

==========================================================================
SQLBASE PROVIDER
---------------

Please note the following known issues regarding accessing SQLBase:

-   You will need a communications library for Windows 3.x from Gupta
    Technologies, Inc. to access information from your Gupta databases.
    If you need to order one of these libraries from Gupta Technologies,
    Inc. use the following guide.

    Access Type       Library Name                        Part Number
    -----------------------------------------------------------------
    Local Access      SQL System Programmer's Toolkit         57-1016
    DOS Servers       SQLBase Server DOS                      70-1040
    OS/2 Servers      SQLBase Server OS/2                     70-1100

-   Do not use Query Assist or Format Query if table names or column
    names are delimited by quotes.

==========================================================================
SQL SERVER PROVIDER
-------------------

Please note the following known issues regarding accessing SQL Server:

-   SQL Server 4.2

    Users of the Microsoft SQL Server 4.2 software should use the DBNMP3 
    and W3DBLIB DLLs supplied with that product.

-   Turning on Fast Queries (No Multitasking) will not affect SQL Server 
    queries.

-   SQL Server temporary tables created by F&T are not autotmatically removed
    when exiting a F&T session.  These tables must be removed manually.

-   SQL Server queries do not return column names for columns that use 
    aggregates.  Use a column alias in the query or use Column Layout to 
    name the column.

-   When using aggregate SQL Server function the column name for the
    aggregated column will be blank unless you use an alias.

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

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

