许鹏程
2023-06-30 3bbfaa3d7d416afbd154576453c8ee9e7e2f8899
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
<?xml version="1.0" encoding="iso-8859-1"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
      "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="en-US" xml:lang="en-us">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
<meta name="dc.language" scheme="rfc1766" content="en-us" />
<!-- Licensed Materials Property of IBM                      -->
<!-- US Government Users Restricted Rights                   -->
<!-- Use, duplication or disclosure restricted by            -->
<!-- GSA ADP Schedule Contract with IBM Corp.                -->
<meta name="dc.date" scheme="iso8601" content="2009-12-04" />
<meta name="copyright" content="&copy; Copyright IBM Corporation 2009" />
<meta name="security" content="public" />
<meta name="Robots" content="index,follow"/>
<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
<title>Release and Documentation Notes for IBM Informix JDBC Driver</title>
<link rel="stylesheet" type="text/css" href="ibmidwb.css" />
<link rel="stylesheet" type="text/css" href="notesstyle.css" />
</head>
<body>
<a id="Top_Of_Page" name="Top_Of_Page"></a><h1>IBM Informix</h1>
<h1>Release and Documentation Notes for IBM Informix JDBC Driver</h1><span class="productlevel">3.50.JC6, December 2009</span> 
<br />
<a name="wq1"></a>
<div id="wq1">
<h1>Contents</h1>
<div class="head1"><a id="ToC_1" name="ToC_1" href="#wq2" class="toclink">Release Notes</a></div>
<div class="head2"><a id="ToC_2" name="ToC_2" href="#i1085765" class="toclink">Overview</a></div>
<div class="head2"><a id="ToC_3" name="ToC_3" href="#wq3" class="toclink">IBM Informix Server Compatibility</a></div>
<div class="head2"><a id="ToC_4" name="ToC_4" href="#i1084897" class="toclink">Configuration</a></div>
<div class="head2"><a id="ToC_5" name="ToC_5" href="#wq4" class="toclink">What's New in Version 3.50.JC3 for the Informix JDBC Driver</a></div>
<div class="head3"><a id="ToC_6" name="ToC_6" href="#wq5" class="toclink">Savepoint Support in JDBC Applications</a></div>
<div class="head2"><a id="ToC_7" name="ToC_7" href="#wq6" class="toclink">What's New in Version 3.50.JC1 for the Informix JDBC Driver</a></div>
<div class="head3"><a id="ToC_8" name="ToC_8" href="#wq7" class="toclink">Support for Service Name in SQLHOSTS and Connection URLs</a></div>
<div class="head2"><a id="ToC_9" name="ToC_9" href="#wq8" class="toclink">Database Connections in the Demo Programs</a></div>
<div class="head2"><a id="ToC_10" name="ToC_10" href="#wq9" class="toclink">Fixed Problems</a></div>
<div class="head3"><a id="ToC_11" name="ToC_11" href="#wq10" class="toclink">Defects fixed in Version 3.50.JC6</a></div>
<div class="head3"><a id="ToC_12" name="ToC_12" href="#wq11" class="toclink">Defects fixed in Version 3.50.JC5</a></div>
<div class="head3"><a id="ToC_13" name="ToC_13" href="#wq12" class="toclink">Defects fixed in Version 3.50.JC4</a></div>
<div class="head3"><a id="ToC_14" name="ToC_14" href="#wq13" class="toclink">Defects fixed in Version 3.50.JC3R1</a></div>
<div class="head3"><a id="ToC_15" name="ToC_15" href="#wq14" class="toclink">Defects fixed in Version 3.50.JC3</a></div>
<div class="head3"><a id="ToC_16" name="ToC_16" href="#wq15" class="toclink">Defects fixed in Version 3.50.JC2</a></div>
<div class="head3"><a id="ToC_17" name="ToC_17" href="#wq16" class="toclink">Defects fixed in Version 3.50.JC1</a></div>
<div class="head2"><a id="ToC_18" name="ToC_18" href="#wq17" class="toclink">Limitations</a></div>
<div class="head2"><a id="ToC_19" name="ToC_19" href="#wq18" class="toclink">XML Parser</a></div>
<div class="head1"><a id="ToC_20" name="ToC_20" href="#jdbcdocnotes" class="toclink">Documentation Notes</a></div>
<div class="head2"><a id="ToC_21" name="ToC_21" href="#i1084897d" class="toclink">Documentation Notes and Corrections</a></div>
<div class="head1"><a id="ToC_22" name="ToC_22" href="#noitces" class="toclink">Notices</a></div>
<div class="head2"><a id="ToC_23" name="ToC_23" href="#tmrks01" class="toclink">Trademarks</a></div>
</div>
<a name="wq2"></a>
<h1 id="wq2">Release Notes</h1>
<a name="i1085765"></a>
<h2 id="i1085765">Overview</h2>
<p>The purpose of these release notes is to make you aware of any
special actions required to configure and use the IBM&reg; Informix&reg; JDBC
Driver on your computer. This file also describes new features and
feature differences from earlier versions of this product and other IBM Informix products and how these differences affect
current products. This release notes document is not intended to be
all-inclusive; it should be used as an addendum to the <em>IBM Informix JDBC Driver Programmer's Guide</em>, which
provides thorough information about product features and behavior.
These release notes are written for Java&trade; programmers
who use the JDBC API to connect to IBM Informix databases via the IBM Informix JDBC Driver.</p>
<a name="wq3"></a>
<h2 id="wq3">IBM Informix Server Compatibility</h2>
<p>IBM Informix JDBC Driver 3.50 is supported with the
following server versions:</p>
<ul>
<li>IBM Informix Dynamic Server, Version 9.2x, 9.3x, 9.4x,
10.0, 11.10, 11.50</li>
<li>IBM Informix Dynamic Server Express Edition, Version
10.0, 11.10, 11.50</li>
<li>IBM Informix Extended Parallel Server, Version 8.3x,
8.4x, 8.5x</li>
<li>IBM Informix Dynamic Server, Version 7.x</li>
<li>IBM Informix-SE, Version
5.x, 7.x</li>
<li>IBM Informix OnLine, Version 5.x</li></ul>
<a name="i1084897"></a>
<h2 id="i1084897">Configuration</h2>
<p>You must have JRE 1.4.2 or later installed to use the IBM Informix JDBC Driver. Refer to <a href="http://java.sun.com/products/jdbc/">http://java.sun.com/products/jdbc/</a> for
details.</p>
<p>The IBM Informix JDBC driver is tested to run on these platforms:</p>
<ul>
<li>Sun 32-bit Solaris Sparc Solaris 9, 10</li>
<li>Sun 64-bit Solaris Sparc Solaris 9, 10</li>
<li>Sun 64-bit Solaris AMD64 (Opteron) Solaris 10</li>
<li>HP 32-bit HP-UX PA-RISC HP-UX 11i, HP-UX 11.23, 11.31</li>
<li>HP 64-bit HP-UX PA-RISC HP-UX 11i, HP-UX 11.23,11.31</li>
<li>HP 64-bit HP-UX Itanium&reg; HP-UX
11.23PI HP-UX 11.31</li>
<li>IBM 32-bit AIX&reg; PowerPC&reg; AIX 5L&trade; 5.3</li>
<li>IBM 64-bit AIX PowerPC AIX 5L 5.3</li>
<li>Windows&reg; 32-bit Windows 2003, Windows XP, Windows Vista, Windows Server
2008 (Longhorn)</li>
<li>Intel&reg; 32-bit Linux&reg; x86 RHEL 4 RHEL 5, SUSE
SLES 10,Asianux 2.0, Asianux 3.0, Debian 4.0, Ubuntu 6.06 LTS, Ubuntu
7.10</li>
<li>Intel/AMD 64-bit Linux x86_64
(EM64T/AMD64) RHEL 4, RHEL 5, SUSE SLES 10, Asianux 2.0, Asianux 3.0,
Debian 4.0, Ubuntu 6.06 LTS, Ubuntu 7.10</li>
<li>IBM 64-bit Linux POWER&reg; (pSeries/iSeries, OpenPower&reg;, JS20 Blades) RHEL 4, RHEL 5, SUSE SLES
10, Asianux 2.0, Asianux 3.0</li>
<li>IBM 64-bit Linux zSeries&reg; RHEL 4 RHEL 5, SUSE SLES 10</li>
<li>Windows 64-bit (EM64T/AMD64) Windows 2003, Windows XP, Windows Vista, Windows Server
2008 (Longhorn)</li>
<li>MAC 64-bit MAC Intel EM64T/AMD
OS X Leopard</li></ul>
<a name="wq4"></a>
<h2 id="wq4">What's New in Version 3.50.JC3 for the Informix JDBC Driver</h2>
<p>The Informix JDBC Driver,
Version 3.50.JC3, supports the following new feature.</p>
<a name="wq5"></a>
<h3 id="wq5">Savepoint Support in JDBC Applications</h3>
<p>Informix Dynamic Server
(IDS) now supports using savepoints within the statements of an SQL
transaction. See the IDS release notes for a description of this feature.</p>
<p>The following methods supplied by the JDBC 3.0 specification are
now valid in this release: </p>
<ul>
<li><span class="pk">setSavepoint( )</span></li>
<li><span class="pk">getSavepointId( )</span></li>
<li><span class="pk">getSavepointName( )</span></li>
<li><span class="pk">releaseSavepoint( )</span></li>
<li><span class="pk">rollback</span>(<var class="pv">savepoint</var>)</li></ul>
<p>The methods that return multiple result sets are now the only standard
methods the JDBC 3.0 specification that are not currently supported
by the IBM Informix JDBC driver.</p>
<p>In addition, the following new method of the <span class="pk">IfxConnection</span> class
can define a savepoint whose identifier is unique in the current connection: </p>
<ul>
<li><span class="pk">setSavepointUnique( )</span></li></ul>
<p>Two new classes have been added to JDBC to support savepoint objects: </p>
<ul>
<li><span class="pk">IfmxSavepoint</span> ( Interface )</li>
<li><span class="pk">IfxSavepoint</span> ( Savepoint class)</li></ul>
<a name="wq6"></a>
<h2 id="wq6">What's New in Version 3.50.JC1 for the Informix JDBC Driver</h2>
<p>Changes were made in the 3.50.JC1 version of Informix JDBC driver to allow you to use the following
features of IDS, version 11.50. See the IDS release notes for that
version to learn more about the new features:</p>
<ul>
<li>High availability cluster Connection Manager (installed as part
of IBM Informix Client SDK)</li>
<li>The new BIGINT and BIGSERIAL data types</li>
<li>Single sign-on authentication</li>
<li>Support for IS NULL or IS NOT NULL with expressions</li>
<li>J/Foundation Upgraded to JRE 5.0</li></ul>
<p>The following new feature is available in the Informix JDBC Driver, 3.50.JC1.</p>
<a name="wq7"></a>
<h3 id="wq7">Support for Service Name in SQLHOSTS and Connection URLs</h3>
<p>You can now specify the service name of the Informix database server instead of the port number
when configuring connections in the <strong>sqlhosts</strong> file
or a connection URL.</p>
<a name="wq8"></a>
<h2 id="wq8">Database Connections in the Demo Programs</h2>
<p>Except for the pickaseat demo, the examples listed in the<em> IBM Informix JDBC Driver Programmer's
Guide</em>, Version 3.50, use the <strong>DriverManager.getConnection()</strong> method
to get a database connection. Sun Microsystems recommends using a
DataSource object instead. For more information, refer to the Sun
documentation and to the README.TXT file in the <strong>demo/pickaseat </strong>directory.</p>
<a name="wq9"></a>
<h2 id="wq9">Fixed Problems</h2>
<p>The following are required. Otherwise, the java.net library might
throw a <tt class="xph">java.net.UnknownHostException</tt> when connecting to
an IDS server using a host with an ipV6 address:</p>
<ul>
<li>APAR IY56903 for AIX 5.1</li></ul>
<p><em>or</em></p>
<ul>
<li>APAR IY57293 for AIX 5.2</li></ul>
<a name="wq10"></a>
<h3 id="wq10">Defects fixed in Version 3.50.JC6</h3>
<p>The following defects were corrected in version 3.50.JC6:</p>
<ul>
<li>IC62408 JDBC-JCSM -5009 AUTHENTICATION ERROR WHEN ATTEMPTING TO
DO PASSWORD ENCRYPTION WITH JDBC</li>
<li>IC63378 JDBC-GENERIC GETMETADATA THROWS EXCEPTION IN CONJUNCTION
WITH ONCONFIG PARAMETER SQL_LOGICAL_CHAR</li>
<li>IC63455 JDBC-GENERIC PHYSICAL CONNECTIONS ARE NOT PROPERLY CLOSED
WHEN USING CONNECTION POOLING</li>
<li>IC63506 JDBC-GENERIC THE FUNCTION GETROW() RETURNS 0 FOR EVERY
ROW IN THE RESULT SET.</li>
<li>IC64794 JDBC-GENERIC -79865 RETURNED INCORRECTLY WHEN QUERYTIMEOUT
OCCURS AFTER A PREVIOUS EXCEPTION WHEN USING THE INFORMIX JDBC DRIVER</li>
<li>IC64795 JDBC-GENERIC IFXCONNECTIONPOOLMANAGER CAN THROW AN INDEXOUTOFBOUNDSEXCEPTION:
INDEX: -1, SIZE: -1</li></ul>
<a name="wq11"></a>
<h3 id="wq11">Defects fixed in Version 3.50.JC5</h3>
<p>The following defects were corrected in version 3.50.JC5:</p>
<ul>
<li>IC59442 JDBC-GENERIC NULLPOINTEREXCEPTION WHEN WRONG PASSWORD
IS SUPPLIED WITH PAM ENABLED</li>
<li>IC61014 JDBC-GENERIC "TOO MANY OR TOO FEW HOST VARIABLES GIVEN"
EXCEPTION THROWN WHEN DOING A BATCH UPDATE</li>
<li>IC61408 JDBC-GENERIC WHEN USING JDBC, THE BLOB DATA IS NOT LOADED
IN THE SBSPACE WHERE THE TABLE IS SAYING (PUT COL IN SBSPACE).|IN
USING JDBC, THE BLOB DATA ISN'T LOADED IN THE SBSPACE WHERE THE TABLE
IS SAYING (PUT COL IN SBSPACE).</li></ul>
<a name="wq12"></a>
<h3 id="wq12">Defects fixed in Version 3.50.JC4</h3>
<p>The following defects were corrected in version 3.50.JC4:</p>
<ul>
<li>IC58469 JDBC-GENERIC JAVA UDR RETURNS OUT OF MEMORY ERROR</li>
<li>IC59113 JDBC-GENERIC JDBC CONNECTION HANGS DUE TO PACKET LOST
ON THE CLIENT SIDE</li>
<li>IC59283 JDBC-GENERIC JDBC HANGS USING XA CONNECTIONS AND CONNECTION
POOLING</li>
<li>IC60422 JDBC-GENERIC USING GROUPNAME TO CONNECT IN HDR PAIR FAILS
WITH XADATASOURCE</li>
<li>IC60423 JDBC-GENERIC JDBC: SETLONG() GIVES JAVA.LANG.NULLPOINTEREXCEPTION</li></ul>
<a name="wq13"></a>
<h3 id="wq13">Defects fixed in Version 3.50.JC3R1</h3>
<p>The following defect was corrected in version 3.50.JC3R1:</p>
<ul>
<li>IC60421        JDBC-JCSM        SECURITY: JDBC DRIVER SENDS UNENCRYPTED PASSWORD
OVER THE NETWORK EVEN WHEN SECURITY=PASSWORD OPTION IS USED</li></ul>
<a name="wq14"></a>
<h3 id="wq14">Defects fixed in Version 3.50.JC3</h3>
<p>The following defect was corrected in version 3.50.JC3:</p>
<ul>
<li>  IC58245 JDBC-GENERIC    GETPROCEDURECOLUMNS RETURNS NULL FOR COLUMN
NAME WITH A COLUMN TYPE OF 5 (RETURN)</li></ul>
<a name="wq15"></a>
<h3 id="wq15">Defects fixed in Version 3.50.JC2</h3>
<p>The following defects were corrected in version 3.50.JC2:</p>
<ul>
<li>IC57135    JDBC-GENERIC    JDBC HANGS WHEN CONNECTING TO IDS VIA WEBLOGIC</li>
<li>IC56691 USING SETOBJECT() TO SET A NUMERIC VALUE TO INSERT TO
"" RAISES AN EXCEPTION.</li>
<li>IC57329 DATABASEMETADATA.GETPROCEDURECOLUMNS() RETURNS WRONG COLUMN_TYPE
WHEN "OUT" / "INOUT" KEYWORDS ARE USE IN ROUTINE PARAMETER LIST</li></ul>
<a name="wq16"></a>
<h3 id="wq16">Defects fixed in Version 3.50.JC1</h3>
<p>The following defects were corrected in version 3.50.JC1:</p>
<ul>
<li>IC56169    REQUEST JDBC DRIVER TO PARSE SERVICENAME WHEN USING SQLHOSTS
LOOKUP IMPLEMENTATION</li>
<li>IC56171    NULLPOINTEREXCEPTION RAISED WHEN USING SETOBJECT FOR A
PLACEHOLDER LINKED TO A FUNCTION CALL</li>
<li>IC49877    THE JDBC DRIVER ALLOWS THE INSERTION OF INVALID CHARACTERS
FOR A CHARACTER SET</li>
<li>IC52058    SYSTEM OR INTERNAL ERROR JAVA.LANG.REFLECT.INVOCATIONTARGETEXCEPTION.
 ERROR: -79716 WHEN USING TEXT COLUMNS</li>
