ibm_db 1.1.1-mswin32

Sign up to get free protection for your applications and to get access to all the features.
Files changed (36) hide show
  1. data/CHANGES +155 -0
  2. data/LICENSE +18 -0
  3. data/MANIFEST +14 -0
  4. data/README +274 -0
  5. data/ext/Makefile.nt32 +181 -0
  6. data/ext/extconf.rb +58 -0
  7. data/ext/ibm_db.c +6553 -0
  8. data/ext/ruby_ibm_db.h +214 -0
  9. data/init.rb +42 -0
  10. data/lib/IBM_DB.rb +2 -0
  11. data/lib/active_record/connection_adapters/ibm_db_adapter.rb +2218 -0
  12. data/lib/active_record/vendor/db2-i5-zOS.yaml +328 -0
  13. data/lib/mswin32/ibm_db.so +0 -0
  14. data/test/cases/adapter_test.rb +180 -0
  15. data/test/cases/associations/cascaded_eager_loading_test.rb +133 -0
  16. data/test/cases/associations/eager_test.rb +842 -0
  17. data/test/cases/associations/has_and_belongs_to_many_associations_test.rb +874 -0
  18. data/test/cases/associations/has_many_through_associations_test.rb +281 -0
  19. data/test/cases/associations/join_model_test.rb +801 -0
  20. data/test/cases/attribute_methods_test.rb +312 -0
  21. data/test/cases/base_test.rb +2114 -0
  22. data/test/cases/calculations_test.rb +346 -0
  23. data/test/cases/finder_test.rb +1092 -0
  24. data/test/cases/fixtures_test.rb +660 -0
  25. data/test/cases/migration_test.rb +1618 -0
  26. data/test/cases/schema_dumper_test.rb +197 -0
  27. data/test/cases/validations_test.rb +1604 -0
  28. data/test/connections/native_ibm_db/connection.rb +40 -0
  29. data/test/ibm_db_test.rb +25 -0
  30. data/test/models/warehouse_thing.rb +5 -0
  31. data/test/schema/i5/ibm_db_specific_schema.rb +134 -0
  32. data/test/schema/ids/ibm_db_specific_schema.rb +137 -0
  33. data/test/schema/luw/ibm_db_specific_schema.rb +134 -0
  34. data/test/schema/schema.rb +499 -0
  35. data/test/schema/zOS/ibm_db_specific_schema.rb +205 -0
  36. metadata +115 -0
