db2 2.5.6

data/.gitignore

@@ -0,0 +1 @@
+*.gem

data/CHANGES

@@ -0,0 +1,181 @@
+Change Log
+==============
+2011/02/07 (IBM_DB adapter 2.5.6, driver 2.5.6) :
+  - Fixed Bug #28622, #28881
+  - Decimal datatypes will now be returned as BigDecimal type from the driver
+  - Changes to rollback any active transaction in the connection destructor method if connection is not explicitly closed
+  - Changes to have a single gem file for ruby 1.8 and ruby 1.9
+2010/07/15 (IBM_DB adapter 2.5.5, driver 2.5.5) :
+  - Support for datatype Graphic and Vargraphic in driver and adapter [27965]
+  - Support for Bigint datatype in adapter.
+  - Fixed bug [28295] --> IBM_DB, Unicode Version, fails with encoding error against Informix Server
+
+2010/05/12 (IBM_DB adapter 2.5.0, driver 2.5.0) :
+  - Support for Unicode with Ruby 1.9 [Data from the IBM_DB driver is returned in UTF8 format]
+  - Fixed bug [27954] --> Fixed Truncation of char for bit data containing a Null Terminator
+  - Removed handling of NilClass type data in quote method. Super class will handle appropriately.
+
+2010/01/21 (IBM_DB adapter 2.0.0, driver 2.0.0) :
+  - Support for usage of parameterized SQL queries
+  - Exposed constant VERSION in the driver [Feature Request: #27231]
+
+2009/08/21 (IBM_DB adapter 1.5.0, driver 1.5.0) :
+  - non-block enhancement in the ruby driver made for Ruby version 1.9. [support request #25023]
+  - New API's getErrormsg and getErrorstate for retrieving error messages/state added
+  - Re-defined raising of exception from driver. [Bug #26544]
+  - Made adapter changes as per the new API's exposed in the driver for retrieving error messages
+  - API's conn_errormsg and stmt_errormsg is been deprecated.
+
+2009/07/28 (IBM_DB adapter 1.1.1, driver 1.1.0) :
+  - Fixed bug [26705] --> Fixed the problem of primary key value starting with 100
+  - Support for Activerecord-2.3.3
+    - Added method primary_key, which returns the primary key column name of the specified table
+    - Test suite updated
+
+2009/06/17 (IBM_DB adapter 1.1.0, driver 1.1.0) :
+  - Support for Activerecord's Query Cache Mechanism
+  - rename_column support for DB2 on LUW version 9.7, DB2 on zOS 9 and enhanced rename_column support for Informix Dynamic Server
+  - Support for parameterized timestamp datatype feature of DB2 on LUW Version 9.7
+  - Enhanced support for Bigint datatype along with support for Bigserial datatype (with client version 9.7 and above) of IDS
+  - Callback method handle_lobs enhanced by making it to use prepared statements completely
+  - Handling of exceptions during fetch operations enabled
+
+2009/03/24 (IBM_DB adapter 1.0.5, driver 1.0.5) :
+  - Support for Ruby-1.9.1
+  - Support for SQLRowcount in driver
+  - Support for Activerecord-2.3.2 [test suite updated]
+  - Fixed bug [24663] --> Fixed pre-mature clearing of the sql array in handle_lobs
+  - Fixed bug [23115] --> Fixed truncation of a nested query during update
+  - Fixed wrong setting of SQLID for schema on zOS 8 dataserver when schema is explicitly specified.
+  
+2009/03/06 (IBM_DB adapter 1.0.2, driver 1.0.1) :
+  - Support for specifying connection timeout in adapter
+  - Fixed Bug [23317] --> Fixed assumption of id as the primary key while updation/insertion of lob fields
+  - Fixed Bug [23389] --> Provided proper exception handling.
+  - Fixed the insertion of incorrect value for lob objects in case of has_and_belongs_to_many associations.
+  
+2008/12/18 (IBM_DB adapter 1.0.1, driver 1.0.1) :
+  - Support for datatype decfloat
+  - Changes in installation process. Now user should set IBM_DB_INCLUDE env variable instead of IBM_DB_DIR
+  - Support for specifying the Authentication type to be used during connection in adapter
+  - Corrected the ignorance of a connection, when the connection is successful with a warning
+  - ActiveRecord-2.2.2 test suite changes for IBM_DB
+2008/11/06 (IBM_DB adapter 1.0.0, driver 0.10.0):
+  - Support for short-hand migration syntax for datatype char and double in create_table
+  - Support for short-hand migration syntax for datatypes xml, char and double in change_table
+  - Support for secure connections using SSL (SECURITY=SSL) feature of DB2 in Adapter
+      Note: - This is supported from client version V9.5fp2 and onwards
+  - Support for altering the nullability constraint of a column.
+  - Added correct mapping for datatype :double for DB2 and Informix (double precision)
+  - Method support_ddl_transactions? overridden to return true. Feature of Rails2.2 
+      IBM Dataservers support transactional migrations.
+  - Change in the style of accessing driver methods 
+      Changed from scope resolution operator to dot operator
+      IBM_DB::connect '<db_name>','<username>','<pwd>' to IBM_DB.connect '<db_name>','<username>','<pwd>'
+  - Fixed Bug [#22430] --> Fixed limit ignorance for type character [char]    
+  - ActiveRecord-2.1.2 test suite changes for IBM_DB   
+               
+2008/09/01 (IBM_DB adapter 0.10.0, driver 0.10.0):
+  - Added Trusted Context support in Driver
+  - Made changes for the correct Mapping of Informix DataTypes to Ruby DataTypes
+  - ActiveRecord-2.1.0 test suite changes appropriate for DB2/IDS is been updated
+   
+2008/06/24 (IBM_DB adapter 0.9.5, driver 0.9.5):
+  - Fixed Bug [#19222] --> Fixed fixture insertion of LOB columns for DB2 
+  - Fixed Bug [#19970] --> Fixed Table schema dumper also dump views
+  - Fixed Bug [#20053] --> Fixed CLOB data with special chars contains null characters upon retrieval
+  - Fixed Bug [#20762] --> IBM_DB adapter with Rails 2.1 fails on rake db:migrate
+  - Cleaned up fix for Bug [#19223] and [#19224], indexes are now dumped as array without schema qualified name.
+  - Support for Rails-2.0.2
+  - Support for Rails-2.1.0 
+      Rails-2.1.0 contains changes that generates Non-standard SQL in 2 noticed cases which won't work with SQL compliant databases like DB2
+       a. Handling Nullable columns in Table creation. [http://rails.lighthouseapp.com/projects/8994-ruby-on-rails/tickets/398-non-standard-sql-generated-in-column-definition-for-nullable-columns-in-create-table-ddl-rails-2-1#ticket-398-2]
+       	     A workaround for this problem is provided from within ibm_db adapter.
+       b. Handling has_and_belongs_to_many association. [http://rails.lighthouseapp.com/projects/8994/tickets/394-patch-fixed-non-standard-sql-generated-by-preloading-has_and_belongs_to_many-associations]. 
+       	     It is not possible to provide a workaround for this from within the ibm_db adapter. 
+             To workaround this problem please patch ActiveRecord-2.1.0 with the patch available at [http://rails.lighthouseapp.com/attachments/26975/association_preloading.diff]
+  
+2008/04/28 (IBM_DB adapter 0.9.4, driver 0.9.4):
+  - Fixed bug [#19679]--> invalid values being returned for blank or null in fetch_assoc
+  - Fixed bug [#19223] and [#19224]--> handling of composite and unique indexes incorrect
+  - Support for the Rails2.0 type of migrations for columns of type xml [t.xml :xml_col1,:xml_col2]
+   
+2008/03/10 (IBM_DB adapter 0.9.3, driver 0.9.3):
+  - Resolved the issue of truncation of output when stored procedure was called
+  
+2007/11/30 (IBM_DB adapter 0.9.2, driver 0.9.1):
+  - Lifted index length limitation (18 chars) and fixed multiple index creation
+  - Fixed [#13294] limit/offset breaks subselect in db2 adapter
+  - Fixed error handling for metadata retrieval (tables, columns, indexes)
+
+2007/11/07 (IBM_DB adapter 0.9.1, driver 0.9.1):
+  - Fixed ibm_db driver VC80 runtime issue on Windows
+
+2007/09/28 (IBM_DB adapter 0.9.0, driver 0.9.0):
+  - Fixed ibm_db gem 0.8.5 incompatibility with DB2 CLI 9.1 FP3 and below
+
+2007/09/13 (IBM_DB adapter 0.8.5, driver 0.8.5):
+  - Fixed Ruby driver crash on Windows Vista [#13357]
+
+2007/07/05 (IBM_DB adapter 0.8.0, driver 0.7.0):
+  - Support for Informix Dynamic Server 11.10
+  - New driver method get_last_serial_value to retrieve last inserted serial
+    value for Informix Dynamic Server
+
+2007/06/19 (IBM_DB adapter 0.7.5, driver 0.6.0):
+  - Driver code (ibm_db.c) remains at the same level: 0.6.0 (no changes)
+  - Fixed client attributes initialization on connection setup [11264]
+  - Fixed rake db:schema:dump native data types limits incompatible with table create
+
+2007/06/01 (IBM_DB adapter 0.7.0, driver 0.6.0):
+  - Driver code (ibm_db.c) remains at the same level: 0.6.0 (no changes)
+  - Fixed remaining failure on {:null => true} option for XML data type [#10877]
+  - Fixed handling of {:id => false} option during table creation in DB2 for zOS
+  - Fixed handle_lobs failures in table creation for has_many/belongs_to [#10701]
+  - Fixe db2-i5-zOS.yaml content (removed inadvertent tab) [#11234]
+
+2007/05/10 (IBM_DB adapter 0.6.5, driver 0.6.0):
+  - Driver code (ibm_db.c) remains at the same level: 0.6.0 (no changes)
+  - Fixed regression for reconnect after being inactive (connection recycle)
+  - Fixed rake db:schema:load failures on boolean data type [#10683]
+  - Fixed XML default option (:null => true for XML data type) [#10754]
+  - Fixed DB2 for zOS version 9 handling of column changes for DEFAULT NULL
+
+2007/04/30 (0.6.0):
+  - Support for remote connections to DB2 Universal Database on z/OS version 9
+  - Support for result set pagination via ActiveRecord add_limit_offset! method 
+    for DB2 Universal Database on z/OS and i5/OS
+  - Defect fixes
+  - Improved documentation 
+
+2007/04/20 (0.4.6):
+  - Fixed XML columns creation default value (NOT NULL)
+  - Fixed border case for IS NULL in where clauses
+  - Improved documentation (connection attributes)
+
+2007/04/20 (0.4.5):
+  - Fixed reconnect problems: driver (IBM_DB::active) and adapter (active)
+  - Client connection attribute rename (app_user to replace user)
+  - Improved support for ROWID data type (DB2 for zOS version 8 and 9)
+
+2007/03/21 (0.4.0):
+  - Support added for remote connectivity to DB2 zOS version 8
+  - Support added for remote connectivity to DB2 i5 v5r3 and v5r4
+  - Improved migration support (added change_column method)
+  - Support for setting and retrieving values for client attributes (user, 
+    account, application, workstation)
+
+2006/10/31 (0.2.0):
+  - Significant performance improvements
+  - Improved stored procedure support at driver level
+  - Added support for Large Object data types (LOBs) greater than 32K (BLOB, CLOB, XML) in size
+  - Added XML data type support for native storage of XML documents
+  - Significant quality improvements, through many bug fixes in the driver and adapter
+  - Improved migration support (added add_column and remove_column methods)
+
+2006/06/07 (0.1.0):
+
+  - Fixed compatibility issue with other adapters
+  - If a schema is omitted in database.yml, the username is now used as default schema
+  - Introduced descriptive CLI error messages when a connection or an execute statement fails
+  - Introduced check against schema in method 'indexes'

data/LICENSE

@@ -0,0 +1,18 @@
+Copyright (c) 2006, 2007, 2008, 2009, 2010 IBM Corporation
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the "Software"),
+to deal in the Software without restriction, including without limitation
+the rights to use, copy, modify, merge, publish, distribute, sublicense, 
+and/or sell copies of the Software, and to permit persons to whom the Software
+is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included
+in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
+INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A 
+PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT 
+HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION 
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE 
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/MANIFEST

@@ -0,0 +1,14 @@
+CHANGES
+README
+LICENSE
+ext/extconf.rb
+ext/ibm_db.c
+ext/ruby_ibm_db.h
+lib/IBM_DB.rb
+lib/linux32/ibm_db.so
+lib/mswin32/ibm_db.so
+lib/active_record/connection_adapters/ibm_db_adapter.rb
+lib/active_record/vendor/db2-i5-zOS.yaml
+test/activerecord/native_ibm_db/connection.rb
+test/ibm_db_test.rb
+MANIFEST

data/ParameterizedQueries README

@@ -0,0 +1,39 @@
++-------------------------------------------+-------------------------------------------+
+| README for Parameterized Queries Support in Ruby-on-Rails/ Activerecord applications  |
++-------------------------------------------+-------------------------------------------+
+
+Enabling Usage of Parameterized Queries with Ruby-on-Rails / Activerecord applications
+======================================================================================
+	To enable usage of parameterized SQL queries with Ruby-on-Rails/ActiveRecord applications, in your connection configuration (database.yml), set "parameterized" to true. By default "parameterized" is false (if not specified). A sample database.yml file showing development section with parameterized queries enabled looks as below
+
+development:
+  adapter:     ibm_db
+  username:    db2inst1
+  password:    secret
+  database:    devdb
+  #schema:      db2inst1
+  #host:        localhost
+  #port:        50000
+  #account:     my_account
+  #app_user:    my_app_user
+  #application: my_application
+  #workstation: my_workstation
+  parameterized: true
+
+Similarly for the other sections (test/production) of the database.yml file set "parameterized" to true to enable usage of parameterized SQL queries
+
+Supported Activerecord Versions
+===============================
+  Activerecord-2.3.3, Activerecord-2.3.4, Activerecord-2.3.5
+  
+Supported Operating Systems and Databases
+=========================================
+Refer the main README
+
+Feedback
+========
+  Your feedback is very much appreciated and expected through Rubyforge:
+   - rubyibm project:     http://rubyforge.org/projects/rubyibm/
+   - rubyibm forum:       http://rubyforge.org/forum/?group_id=2361
+   - rubyibm bug reports: http://rubyforge.org/tracker/?group_id=2361
+   - IBM_DB developers:   rubyibm-developers@rubyforge.org

data/README

@@ -0,0 +1,282 @@
+=====================================================================
+README for the IBM_DB Adapter (2.5.5) and Driver (2.5.5) (2011/02/07)
+For ActiveRecord Version >= 1.15.5 (and Rails >= 1.2.5)
+=====================================================================
+
+Supported Operating Systems 
+============================
+  - Linux 32/64 bit
+  - Microsoft Windows 32 bit
+  - IBM AIX 32/64 bit
+  - HP-UX 32/64 bit
+  - Sun Solaris 32/64 bit
+
+
+Supported Databases
+====================
+  - IBM DB2 Universal Database on Linux/Unix/Windows versions 8 Fixpak15 or 9 Fixpak2 and above
+  - Remote connections to IBM DB2 Universal Database on i5/OS versions V5R3 and V5R4. 
+    Please ensure PTF SI27358 (includes SI27250) is installed in i5/OS version 5R3 and
+    and PTF SI27256 is installed while using i5/OS version 5R4.
+  - Remote connections to IBM DB2 Universal Database on z/OS version 8 and 9
+  - Informix Dynamic Server 11.10 and beyond.
+    Please ensure that the IBM DataServer Viper 2 client is installed.
+
+
+Installing the IBM_DB adapter and driver as a Ruby gem
+=======================================================
+The IBM_DB gem is an ActiveRecord adapter. Installing the IBM_DB adapter and driver as a gem enables any application in the
+Ruby environment, including Rails, to interact with IBM data servers.
+
+Note : -	1)	If using activerecord version below 2.0 then it requires that the ibm_db adapter be registered with the list of connection adapters by manually adding ibm_db at line 77 (approx) in the file activerecord.rb (GEM_HOME\activerecord-<version>\lib\). 
+
+		    2)	The IBM_DB driver can also be built separately (from source) and used in direct API calls.
+
+1. Windows platforms:
+=====================
+  INSTALL (as Ruby gem)
+   To remove previous gem version (optionally):
+    D:\>gem uninstall ibm_db
+    Successfully uninstalled ibm_db version 0.6.0
+
+  Example:
+    D:\>gem install ibm_db
+    Bulk updating gem source index for: http://gems.rubyforge.org
+    Select which gem to install for your platform (i386-mswin32)
+    1. ibm_db 1.0.0 (mswin32)
+    2. ibm_db 1.0.0 (ruby)
+    3. ibm_db 0.10.0 (mswin32)
+    4. ibm_db 0.10.0 (ruby)
+
+  Running gem install ibm_db you are presented with two choices for each release 
+  (mswin32 or ruby)choose mswin32. This will install the IBM_DB gem containing 
+  the pre-built binary file of the driver which is a C-extension of Ruby.
+
+  TEST (simple gem install verification)
+   Note: The manual step after install if using activerecord version below 2.0:
+         add ibm_db into GEM_HOME\1.8\gems\activerecord-1.15.3\lib\active_record.rb (Line 77)
+   D:\rails NewApp
+   D:\cd NewApp      
+   D:\NewApp>irb
+     irb(main):001:0> gem 'ibm_db'
+     irb(main):002:0> require 'mswin32/ibm_db'   // notice the [mswin32] in the library path
+     irb(main):003:0> IBM_DB.connect 'sample', 'db2admin', 'secret'
+   D:\NewApp>ruby script\console
+
+
+2. Linux and Unix platforms:
+============================
+
+  INSTALL (as Ruby gem)
+    To remove previous gem version (optionally):
+    $ gem uninstall ibm_db
+    Successfully uninstalled ibm_db version 0.6.0
+
+   Note: DB2 environment is required while using an arbitrary user account
+         (other than the DB2 install user account)
+   $ . /home/db2inst1/sqllib/db2profile
+   $ export IBM_DB_INCLUDE=DB2HOME/include (eg. /home/db2inst1/sqllib/include or /opt/ibm/db2/v9.5/include)
+   $ export IBM_DB_LIB=DB2HOME/lib     (eg. /home/db2inst1/sqllib/lib or /opt/ibm/db2/V9.5/lib32)
+   $ gem install ibm_db
+     Select which gem to install for your platform (i686-linux)
+     1. ibm_db 1.0.0 (mswin32)
+     2. ibm_db 1.0.0 (ruby)
+     3. ibm_db 0.10.0 (ruby)
+     4. ibm_db 0.10.0 (mswin32)
+     ...
+     Running gem install ibm_db you are presented with two choices for each release
+     (mswin32 or ruby) choose ruby. This will build the native extension (ibm_db driver) and installs the ibm_db gem.
+     ...
+     > 2
+     Building native extensions.  This could take a while...
+     Successfully installed ibm_db-0.6.5
+     Installing ri documentation for ibm_db-0.6.5...
+     Installing RDoc documentation for ibm_db-0.6.5...
+     
+  TEST (simple gem install verification)
+   Note: The manual step after install, if using activerecord version below 2.0 is:
+         add ibm_db into GEM_HOME\1.8\gems\activerecord-1.15.3\lib\active_record.rb (Line 77)
+   $ irb
+     irb(main):001:0> gem 'ibm_db'
+     irb(main):002:0> require 'ibm_db'    // notice the library path (different on win32, use require 'mswin32/ibm_db')
+     irb(main):003:0> IBM_DB.connect 'sample', 'db2admin', 'secret'
+   $ 
+
+  BUILD (optionally) ibm_db gem  from sources (ibm_db-x.x.x.tar.gz):
+  1. Download source from Rubyforge
+     http://rubyforge.org/frs/?group_id=2361
+  2. Build gem from specification (IBM_DB.gemspec)
+     $ cd IBM_DB_Adapter/ibm_db
+     $ gem build IBM_DB.gemspec
+
+
+Instructions for building and installing the IBM_DB driver from source
+=======================================================================
+Building the driver manually as described below is not required if the install
+process above has been pursued. This manual procedure is in fact automated
+on Linux and UNIX platforms by the IBM_DB gem install, but is presented
+here only for reference, and also involves running the unit tests.
+
+ Prerequisites:
+  Install Ruby from:
+    http://rubyforge.org
+
+  Linux and Unix platforms:
+   Note: commands may vary depending on the shell used
+    - To setup DB2 environment while using an arbitrary user account
+      (other than the DB2 install user account):
+      Example:
+        $ . /home/db2inst1/sqllib/db2profile
+
+    - To configure test database:
+      DB2 v9.x: some IBM_DB driver tests require a UTF-8 database:
+        $ db2 CREATE DATABASE testdrv USING CODESET UTF-8 \
+          TERRITORY US COLLATE USING SYSTEM PAGESIZE 32768 
+      DB2 v8.x: driver tests 195 and 52949 requires XML functionality
+      only available in DB2 v9.x
+
+    - To configure database connection parameters edit config.yaml
+      Example:
+        database: testdrv 
+        user:     db2inst1
+        password: password
+        hostname: localhost
+        port:     50000
+
+    - To compile and link with DB2 client libraries:
+       $ export IBM_DB_INCLUDE=DB2HOME/include (eg. /home/db2inst1/sqllib/include or /opt/ibm/db2/v9.5/include)
+       $ export IBM_DB_LIB=DB2HOME/lib     (eg. /home/db2inst1/sqllib/lib or /opt/ibm/db2/V9.5/lib32)
+
+  Windows platforms:
+    - Install Visual C++ 2005, Platform SDK (latest), .Net SDK (latest)
+    - Set environment:
+      CALL "C:\Program Files\Microsoft Platform SDK for Windows Server 2005\SetEnv.Cmd"
+      CALL "C:\Program Files\Microsoft Visual C++ Toolkit 2005\vcvars32.bat"
+      SET LIB=%LIB%;C:\Program Files\Microsoft Visual Studio .NET 2005\Vc8\lib
+    - To configure database connection parameters edit config.yml
+  
+ Build and Execution:
+  rake 
+
+ Execution of tests without compilation (must have .so in ibm_db source directory):
+  rake onlytests
+
+ Execution of a single test inside the tests directory can be done by the following:
+  export SINGLE_RUBY_TEST=test_001_CtlgConn.rb
+  rake 
+
+
+Limitations and known problems
+==============================
+ - ActiveRecord rename_column method is not supported for DB2 LUW, zOS and i5
+ - ActiveRecord remove_column method is not supported for DB2 zOS
+ - The following tests from the ActiveRecord 1.15.3 test suite with ibm_db gem < 0.9.5 are expected to fail
+    - test_limited_eager_with_multiple_order_columns
+    - test_limited_eager_with_order
+    - test_assign_ids_ignoring_blanks
+    - test_build_by_new_record
+    - test_get_ids
+    - test_select_limited_ids_list
+    - test_add_index
+ - The following tests from the driver test suite are expected to fail on DB2 version 8
+   on Linux/Unix/Windows and Informix Dynamic Server because of missing native XML support. If you want to
+   make use of the native XML features in DB2, please upgrade to version 9 or later
+    - test_195.rb
+    - test_52949.rb
+ - The driver returns an error when you try to insert a TIMESTAMP value into a DATE column. 
+   To fix this, please ensure that the following configuration keyword PATCH2=58 is set 
+   in the COMMON section of your DB2 CLI initialization file (db2cli.ini):
+    - set: db2 UPDATE CLI CFG FOR SECTION COMMON USING PATCH2 58
+    - verify: db2 GET CLI CFG FOR SECTION COMMON
+   Please refer to http://publib.boulder.ibm.com/infocenter/db2luw/v9/topic/com.ibm.db2.udb.apdv.cli.doc/doc/c0007882.htm
+   for more information.
+ - The behaviour of ActiveRecord::Base.find(:first) without an :order attribute can be unpredictable.
+   The first record (i.e. the record with the minimum id) may be not be retrieved. In a relational model,
+   the order of the rows returned is unpredictable and independent of the order of insertion.
+   This issue may be addressed in a future release. 
+ - Rails applications on DB2 9 require the APPLHEAPSZ database configuration parameter to be
+   set to or above 1024. You will need to set this parameter for each database for which you will be
+   running DB2 on Rails applications. Following is the command syntax for updating the
+   applheapsz parameter:
+     > db2 update db cfg for <database_name> using APPLHEAPSZ 1024
+   To enable this parameter, you need to restart your DB2 instance.
+ - If you see connectivity issues with Informix Dynamic Server, please ensure that the server is configured to accept DRDA connections.
+   Please refer to http://publib.boulder.ibm.com/infocenter/idshelp/v111/index.jsp?topic=/com.ibm.admin.doc/admin154.htm for more information.
+ - The following tests from the ActiveRecord 1.15.3 test suite with ibm_db gem < 0.9.5 are expected to fail on Informix Dynamic Server
+    - test_quote
+    - test_to_xml
+    - test_should_calculate_grouped_by_function
+    - test_should_calculate_grouped_by_function_with_table_alias
+    - test_inserts_with_pre_and_suffix
+    - test_add_table_with_decimals
+    - test_no_limits_datatypes_IBM_DB
+    - test_instance_update_should_quote_pkey
+    - test_integer_columns
+    - test_arguments_line_up
+    - test_no_dump_errors
+    - test_schema_dump_includes_decimal_options
+ - IBM_DB is not supported on JRuby. As stated in the JRuby Wiki, "Basics of Getting JRuby Running":
+   'You may install other gems, but keep in mind that libraries with C extension dependencies 
+   will not work in JRuby.' http://www.headius.com/jrubywiki/index.php/Getting_Started
+   The IBM_DB adapter relies on IBM_DB driver (C extension) and the IBM Driver for ODBC and
+   CLI to access databases on IBM data servers. Alternatively, you can either use the regular C
+   implementation of Ruby, or use ActiveRecord-JDBC adapter to access databases.
+ - Query caching feature of ActiveRecord-2.0 not supported 
+ - When using ActiveRecord-2.1.0 it requires that ActiveRecord be patched, with the patch in the link below:
+ 		http://rails.lighthouseapp.com/attachments/26975/association_preloading.diff
+ 	The patch is required because, ActiveRecord 2.1.0 generates a non-standard SQL identifier,while preloading has_and_belongs_to_many associations,
+ 	which standard compliant databases like DB2 do not support. The bug report, against ActiveRecord, can be found in the link below
+ 		http://rails.lighthouseapp.com/projects/8994/tickets/394-patch-fixed-non-standard-sql-generated-by-preloading-has_and_belongs_to_many-associations
+ - ActiveRecord-2.1.0 test suite changes appropriate for DB2/IDS will be updated in the next release of the gem.(Updated in release 0.10.0)
+ - The following tests from the ActiveRecord 2.1.0 test suite with ibm_db gem 0.10.0 are expected to fail on DB2 LUW
+ 	- test_read_attributes_before_type_cast_on_datetime
+ 	- test_to_xml
+ 	- test_native_types
+ 	- test_counting
+ 	- test_counting_with_column_name_and_hash
+ 	- test_counting_with_empty_hash_conditions
+ 	- test_counting_with_single_conditions
+ 	- test_counting_with_single_hash
+ 	Note :- 1)	The test cases from HasManyAssociations (4-8) above are found failing only when run as part of
+ 			the complete suite. However they pass when run standalone.
+ 		2)	Also there are two test cases (test_validate_uniqueness_with_non_standard_table_names, test_update_all_with_non_standard_table_name)which run against table with non-standard name. Given that DB2/IDS is standard compliant these test cases are expected to fail.
+ 			To have these test cases passing rename the fixtures file warehouse-things to warehouse_things.
+ - The following tests from the ActiveRecord 2.1.0 test suite with ibm_db gem 0.10.0 are expected to fail on Informix Dynamic Server
+ 	- test_attributes_on_dummy_time
+ 	- test_quote
+ 	- test_read_attributes_before_type_cast_on_datetime
+ 	- test_save_for_record_with_only_primary_key
+ 	- test_save_for_record_with_only_primary_key_that_is_provided
+ 	- test_to_xml
+ 	- test_utc_as_time_zone
+ 	- test_should_calculate_grouped_by_function
+ 	- test_should_calculate_grouped_by_function_with_table_alias
+ 	- test_include_query
+ 	- test_binary_in_fixtures
+ 	- test_inserts_with_pre_and_suffix
+ 	- test_create
+ 	- test_add_column_with_precision_and_scale
+ 	- test_add_table_with_decimals
+ 	- test_native_types
+ 	- test_schema_dump_includes_decimal_options
+ - Usage with Rails-3.0.3/Rails-3.0.4
+	- To use with Rails-3.0.3/4 patch latest Arel with the patch available at https://gist.github.com/814491
+	
+Unicode Support
+===============
+  - Available only with Ruby version 1.9 and above
+  - Data returned from the driver will be in UTF8 encoding format.
+  - The input data to the driver can be in any Ruby supported encoding format.
+
+To Do
+====
+ - Support ActiveRecord remove_column method for DB2 zOS version 9
+
+
+Feedback
+========
+  Your feedback is very much appreciated and expected through Rubyforge:
+   - rubyibm project:     http://rubyforge.org/projects/rubyibm/
+   - rubyibm forum:       http://rubyforge.org/forum/?group_id=2361
+   - rubyibm bug reports: http://rubyforge.org/tracker/?group_id=2361
+   - IBM_DB developers:   rubyibm-developers@rubyforge.org