9.3 Important Note for LANSA Open Upgrade
If your LANSA Open system is at LANSA V9.1 or earlier:
The required DLL files were installed in the Windows SYSTEM or SYSTEM32 directory and once the installation was completed successfully, LCOEW32.DLL could be moved to a directory other than the Windows SYSTEM or SYSTEM32 directory in which it was installed.
With LANSA Version 10.0 or greater, the LANSA Open directory structure has been changed to cater for multiple LANSA configurations. This means that LANSA Open (and LANSA/Connect) files are no longer installed in the Windows SYSTEM directory.
When you upgrade to LANSA Version 10.0 or greater you will need to carry out one of the following steps. Failure to do so may cause your application to fail. Whether you will need to carry out these steps once, or for each LANSA Open upgrade, will depend on the option that you choose.
A. For single or multiple LANSA Open systems
B. For a single LANSA Open system
A. For single or multiple LANSA Open systems
You can choose from one of the following options.
1. Load the LANSA Open DLL (LCOEW32.DLL) from the LANSA directory structure.
a. Change your application's code to load the LANSA Open DLL (LCOEW32.DLL) from the LANSA directory structure (that is, the LANSA Open directory), rather than relying on the system to locate the LANSA Open DLL.
For example, LANSA Open could be installed into the structure below, and your application changed to load LCOEW32.DLL from there:
%ProgramFiles%\<your company name>\Open
2. You may choose to develop an intelligent installation program to read the location from the registry:
a. After the LANSA Open installation, store the LANSA Open path in the PC's registry.
b. Code the application to read the path from the PC's registry key value.
Refer to the manual of your development tool for how to load a DLL dynamically.
3. Move the application that uses LANSA Open to the LANSA Open directory and make the LANSA Open directory the application working/startup directory.
For example, move all the files from <drive>:\<MyApp> to <drive>:\<MyApp>\Open so that this is the resulting directory structure:
<drive>:\MyApp\Open\<application files>.*
LANSA Open files.*
<drive>:\MyApp\Connect\*.*
B. For a single LANSA Open system
If you are certain that only one version of LANSA Open is required, then you can use the following option.
1. Set the path environment variable to include the LANSA Open directory.
To do this:
a. From the Start button, select Settings, Control Panel, System, the Advanced tab and then select the Environmental Variables button.
b. Add the directory to the PATH environment variable. Make sure that you add the path before the SYSTEM (or SYSTEM32) directory to ensure the V10.0 files are located.
Note: Only the <drive>:\<directory>\Open path is required in the Windows PATH statement. LANSA Open will then be able to locate the
<drive>:\<directory>\Connect
b. Remove LANSA Open and LANSA Connect files from the system directory if they are no longer in use.
Note: Your application needs only to load the LANSA Open DLL (LC0EW32.DLL). LANSA Open will locate the Connect DLL.