data/CHANGES ADDED
@@ -0,0 +1,155 @@
1
+ Change Log
2
+ ==============
3
+ 2009/07/28 (IBM_DB adapter 1.1.1, driver 1.1.0) :
4
+ - Fixed bug [26705] --> Fixed the problem of primary key value starting with 100
5
+ - Support for Activerecord-2.3.3
6
+ - Added method primary_key, which returns the primary key column name of the specified table
7
+ - Test suite updated
8
+
9
+ 2009/06/17 (IBM_DB adapter 1.1.0, driver 1.1.0) :
10
+ - Support for Activerecord's Query Cache Mechanism
11
+ - rename_column support for DB2 on LUW version 9.7, DB2 on zOS 9 and enhanced rename_column support for Informix Dynamic Server
12
+ - Support for parameterized timestamp datatype feature of DB2 on LUW Version 9.7
13
+ - Enhanced support for Bigint datatype along with support for Bigserial datatype (with client version 9.7 and above) of IDS
14
+ - Callback method handle_lobs enhanced by making it to use prepared statements completely
15
+ - Handling of exceptions during fetch operations enabled
16
+
17
+ 2009/03/24 (IBM_DB adapter 1.0.5, driver 1.0.5) :
18
+ - Support for Ruby-1.9.1
19
+ - Support for SQLRowcount in driver
20
+ - Support for Activerecord-2.3.2 [test suite updated]
21
+ - Fixed bug [24663] --> Fixed pre-mature clearing of the sql array in handle_lobs
22
+ - Fixed bug [23115] --> Fixed truncation of a nested query during update
23
+ - Fixed wrong setting of SQLID for schema on zOS 8 dataserver when schema is explicitly specified.
24
+
25
+ 2009/03/06 (IBM_DB adapter 1.0.2, driver 1.0.1) :
26
+ - Support for specifying connection timeout in adapter
27
+ - Fixed Bug [23317] --> Fixed assumption of id as the primary key while updation/insertion of lob fields
28
+ - Fixed Bug [23389] --> Provided proper exception handling.
29
+ - Fixed the insertion of incorrect value for lob objects in case of has_and_belongs_to_many associations.
30
+
31
+ 2008/12/18 (IBM_DB adapter 1.0.1, driver 1.0.1) :
32
+ - Support for datatype decfloat
33
+ - Changes in installation process. Now user should set IBM_DB_INCLUDE env variable instead of IBM_DB_DIR
34
+ - Support for specifying the Authentication type to be used during connection in adapter
35
+ - Corrected the ignorance of a connection, when the connection is successful with a warning
36
+ - ActiveRecord-2.2.2 test suite changes for IBM_DB
37
+ 2008/11/06 (IBM_DB adapter 1.0.0, driver 0.10.0):
38
+ - Support for short-hand migration syntax for datatype char and double in create_table
39
+ - Support for short-hand migration syntax for datatypes xml, char and double in change_table
40
+ - Support for secure connections using SSL (SECURITY=SSL) feature of DB2 in Adapter
41
+ Note: - This is supported from client version V9.5fp2 and onwards
42
+ - Support for altering the nullability constraint of a column.
43
+ - Added correct mapping for datatype :double for DB2 and Informix (double precision)
44
+ - Method support_ddl_transactions? overridden to return true. Feature of Rails2.2
45
+ IBM Dataservers support transactional migrations.
46
+ - Change in the style of accessing driver methods
47
+ Changed from scope resolution operator to dot operator
48
+ IBM_DB::connect '<db_name>','<username>','<pwd>' to IBM_DB.connect '<db_name>','<username>','<pwd>'
49
+ - Fixed Bug [#22430] --> Fixed limit ignorance for type character [char]
50
+ - ActiveRecord-2.1.2 test suite changes for IBM_DB
51
+
52
+ 2008/09/01 (IBM_DB adapter 0.10.0, driver 0.10.0):
53
+ - Added Trusted Context support in Driver
54
+ - Made changes for the correct Mapping of Informix DataTypes to Ruby DataTypes
55
+ - ActiveRecord-2.1.0 test suite changes appropriate for DB2/IDS is been updated
56
+
57
+ 2008/06/24 (IBM_DB adapter 0.9.5, driver 0.9.5):
58
+ - Fixed Bug [#19222] --> Fixed fixture insertion of LOB columns for DB2
59
+ - Fixed Bug [#19970] --> Fixed Table schema dumper also dump views
60
+ - Fixed Bug [#20053] --> Fixed CLOB data with special chars contains null characters upon retrieval
61
+ - Fixed Bug [#20762] --> IBM_DB adapter with Rails 2.1 fails on rake db:migrate
62
+ - Cleaned up fix for Bug [#19223] and [#19224], indexes are now dumped as array without schema qualified name.
63
+ - Support for Rails-2.0.2
64
+ - Support for Rails-2.1.0
65
+ 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
66
+ 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]
67
+ A workaround for this problem is provided from within ibm_db adapter.
68
+ 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].
69
+ It is not possible to provide a workaround for this from within the ibm_db adapter.
70
+ To workaround this problem please patch ActiveRecord-2.1.0 with the patch available at [http://rails.lighthouseapp.com/attachments/26975/association_preloading.diff]
71
+
72
+ 2008/04/28 (IBM_DB adapter 0.9.4, driver 0.9.4):
73
+ - Fixed bug [#19679]--> invalid values being returned for blank or null in fetch_assoc
74
+ - Fixed bug [#19223] and [#19224]--> handling of composite and unique indexes incorrect
75
+ - Support for the Rails2.0 type of migrations for columns of type xml [t.xml :xml_col1,:xml_col2]
76
+
77
+ 2008/03/10 (IBM_DB adapter 0.9.3, driver 0.9.3):
78
+ - Resolved the issue of truncation of output when stored procedure was called
79
+
80
+ 2007/11/30 (IBM_DB adapter 0.9.2, driver 0.9.1):
81
+ - Lifted index length limitation (18 chars) and fixed multiple index creation
82
+ - Fixed [#13294] limit/offset breaks subselect in db2 adapter
83
+ - Fixed error handling for metadata retrieval (tables, columns, indexes)
84
+
85
+ 2007/11/07 (IBM_DB adapter 0.9.1, driver 0.9.1):
86
+ - Fixed ibm_db driver VC80 runtime issue on Windows
87
+
88
+ 2007/09/28 (IBM_DB adapter 0.9.0, driver 0.9.0):
89
+ - Fixed ibm_db gem 0.8.5 incompatibility with DB2 CLI 9.1 FP3 and below
90
+
91
+ 2007/09/13 (IBM_DB adapter 0.8.5, driver 0.8.5):
92
+ - Fixed Ruby driver crash on Windows Vista [#13357]
93
+
94
+ 2007/07/05 (IBM_DB adapter 0.8.0, driver 0.7.0):
95
+ - Support for Informix Dynamic Server 11.10
96
+ - New driver method get_last_serial_value to retrieve last inserted serial
97
+ value for Informix Dynamic Server
98
+
99
+ 2007/06/19 (IBM_DB adapter 0.7.5, driver 0.6.0):
100
+ - Driver code (ibm_db.c) remains at the same level: 0.6.0 (no changes)
101
+ - Fixed client attributes initialization on connection setup [11264]
102
+ - Fixed rake db:schema:dump native data types limits incompatible with table create
103
+
104
+ 2007/06/01 (IBM_DB adapter 0.7.0, driver 0.6.0):
105
+ - Driver code (ibm_db.c) remains at the same level: 0.6.0 (no changes)
106
+ - Fixed remaining failure on {:null => true} option for XML data type [#10877]
107
+ - Fixed handling of {:id => false} option during table creation in DB2 for zOS
108
+ - Fixed handle_lobs failures in table creation for has_many/belongs_to [#10701]
109
+ - Fixe db2-i5-zOS.yaml content (removed inadvertent tab) [#11234]
110
+
111
+ 2007/05/10 (IBM_DB adapter 0.6.5, driver 0.6.0):
112
+ - Driver code (ibm_db.c) remains at the same level: 0.6.0 (no changes)
113
+ - Fixed regression for reconnect after being inactive (connection recycle)
114
+ - Fixed rake db:schema:load failures on boolean data type [#10683]
115
+ - Fixed XML default option (:null => true for XML data type) [#10754]
116
+ - Fixed DB2 for zOS version 9 handling of column changes for DEFAULT NULL
117
+
118
+ 2007/04/30 (0.6.0):
119
+ - Support for remote connections to DB2 Universal Database on z/OS version 9
120
+ - Support for result set pagination via ActiveRecord add_limit_offset! method
121
+ for DB2 Universal Database on z/OS and i5/OS
122
+ - Defect fixes
123
+ - Improved documentation
124
+
125
+ 2007/04/20 (0.4.6):
126
+ - Fixed XML columns creation default value (NOT NULL)
127
+ - Fixed border case for IS NULL in where clauses
128
+ - Improved documentation (connection attributes)
129
+
130
+ 2007/04/20 (0.4.5):
131
+ - Fixed reconnect problems: driver (IBM_DB::active) and adapter (active)
132
+ - Client connection attribute rename (app_user to replace user)
133
+ - Improved support for ROWID data type (DB2 for zOS version 8 and 9)
134
+
135
+ 2007/03/21 (0.4.0):
136
+ - Support added for remote connectivity to DB2 zOS version 8
137
+ - Support added for remote connectivity to DB2 i5 v5r3 and v5r4
138
+ - Improved migration support (added change_column method)
139
+ - Support for setting and retrieving values for client attributes (user,
140
+ account, application, workstation)
141
+
142
+ 2006/10/31 (0.2.0):
143
+ - Significant performance improvements
144
+ - Improved stored procedure support at driver level
145
+ - Added support for Large Object data types (LOBs) greater than 32K (BLOB, CLOB, XML) in size
146
+ - Added XML data type support for native storage of XML documents
147
+ - Significant quality improvements, through many bug fixes in the driver and adapter
148
+ - Improved migration support (added add_column and remove_column methods)
149
+
150
+ 2006/06/07 (0.1.0):
151
+
152
+ - Fixed compatibility issue with other adapters
153
+ - If a schema is omitted in database.yml, the username is now used as default schema
154
+ - Introduced descriptive CLI error messages when a connection or an execute statement fails
155
+ - Introduced check against schema in method 'indexes'
data/LICENSE ADDED
@@ -0,0 +1,18 @@
1
+ Copyright (c) 2006, 2007, 2008, 2009 IBM Corporation
2
+
3
+ Permission is hereby granted, free of charge, to any person obtaining
4
+ a copy of this software and associated documentation files (the "Software"),
5
+ to deal in the Software without restriction, including without limitation
6
+ the rights to use, copy, modify, merge, publish, distribute, sublicense,
7
+ and/or sell copies of the Software, and to permit persons to whom the Software
8
+ is furnished to do so, subject to the following conditions:
9
+
10
+ The above copyright notice and this permission notice shall be included
11
+ in all copies or substantial portions of the Software.
12
+
13
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
14
+ INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
15
+ PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
16
+ HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
17
+ OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
18
+ SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
data/MANIFEST ADDED
@@ -0,0 +1,14 @@
1
+ CHANGES
2
+ README
3
+ LICENSE
4
+ ext/extconf.rb
5
+ ext/ibm_db.c
6
+ ext/ruby_ibm_db.h
7
+ lib/IBM_DB.rb
8
+ lib/linux32/ibm_db.so
9
+ lib/mswin32/ibm_db.so
10
+ lib/active_record/connection_adapters/ibm_db_adapter.rb
11
+ lib/active_record/vendor/db2-i5-zOS.yaml
12
+ test/activerecord/native_ibm_db/connection.rb
13
+ test/ibm_db_test.rb
14
+ MANIFEST
data/README ADDED
@@ -0,0 +1,274 @@
1
+ =====================================================================
2
+ README for the IBM_DB Adapter (1.1.0) and Driver (1.1.0) (2009/06/17)
3
+ For ActiveRecord Version >= 1.15.5 (and Rails >= 1.2.5)
4
+ =====================================================================
5
+
6
+ Supported Operating Systems
7
+ ============================
8
+ - Linux 32/64 bit
9
+ - Microsoft Windows 32 bit
10
+ - IBM AIX 32/64 bit
11
+ - HP-UX 32/64 bit
12
+ - Sun Solaris 32/64 bit
13
+
14
+
15
+ Supported Databases
16
+ ====================
17
+ - IBM DB2 Universal Database on Linux/Unix/Windows versions 8 Fixpak15 or 9 Fixpak2 and above
18
+ - Remote connections to IBM DB2 Universal Database on i5/OS versions V5R3 and V5R4.
19
+ Please ensure PTF SI27358 (includes SI27250) is installed in i5/OS version 5R3 and
20
+ and PTF SI27256 is installed while using i5/OS version 5R4.
21
+ - Remote connections to IBM DB2 Universal Database on z/OS version 8 and 9
22
+ - Informix Dynamic Server 11.10 and beyond.
23
+ Please ensure that the IBM DataServer Viper 2 client is installed.
24
+
25
+
26
+ Installing the IBM_DB adapter and driver as a Ruby gem
27
+ =======================================================
28
+ The IBM_DB gem is an ActiveRecord adapter. Installing the IBM_DB adapter and driver as a gem enables any application in the
29
+ Ruby environment, including Rails, to interact with IBM data servers.
30
+
31
+ 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\).
32
+
33
+ 2) The IBM_DB driver can also be built separately (from source) and used in direct API calls.
34
+
35
+ 1. Windows platforms:
36
+ =====================
37
+ INSTALL (as Ruby gem)
38
+ To remove previous gem version (optionally):
39
+ D:\>gem uninstall ibm_db
40
+ Successfully uninstalled ibm_db version 0.6.0
41
+
42
+ Example:
43
+ D:\>gem install ibm_db
44
+ Bulk updating gem source index for: http://gems.rubyforge.org
45
+ Select which gem to install for your platform (i386-mswin32)
46
+ 1. ibm_db 1.0.0 (mswin32)
47
+ 2. ibm_db 1.0.0 (ruby)
48
+ 3. ibm_db 0.10.0 (mswin32)
49
+ 4. ibm_db 0.10.0 (ruby)
50
+
51
+ Running gem install ibm_db you are presented with two choices for each release
52
+ (mswin32 or ruby)choose mswin32. This will install the IBM_DB gem containing
53
+ the pre-built binary file of the driver which is a C-extension of Ruby.
54
+
55
+ TEST (simple gem install verification)
56
+ Note: The manual step after install if using activerecord version below 2.0:
57
+ add ibm_db into GEM_HOME\1.8\gems\activerecord-1.15.3\lib\active_record.rb (Line 77)
58
+ D:\rails NewApp
59
+ D:\cd NewApp
60
+ D:\NewApp>irb
61
+ irb(main):001:0> gem 'ibm_db'
62
+ irb(main):002:0> require 'mswin32/ibm_db' // notice the [mswin32] in the library path
63
+ irb(main):003:0> IBM_DB.connect 'sample', 'db2admin', 'secret'
64
+ D:\NewApp>ruby script\console
65
+
66
+
67
+ 2. Linux and Unix platforms:
68
+ ============================
69
+
70
+ INSTALL (as Ruby gem)
71
+ To remove previous gem version (optionally):
72
+ $ gem uninstall ibm_db
73
+ Successfully uninstalled ibm_db version 0.6.0
74
+
75
+ Note: DB2 environment is required while using an arbitrary user account
76
+ (other than the DB2 install user account)
77
+ $ . /home/db2inst1/sqllib/db2profile
78
+ $ export IBM_DB_INCLUDE=DB2HOME/include (eg. /home/db2inst1/sqllib/include or /opt/ibm/db2/v9.5/include)
79
+ $ export IBM_DB_LIB=DB2HOME/lib (eg. /home/db2inst1/sqllib/lib or /opt/ibm/db2/V9.5/lib32)
80
+ $ gem install ibm_db
81
+ Select which gem to install for your platform (i686-linux)
82
+ 1. ibm_db 1.0.0 (mswin32)
83
+ 2. ibm_db 1.0.0 (ruby)
84
+ 3. ibm_db 0.10.0 (ruby)
85
+ 4. ibm_db 0.10.0 (mswin32)
86
+ ...
87
+ Running gem install ibm_db you are presented with two choices for each release
88
+ (mswin32 or ruby) choose ruby. This will build the native extension (ibm_db driver) and installs the ibm_db gem.
89
+ ...
90
+ > 2
91
+ Building native extensions. This could take a while...
92
+ Successfully installed ibm_db-0.6.5
93
+ Installing ri documentation for ibm_db-0.6.5...
94
+ Installing RDoc documentation for ibm_db-0.6.5...
95
+
96
+ TEST (simple gem install verification)
97
+ Note: The manual step after install, if using activerecord version below 2.0 is:
98
+ add ibm_db into GEM_HOME\1.8\gems\activerecord-1.15.3\lib\active_record.rb (Line 77)
99
+ $ irb
100
+ irb(main):001:0> gem 'ibm_db'
101
+ irb(main):002:0> require 'ibm_db' // notice the library path (different on win32, use require 'mswin32/ibm_db')
102
+ irb(main):003:0> IBM_DB.connect 'sample', 'db2admin', 'secret'
103
+ $
104
+
105
+ BUILD (optionally) ibm_db gem from sources (ibm_db-x.x.x.tar.gz):
106
+ 1. Download source from Rubyforge
107
+ http://rubyforge.org/frs/?group_id=2361
108
+ 2. Build gem from specification (IBM_DB.gemspec)
109
+ $ cd IBM_DB_Adapter/ibm_db
110
+ $ gem build IBM_DB.gemspec
111
+
112
+
113
+ Instructions for building and installing the IBM_DB driver from source
114
+ =======================================================================
115
+ Building the driver manually as described below is not required if the install
116
+ process above has been pursued. This manual procedure is in fact automated
117
+ on Linux and UNIX platforms by the IBM_DB gem install, but is presented
118
+ here only for reference, and also involves running the unit tests.
119
+
120
+ Prerequisites:
121
+ Install Ruby from:
122
+ http://rubyforge.org
123
+
124
+ Linux and Unix platforms:
125
+ Note: commands may vary depending on the shell used
126
+ - To setup DB2 environment while using an arbitrary user account
127
+ (other than the DB2 install user account):
128
+ Example:
129
+ $ . /home/db2inst1/sqllib/db2profile
130
+
131
+ - To configure test database:
132
+ DB2 v9.x: some IBM_DB driver tests require a UTF-8 database:
133
+ $ db2 CREATE DATABASE testdrv USING CODESET UTF-8 \
134
+ TERRITORY US COLLATE USING SYSTEM PAGESIZE 32768
135
+ DB2 v8.x: driver tests 195 and 52949 requires XML functionality
136
+ only available in DB2 v9.x
137
+
138
+ - To configure database connection parameters edit config.yaml
139
+ Example:
140
+ database: testdrv
141
+ user: db2inst1
142
+ password: password
143
+ hostname: localhost
144
+ port: 50000
145
+
146
+ - To compile and link with DB2 client libraries:
147
+ $ export IBM_DB_INCLUDE=DB2HOME/include (eg. /home/db2inst1/sqllib/include or /opt/ibm/db2/v9.5/include)
148
+ $ export IBM_DB_LIB=DB2HOME/lib (eg. /home/db2inst1/sqllib/lib or /opt/ibm/db2/V9.5/lib32)
149
+
150
+ Windows platforms:
151
+ - Install Visual C++ 2005, Platform SDK (latest), .Net SDK (latest)
152
+ - Set environment:
153
+ CALL "C:\Program Files\Microsoft Platform SDK for Windows Server 2005\SetEnv.Cmd"
154
+ CALL "C:\Program Files\Microsoft Visual C++ Toolkit 2005\vcvars32.bat"
155
+ SET LIB=%LIB%;C:\Program Files\Microsoft Visual Studio .NET 2005\Vc8\lib
156
+ - To configure database connection parameters edit config.yml
157
+
158
+ Build and Execution:
159
+ rake
160
+
161
+ Execution of tests without compilation (must have .so in ibm_db source directory):
162
+ rake onlytests
163
+
164
+ Execution of a single test inside the tests directory can be done by the following:
165
+ export SINGLE_RUBY_TEST=test_001_CtlgConn.rb
166
+ rake
167
+
168
+
169
+ Limitations and known problems
170
+ ==============================
171
+ - ActiveRecord rename_column method is not supported for DB2 LUW, zOS and i5
172
+ - ActiveRecord remove_column method is not supported for DB2 zOS
173
+ - The following tests from the ActiveRecord 1.15.3 test suite with ibm_db gem < 0.9.5 are expected to fail
174
+ - test_limited_eager_with_multiple_order_columns
175
+ - test_limited_eager_with_order
176
+ - test_assign_ids_ignoring_blanks
177
+ - test_build_by_new_record
178
+ - test_get_ids
179
+ - test_select_limited_ids_list
180
+ - test_add_index
181
+ - The following tests from the driver test suite are expected to fail on DB2 version 8
182
+ on Linux/Unix/Windows and Informix Dynamic Server because of missing native XML support. If you want to
183
+ make use of the native XML features in DB2, please upgrade to version 9 or later
184
+ - test_195.rb
185
+ - test_52949.rb
186
+ - The driver returns an error when you try to insert a TIMESTAMP value into a DATE column.
187
+ To fix this, please ensure that the following configuration keyword PATCH2=58 is set
188
+ in the COMMON section of your DB2 CLI initialization file (db2cli.ini):
189
+ - set: db2 UPDATE CLI CFG FOR SECTION COMMON USING PATCH2 58
190
+ - verify: db2 GET CLI CFG FOR SECTION COMMON
191
+ Please refer to http://publib.boulder.ibm.com/infocenter/db2luw/v9/topic/com.ibm.db2.udb.apdv.cli.doc/doc/c0007882.htm
192
+ for more information.
193
+ - The behaviour of ActiveRecord::Base.find(:first) without an :order attribute can be unpredictable.
194
+ The first record (i.e. the record with the minimum id) may be not be retrieved. In a relational model,
195
+ the order of the rows returned is unpredictable and independent of the order of insertion.
196
+ This issue may be addressed in a future release.
197
+ - Rails applications on DB2 9 require the APPLHEAPSZ database configuration parameter to be
198
+ set to or above 1024. You will need to set this parameter for each database for which you will be
199
+ running DB2 on Rails applications. Following is the command syntax for updating the
200
+ applheapsz parameter:
201
+ > db2 update db cfg for <database_name> using APPLHEAPSZ 1024
202
+ To enable this parameter, you need to restart your DB2 instance.
203
+ - If you see connectivity issues with Informix Dynamic Server, please ensure that the server is configured to accept DRDA connections.
204
+ Please refer to http://publib.boulder.ibm.com/infocenter/idshelp/v111/index.jsp?topic=/com.ibm.admin.doc/admin154.htm for more information.
205
+ - 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
206
+ - test_quote
207
+ - test_to_xml
208
+ - test_should_calculate_grouped_by_function
209
+ - test_should_calculate_grouped_by_function_with_table_alias
210
+ - test_inserts_with_pre_and_suffix
211
+ - test_add_table_with_decimals
212
+ - test_no_limits_datatypes_IBM_DB
213
+ - test_instance_update_should_quote_pkey
214
+ - test_integer_columns
215
+ - test_arguments_line_up
216
+ - test_no_dump_errors
217
+ - test_schema_dump_includes_decimal_options
218
+ - IBM_DB is not supported on JRuby. As stated in the JRuby Wiki, "Basics of Getting JRuby Running":
219
+ 'You may install other gems, but keep in mind that libraries with C extension dependencies
220
+ will not work in JRuby.' http://www.headius.com/jrubywiki/index.php/Getting_Started
221
+ The IBM_DB adapter relies on IBM_DB driver (C extension) and the IBM Driver for ODBC and
222
+ CLI to access databases on IBM data servers. Alternatively, you can either use the regular C
223
+ implementation of Ruby, or use ActiveRecord-JDBC adapter to access databases.
224
+ - Query caching feature of ActiveRecord-2.0 not supported
225
+ - When using ActiveRecord-2.1.0 it requires that ActiveRecord be patched, with the patch in the link below:
226
+ http://rails.lighthouseapp.com/attachments/26975/association_preloading.diff
227
+ The patch is required because, ActiveRecord 2.1.0 generates a non-standard SQL identifier,while preloading has_and_belongs_to_many associations,
228
+ which standard compliant databases like DB2 do not support. The bug report, against ActiveRecord, can be found in the link below
229
+ http://rails.lighthouseapp.com/projects/8994/tickets/394-patch-fixed-non-standard-sql-generated-by-preloading-has_and_belongs_to_many-associations
230
+ - 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)
231
+ - 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
232
+ - test_read_attributes_before_type_cast_on_datetime
233
+ - test_to_xml
234
+ - test_native_types
235
+ - test_counting
236
+ - test_counting_with_column_name_and_hash
237
+ - test_counting_with_empty_hash_conditions
238
+ - test_counting_with_single_conditions
239
+ - test_counting_with_single_hash
240
+ Note :- 1) The test cases from HasManyAssociations (4-8) above are found failing only when run as part of
241
+ the complete suite. However they pass when run standalone.
242
+ 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.
243
+ To have these test cases passing rename the fixtures file warehouse-things to warehouse_things.
244
+ - 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
245
+ - test_attributes_on_dummy_time
246
+ - test_quote
247
+ - test_read_attributes_before_type_cast_on_datetime
248
+ - test_save_for_record_with_only_primary_key
249
+ - test_save_for_record_with_only_primary_key_that_is_provided
250
+ - test_to_xml
251
+ - test_utc_as_time_zone
252
+ - test_should_calculate_grouped_by_function
253
+ - test_should_calculate_grouped_by_function_with_table_alias
254
+ - test_include_query
255
+ - test_binary_in_fixtures
256
+ - test_inserts_with_pre_and_suffix
257
+ - test_create
258
+ - test_add_column_with_precision_and_scale
259
+ - test_add_table_with_decimals
260
+ - test_native_types
261
+ - test_schema_dump_includes_decimal_options
262
+
263
+ To Do
264
+ ====
265
+ - Support ActiveRecord remove_column method for DB2 zOS version 9
266
+
267
+
268
+ Feedback
269
+ ========
270
+ Your feedback is very much appreciated and expected through Rubyforge:
271
+ - rubyibm project: http://rubyforge.org/projects/rubyibm/
272
+ - rubyibm forum: http://rubyforge.org/forum/?group_id=2361
273
+ - rubyibm bug reports: http://rubyforge.org/tracker/?group_id=2361
274
+ - IBM_DB developers: rubyibm-developers@rubyforge.org