A division of HNA Computer Systems, Inc. ECLIPSE & Faircom ODBC Driver Getting started is actually quite simple and like most things if you follow all the right steps you should not have any problems. This document will walk you through the process and offer a few simple things that need to be completed correctly in order for the driver to work properly. We highly recommend that you also review the ODBC_Instructions.pdf file that is located in the MPN folder, in the Documents folder. Overview The ODBC driver and any 3 rd party ODBC compliant application software that you will be using will need to be loaded on the workstation where you will be using the connection. If you are in a client/server environment, you will need to make sure that you have access to the folders where the ECLIPSE data is stored. Each workstation that will be using the ODBC connection needs its own licensed copy of the Faircom driver and must be set up separately. You can contact the GalacTek sales department at 1-800-966-1462 to obtain a licensed copy. Loading the ODBC Driver Loading the driver is as simple as running the SETUP.EXE program on disk 1 of the 3 disk set. Setting up the ECLIPSE DNS source After you have installed the Faircom ODBC driver, each workstation that will be accessing the data will have to have a DNS source configured. We have made this step as simple as possible by creating an ODBC_Setup.exe. This setup needs to be run on each workstation that has the Faircom driver installed. This setup also needs to be launched from the mapped driver letter to which ECLIPSE is installed. Running ODBC_Setup.exe 1. If you don t know the drive letter to which ECLIPSE is installed on open ECLIPSE the way you normally do. 2. On the ECLIPSE top toolbar click on Help, then About. Note the drive letter in Data path: <Drive Letter>:\MPN. 3. Exit ECLIPSE 4. Click on Start, Run. Type <Driver Letter>:\MPN\ODBC_Setup.exe 5. You will be presented with the first dialog box. After reading the dialog box click Next. GalacTek 2003 Page 1 Rev. 07-09-2003
6. After clicking on Next, you will be presented with a License Agreement statement. This dialog box provides important information about the installer. If you agree with the dialog, check the I Agree radio button and click Next. 7. Review the installation confirmation dialog and click Next. GalacTek 2003 Page 2 Rev. 07-09-2003
8. If ECLIPSE has never been initialized for ODBC, you will be prompted to do so. Make sure no users are in ECLIPSE on any workstation before clicking on Yes. If you click on No, the database will not be initialized and the ODBC functions will not work. If you are installing the Faircom ODBC driver on other workstations, you can initialize the database at a later time from another workstation when the ODBC_Setup.exe is run or simply re-run the ODBC_Setup.exe from any workstation. 9. Once you click on Yes click on Finish. 10. After you click on Finish, ECLIPSE will automatically be launched. You will be presented with a number of dialog boxes confirming that each database file has been updated and is ready for ODBC use. If you receive any errors that a database file was not updated, more than likely it is because a user is currently in ECLIPSE. If you get such an error you will have to exit the user from ECLIPSE and re-run the ODBC_Setup.exe again. GalacTek 2003 Page 3 Rev. 07-09-2003
How to setup the ECLIPSE DSN Manually If you don't know what a DSN or ODBC Database Source is please consult the ODBC_Instructions.pdf or contact a system tech. If you are running Windows 98/ME/NT, Click on Start, Settings, Control Panel and double click on ODBC Data Sources (32bit). If you are running Windows 2000/XP, Click on Start, Open your Windows Control Panel, double click on the Administrative Tools icon and double click on Data Sources (ODBC). You should see a dialog box like this: To make your DSN connection, click the "Add" button and you should see this dialog box: GalacTek 2003 Page 4 Rev. 07-09-2003
Select the Faircom 32bit ODBC Driver, if it is not already selected, and click on the "Finish" button. A dialog box like this should now open: Click on the "Options" button to see this: GalacTek 2003 Page 5 Rev. 07-09-2003
You are now ready to fill in the details for your ODBC connection with these parameters. Fill in the Data Source Name with any name that you want to call you ODBC connections. It is suggested that you keep it simple like ECLIPSE. Faircom ODBC driver settings should be as follows: Max columns 256 Data buffer size 64 Index buffer size 64 Sector size 128 Column order By Table Position Key padding NULLs Alignment Default Data padding NULLs Driver type Multi-User (non-server) In order for the FairCom driver to understand what is included in the ECLIPSE database, it needs a Script file. Your will find a script file in your MPN folder called vendor.db. Last but not least, modify the Data Dictionary Path to point to your MPN directory. You should now have a set up dialog that looks like this: GalacTek 2003 Page 6 Rev. 07-09-2003
Click on the "OK" button. You will be presented with the Sector Size Has Changed. If you already setup a Faircom ODBC source and made the mistake of not changing the Sector Size to 128, you will have to find the file CTSYSCAT.FCS file and delete it. The file may be located in your MPN folder or C:\FAIRCOM\. Initializing Eclipse Click on Start Run to open the Run dialog box. Type "c:\mpn\eclipse32.exe newdoda" in the Open text box and click on "OK", this starts the process. ECLIPSE will open and you will get a message box as each table is initialized. GalacTek 2003 Page 7 Rev. 07-09-2003
Lab - Opening an ODBC Connection (some screens will vary depending on your version of Microsoft Office) For this part, we will assume that your ODBC connection's DSN is "ECLIPSE" and that you want to access your connection through Microsoft Access. 1. Launch Microsoft Access and create a new database. For this example we will call our new database ECLIPSE. Once you have named your database click on Open 2. Once you have created your new blank database, your screen should look something like this: GalacTek 2003 Page 8 Rev. 07-09-2003
3. From the toolbar click on File, Get External Data, Link Tables: 4. You will be presented with a File Open Dialog box like this. In the Files of type: dropdown box scroll all the way to the bottom select ODBC Databases. Then click on Link. GalacTek 2003 Page 9 Rev. 07-09-2003
5. You should see the DSN of your ODBC Connection that we set up before. In our example it's ECLIPSE.dsn. Select ECLIPSE.dsn and click on "OK". 6. After you click on OK, this will open a dialog to select the Linked tables. Click on "Select All" and then "OK". 7. As Access loads the tables it checks for unique index fields in each table. It will ask you to select these fields for the "Appointment" table. Looking in our Database Schema document, we see that we should highlight PatientID, Data and Time. Do so and then click on "OK". GalacTek 2003 Page 10 Rev. 07-09-2003
8. You may get errors indicating that the Jet Database Engine could not find the tables "Appointment Archive" and "Bill Archive". Click the "OK" button to continue. If you have not yet used the archive function in ECLIPSE, then these tables do not yet exist. You will also be asked to select an identifier in the "Submitter1" and "Userlog1" table. Click "OK" to each of these dialogs to continue the connection. 9. You now see your database window showing your new ODBC linked tables. The database linked tables are now ready to be used. GalacTek 2003 Page 11 Rev. 07-09-2003