Upgrading ODBTalk to run under VSE/T 3.10
-----------------------------------------------------------------

Contents
-------------
i.)     General Instructions
ii)     Team Installation
iii)    SLL Installation
iv)     QualifierNameSeparator


  i. General Instructions
 ---------------------------------

    Unzip the file OW32S310.zip in a standalone directory (e.g. \OWS310.UPG).  

    To use the workbench or the PARTS Catalog, you need to have the PARTSTablePane bound to your image (to bind it open a New Workbench and drop a TablePane onto it.  You can discard the PART).

Note that Envy is not supported under VSE/T 3.10.  Therefore there is no upgrade for Envy.

As well the only workbench currently available under VSE/T 3.10 is the PARTS Workbench.  We may release a WBPro based workbench at a later date.

**********************************************************************************************
IMPORTANT: Copy the file 



 ii.  Team Installation
     ------------------------
  
If possible start with a clean image.

Connect to the "LPC ODBTalk Clusters" and "LPC ODBTalk Packages" repositories (Smalltalk->Open->Repository Browser).
 
Load the "ODBTalk Base Development Group" module in the LPC ODBTalk Clusters
(Module->Load  from a Package Browser window).  This will load the core ODBTalk classes in your image.

To use the workbench load the following:
"ODBTalk PARTS Workbenches" from the  LPC ODBTalk Clusters.

To add the ODBTalk Workbench menu to the transcript load:
"ODBTalk PARTS Workbenches Menu Bar" from the  LPC ODBTalk Clusters.

*************************************************************************************************************************************************
IMPORTANT: Delete the package 'LPC - Digitalk PARTS fixes' from the cluster: 'OdbTalk - PARTS Catalog'

This fix provided by Digitalk for VSE/T 3.01 should NOT be in your VSE/T 3.10 image.

Now to use the LPC PARTS Catalog load:
    "ODBTalk PARTS Catalog" cluster. 
*************************************************************************************************************************************************

File in the file UPGRADE.ST from the directory where you unzipped the upgrade.

This file contains the following modifications:

    Workbenches: replaced all methods sending: (self application mainObject) by: (self partNamed: 'XXXXXX').

    OdbcStatement>>setParameter:value: - removed halt.

    SessionModel>>aboutToSaveImage - replaced by the VSE/T 3.10 method.
    
ODBTalk is now ready to run under VSE/T 3.10.  You may want to commit the changes to a new repository.

The first time you invoke the About ODBTalk Workbench ... dialog box you will be prompted for a serial number.  
This number is in the file serial.lpc in the root directory (OW32V301.22) of your original ODBTalk installation.

 
     ------------------     
iii.  SLL Installation
     --------------------------- 

You should if possible start with a clean image.

Copy the SLLs from the previous version of ODBTalk into VSE310\LIB subdirectory or 
add OW32S301\SLL to your path (you must then reboot)

Select the Install... command from the File menu. In the
resulting File dialog,  select the file fileme.in From the UPGRADE DIRECTORY (OW32S310.UPG),
 and press the OK button.
                                                                                  ODBTalk for VST 3.10 will begin its installation.

Or execute the following (This assumes you have installed the upgrade in OW32S310.UPG):

     (File pathName: '\OW32S310.UPG\fileme.in') fileIn; close.

*************************************************************************************************************
File in the file UPGRADE.ST from the directory where you unzipped the upgrade.

This file contains the following modifications:

    Workbenches: replaced all methods sending: (self application mainObject) by: (self partNamed: 'XXXXXX').

    OdbcStatement>>setParameter:value: - removed halt.

   SessionModel>>aboutToSaveImage - replaced by the VSE/T 3.10 method.

****************************************************************************


**************************************************************************
NOTE: You must save your image after the installation. This is required as
----  ODBTalk uses SelfInitializingObject instances to load the ODBC dlls
      and initialize the Environment handle.
**************************************************************************

To use the workbench add the path \OW32S301.22\PARTS to the PARTS.ini file. 
Use the File...Setting menu commands in the PARTS workbench to the path.

**************************************************************************
NOTE: You must add the path OW32S301.22\parts in parts.ini to use the
----  workbench (see above)



iv.  QualifierNameSeparator
     ----------------------
 
Some datasources may return an empty string for the separator (e.g. SQL Anywhere).  This is invalid.  If you encounter a problem with the brokers because of invalid separators, you can replace or modify the following method:

LPCObjectType>>dbMapQualifierNameSeparator
    "(private) returns the table name separator used in the full table name associated with this type"
    |separator|
    separator :=  self dbMap at: #QualifierNameSeparator ifAbsent: [ '.' ].
^separator size < 1 ifTrue:[^'.'] ifFalse:[^separator]

