Technical Information



   Technical Information

This section of the manual is only for very curious technical people.


The program is written in PowerBuilder version 12.5, a programming environment from SAP. The database that the data is stored in is embedded Firebird version 2 (starting with DONATION version 3.00, released in late 2007). Some earlier versions of DONATION used earlier versions of PowerBuilder. Versions prior to version 3.00 used the Sybase SQL Anywhere or Adaptive Server Anywhere database.


If anyone is ambitious and wishes to access the data in the DONATION database directly, the definitions of the SQL tables in it are in the file TABLES.SQL in the program's main directory, which is usually C:\Program Files\Donation. There is a login that you can use for read-only access to all of the tables, which is user name "donation_reader", password "reader". There is an ODBC datasource set up on installation, called "DONATION_FB_READONLY", which , which already has this login defined in it.


Note: To use the DONATION_FB_READONLY datasource from other programs, you may first have to copy the three files icudt30.dll, icuin30.dll, and icuuc30.dll from the program's installation directory (normally C:\Program Files\Donation, or C:\Program Files (x86)\Donation on 64-bit computers) to the Windows System directory (generally C:\Windows\System32).


Also, if you have the Lite or Standalone versions of DONATION, you may not be able to access data through that datasource while DONATION is running at the same time. That should not be a problem if you have a Network version of DONATION.


Prior to version 3.30, the program itself used the ODBC datasource "DONATION_FB", with a different user name and password. From version 3.30 on, it works without using that ODBC datasource, though the datasource does still exist. We would prefer not to say what the user name and password for that datasource are, because we do not want you to be modifying data other than by using the program! That is very likely to cause errors. If you feel a need to know that user name and password, contact us and you can try to convince us that we should tell you. A better way to make custom changes to the data, with our assistance, is by using the Database ⇒ SQL Select menu option.


Versions of this program between 2.40 and 2.70 used the ODBC datasources "DONATION4_DWC" and "DONATION4_DWC_READONLY". Versions of this program between 2.30 and 2.37 used the ODBC datasources "DONATION3_DWC" and "DONATION3_DWC_READONLY". Versions of this program between 2.20 and 2.29 used the ODBC datasources "DONATION2_DWC" and "DONATION2_DWC_READONLY". Versions of this program prior to 2.20 used the ODBC datasources "DONATION_DWC" and "DONATION_DWC_READONLY". If you are sure you will not need to go back to the older versions of the program, you can go into Control Panel's ODBC Administrator and delete these older datasources from its System tab, if you are sure you know what you are doing. There is no need whatsoever to do this, however.


By the way, the reason we included "DWC" (the author Dan Cooperstock's initials) in the earlier ODBC datasource names was to make sure they wouldn't match any other ODBC datasources, in case you have a previous donation-tracking program installed on your computer that also uses ODBC.


Note for users of Multiple DONATION Databases


If you maintain multiple databases in DONATION for multiple organizations, via the Database Switch Databases menu option, and you want to use the DONATION_FB_READONLY ODBC datasource, please be aware that starting in version 3.30, it will always point to your main database, DONATION4.DB, unless you explicitly change it. (Previous versions of DONATION changed it as you switched databases, but that required running as an Administrator, which DONATION no longer does.) If you need to modify that datasource yourself, go to Windows Control Panel, then Administrative Tools, then "ODBC Data Sources (32-bit)" if that option is there, or otherwise "Data Sources (ODBC)", then switch to the System DSN tab, click on DONATION_FB_READONLY, and click Configure. You will be able to change the Database name there.


Unfortunately, there is a complication getting to the Data Sources (ODBC) tool to edit the data sources on some computers. If your computer has a 64-bit processor, and there was not an option for "ODBC Data Sources (32-bit)" in the Administrative Tools, you will not find DONATION_FB_READONLY by following those instructions above. Instead, use the Run option from the Windows Start menu, and run the following, without the quotes: "C:\windows\syswow64\odbcad32.exe". (In some versions of Windows, there is no Run option - enter that same command in the "Search programs and files" entry box in the Start menu.)