<li>IC52537    NEED TO REWRITE THE IFXTMPFILE CLASS TO AVOID USING THE
FILE.DELETEONEXIT() METHOD</li>
<li>IC52703    CODE-SET CONVERSION FOR TEXT DATA TYPES NOT WORKING</li>
<li>IC52997    THE ENVIRONMENT VARIABLE NAME IFX_PAD_VARCHAR IS WRONGLY
DOCUMENTED AS IFX_PADVARCHAR WITHIN JDBC 3 DOCUMENTATION</li>
<li>IC53003    NULLPOINTER EXCEPTION USING SETCHARACTERSTREAM() WITH
A ZERO LENGTH STRING</li>
<li>IC53411    JDBC: DATE/TIME OFFSET WHEN READING AND WRITING DATA</li>
<li>IC53557    BINDING TO FLOAT TYPE WITH THE JAVA METHOD SETDOUBLE CAUSES
PROBLEMS ON JDBC 3.00.JC3</li>
<li>IC54835    JAPANESE CHARACTERS ARE CORRUPTED WHEN JDBC CONNECTS TO
ONLINE 5.20</li>
<li>IC54850    ERROR 349 "DATABASE NOT SELECTED YET WHEN" WHEN CALLING
DATABASEMETADATA.GETUDTS IF THERE IS NO OPEN DATABASE.</li>
<li>IC54852    EXECUTING SIMULTANEOUS CALLS TO GETUDTS() COULD FAIL WITH
ERROR 673 "ROUTINE ROUTINE-NAME ALREADY EXISTS IN DATABASE"</li></ul>
<a name="wq17"></a>
<h2 id="wq17">Limitations</h2>
<p>Sun JDK 1.4.2 does not support the codeset CP943.</p>
<p>Refer to the <em>IBM Informix JDBC Driver Programmer's
Guide</em> for complete list of unsupported methods.</p>
<a name="wq18"></a>
<h2 id="wq18">XML Parser</h2>
<p>The Xerces XML library<strong> xerces.jar</strong> has been
removed from distribution with the IBM Informix JDBC driver 3.10 and
later. Xerces is an open source library that is freely available for
download from the following location:</p>
<p><a href="http://www.alphaworks.ibm.com/tech/xml4j">http://www.alphaworks.ibm.com/tech/xml4j </a></p>
<a name="jdbcdocnotes"></a>
<h1 id="jdbcdocnotes">Documentation Notes</h1>
<a name="i1084897d"></a>
<h2 id="i1084897d">Documentation Notes and Corrections</h2>
<p>This section describes feature and performance topics not covered
in the <em>IBM Informix JDBC Driver Programmer's
Guide</em> or modified since publication.</p>
<p></p>
<dl>
<dt class="bold">Handling Transactions</dt>
<dd>In the section &quot;Handling Transactions&quot; in Chapter 3,
the text &quot;JDBC applications can create, destroy, or rollback to
savepoint objects through the following standard JDBC methods of class
IfxConnection:&quot; is followed by a list of the methods. There is
an error in that list. Instead of <strong>rollbackSavepoint(
)</strong>, the last method in the list should be <strong>rollback</strong>(<var class="pv">savepoint</var>).
</dd>
<dt class="bold">Avoid Errors Transferring Large Objects</dt>
<dd>In the section &quot;Smart Large Object Data Types&quot; in Chapter
4, a new section has been added about avoiding errors when you transfer
large objects. 
<p>The <strong>IFX_LOB_XFERSIZE</strong> environment
variable is used to specify the number of bytes in a CLOB or BLOB
to transfer from a client application to the database server before
checking whether an error has occurred. The error check occurs each
time the specified number of bytes is transferred. If an error occurs,
the remaining data is not sent and an error is reported. If no error
occurs, the file transfer will continue until it finishes.</p>
<p>For
example, if the value of <strong>IFX_LOB_XFERSIZE</strong> is
set to 10485760 (10 MB), then error checking will occur after every
10485760 bytes of the CLOB or BLOB is sent. If the <strong>IFX_LOB_XFERSIZE</strong> environment
variable is not set, the error check occurs after the entire BLOB
or CLOB is transferred.</p>
<p>The valid range for the <strong>IFX_LOB_XFERSIZE</strong> environment
variable is from 1 to 9223372036854775808 bytes. The <strong>IFX_LOB_XFERSIZE</strong> environment
variable is set on the client.</p>
<p>You should adjust the value of <strong>IFX_LOB_XFERSIZE</strong> to suit your environment. Set the <strong>IFX_LOB_XFERSIZE</strong> environment variable low enough
so that transmission errors of large BLOB or CLOB data types are detected
early, but not so low that excessive network resources are consumed.</p>
</dd>
<dt class="bold">Enabling unicode collation by Java/JDBC client applications</dt>
<dd>In the section &quot;Support for IBM Informix GLS Variables&quot; in Chapter 6, the
following information about the GL_USEGLU environment variable has
been added:
<p>To enable Unicode collation by Java/JDBC client applications
using the International Components for Unicode (ICU), specify <strong>GL_USEGLU=1</strong> in the connection string before connecting
to a Dynamic Server instance. This enables the server to utilize advanced
Unicode converters that are required to work with Java.</p>
</dd>
<dt class="bold">Avoid Application Hanging Problems (HP-UX only)</dt>
<dd>In the section &quot;Managing Performance&quot; in Chapter 7,
the following information about the PTHREAD_COMPAT_MODE environment
variable has been added:
<p>If your JDBC application hangs on your
HP-UX server, check the setting for the PTHREAD_COMPAT_MODE
environment variable on the HP-UX server. The PTHREAD_COMPAT_MODE
environment variable should be set to 1. This variable tells the pthread
library (libpthread) to run in 1 X 1 mode instead of MxN mode. 1 X
1 is the default mode now on HP-UX.  Setting this environment variable
should resolve the hang problem.</p>
</dd>
</dl>
<a name="noitces"></a>
<h1 id="noitces">Notices</h1>
<p>This information was developed for products and services offered
in the U.S.A.</p>
<p>IBM may not offer the products,
services, or features discussed in this document in all countries.
Consult your local IBM representative
for information on the products and services currently available in
your area. Any reference to an IBM product,
program, or service is not intended to state or imply that only that IBM product, program, or service
may be used. Any functionally equivalent product, program, or service
that does not infringe any IBM intellectual
property right may be used instead. However, it is the user&rsquo;s
responsibility to evaluate and verify the operation of any non-IBM
product, program, or service.</p>
<p>IBM may have patents or pending
patent applications covering subject matter described in this document.
The furnishing of this document does not give you any license to these
patents. You can send license inquiries, in writing, to:   </p>
<pre class="address">IBM Director of Licensing
IBM Corporation 
North Castle Drive 
Armonk, NY 10504-1785
U.S.A.</pre>
<p>For license inquiries regarding double-byte (DBCS) information,
contact the IBM Intellectual
Property Department in your country or send inquiries, in writing,
to:   </p>
<pre class="address">Intellectual Property Licensing
Legal and Intellectual Property Law
IBM Japan Ltd.
1623-14, Shimotsuruma, Yamato-shi
Kanagawa 242-8502 Japan</pre>
<p><strong>The following paragraph does not apply to the
United Kingdom or any other country where such provisions are inconsistent
with local law: </strong><span class="smallcaps">INTERNATIONAL BUSINESS
MACHINES CORPORATION PROVIDES THIS PUBLICATION &quot;AS IS&quot; WITHOUT
WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT
LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY
OR FITNESS FOR A PARTICULAR PURPOSE</span>. Some states do not allow
disclaimer of express or implied warranties in certain transactions,
therefore, this statement may not apply to you.</p>
<p>This information could include technical inaccuracies or typographical
errors. Changes are periodically made to the information herein; these
changes will be incorporated in new editions of the publication. IBM may make improvements and/or
changes in the product(s) and/or the program(s) described in this
publication at any time without notice.</p>
<p>Any references in this information to non-IBM Web sites are provided
for convenience only and do not in any manner serve as an endorsement
of those Web sites. The materials at those Web sites are not part
of the materials for this IBM product
and use of those Web sites is at your own risk.</p>
<p>IBM may use or distribute
any of the information you supply in any way it believes appropriate
without incurring any obligation to you.</p>
<p>Licensees of this program who wish to have information about it
for the purpose of enabling: (i) the exchange of information between
independently created programs and other programs (including this
one) and (ii) the mutual use of the information which has been exchanged,
should contact:   </p>
<pre class="address">IBM Corporation 
J46A/G4 
555 Bailey Avenue 
San Jose, CA 95141-1003 
U.S.A.</pre>
<p>Such information may be available, subject to appropriate terms
and conditions, including in some cases, payment of a fee.</p>
<p>The licensed program described in this information and all licensed
material available for it are provided by IBM under terms of the IBM Customer
Agreement, IBM International
Program License Agreement, or any equivalent agreement between us.</p>
<p>Any performance data contained herein was determined in a controlled
environment. Therefore, the results obtained in other operating environments
may vary significantly. Some measurements may have been made on development-level
systems and there is no guarantee that these measurements will be
the same on generally available systems. Furthermore, some measurements
may have been estimated through extrapolation. Actual results may
vary. Users of this document should verify the applicable data for
their specific environment.</p>
<p>Information concerning non-IBM products was obtained from the suppliers
of those products, their published announcements or other publicly
available sources. IBM has not
tested those products and cannot confirm the accuracy of performance,
compatibility or any other claims related to non-IBM products. Questions
on the capabilities of non-IBM products should be addressed to the
suppliers of those products.</p>
<p>All statements regarding IBM&rsquo;s
future direction or intent are subject to change or withdrawal without
notice, and represent goals and objectives only.</p>
<p>All IBM prices shown are IBM&rsquo;s suggested retail prices,
are current and are subject to change without notice. Dealer prices
may vary.</p>
<p>This information contains examples of data and reports used in
daily business operations. To illustrate them as completely as possible,
the examples include the names of individuals, companies, brands,
and products. All of these names are fictitious and any similarity
to the names and addresses used by an actual business enterprise is
entirely coincidental.</p>
<div>
<span class="pblktitle">COPYRIGHT LICENSE</span>
<p>This information contains sample application programs in source
language, which illustrate programming techniques on various operating
platforms. You may copy, modify, and distribute these sample programs
in any form without payment to IBM,
for the purposes of developing, using, marketing or distributing application
programs conforming to the application programming interface for the
operating platform for which the sample programs are written. These
examples have not been thoroughly tested under all conditions. IBM, therefore, cannot guarantee
or imply reliability, serviceability, or function of these programs.
The sample programs are provided "AS IS", without warranty of any
kind. IBM shall not be liable
for any damages arising out of your use of the sample programs.</p>
<p>Each copy or any portion of these sample programs or any derivative
work, must include a copyright notice as follows:   </p>
<ul class="simple">
<li>&copy; (your company name) (year). Portions of this code are
derived from IBM Corp. Sample
Programs. &copy; Copyright IBM Corp.
(enter the year or years). All rights reserved.</li></ul>
<p>If you are viewing this information softcopy, the photographs and
color illustrations may not appear.</p></div>
<a name="tmrks01"></a>
<h2 id="tmrks01">Trademarks</h2>
<p>IBM, the IBM logo, and ibm.com&reg; are
trademarks or registered trademarks of International Business Machines
Corp., registered in many jurisdictions worldwide. Other product and
service names might be trademarks of IBM or
other companies. A current list of IBM trademarks
is available on the Web at &quot;Copyright and trademark information&quot;
at >http://www.ibm.com/legal/copytrade.shtml</a>.</p>
<p>Adobe&reg;, the Adobe logo, and PostScript&reg; are either registered
trademarks or trademarks of Adobe Systems
Incorporated in the United States, and/or other countries.</p>
<p>Intel, Itanium, and Pentium&reg; are
trademarks or registered trademarks of Intel Corporation
or its subsidiaries in the United States and other countries.</p>
<p>Java and all Java-based trademarks
are trademarks of Sun Microsystems, Inc. in the United States, other
countries, or both.</p>
<p>Linux is a registered trademark
of Linus Torvalds in the United States, other countries, or both.</p>
<p>Microsoft&reg;, Windows, and Windows NT&reg; are trademarks
of Microsoft Corporation
in the United States, other countries, or both.</p>
<p>UNIX&reg; is a registered trademark
of The Open Group in the United States and other countries.</p>
<p>Other company, product, or service names may be trademarks or service
marks of others.</p>
<p>Contact support: <a href=" http://www.ibm.com/software/data/informix/ids/support/"> http://www.ibm.com/software/data/informix/ids/support/</a></p>
<p>&copy; Copyright IBM Corp.
2008, 2009</p>
<a id="Bot_Of_Page" name="Bot_Of_Page"></a>
</body>
</html>