Several JDBC functions were enhanced for i5/OS™ Version 5 Release 4.
- 2 MB statement size
- 128 byte column name support
- Database host server trace support
- eWLM Correlator support
For information about enhanced JDBC functions for previous releases, see Enhancements to JDBC support for Version 5 Release 3 and Enhanced JDBC functions for i5/OS Version 5 Release 2.
2 MB statement size
Prior to V5R4, the limit on SQL statement size was 65 535 bytes. This corresponds to 65 535 characters when the statement text is represented using a single-byte CCSID, and 32 767 characters when the statement text is represented using a double-byte CCSID. Some customers, particularly those using applications that automatically generate SQL statements, were affected by this limit.
In V5R4, the iSeries™ statement size limit has been increased to two megabytes, or 2 097 152 bytes. The IBM® Toolbox for Java™ JDBC driver always sends statement text in two byte Unicode. Therefore, the maximum statement length in characters will be one megabyte or 1 048 576 characters.
128 byte column name support
Starting with V5R4, the database will support column names up to 128 bytes for SQL tables. Prior to V5R4, column names up to 30 bytes were supported. The IBM Toolbox for Java JDBC driver will provide these possibly longer names to its users.
There is one exception where 128 byte column names will not be returned. When local package caching is used and column names exceed 30 characters, the server will return the column names as the system column name.
Database host server trace support
A new option was added to the Toolbox for Java JDBC driver to turn on database host server tracing. To support this feature, option "64" was added to the "server trace" connection property. For more details, see IBM Toolbox for Java JDBC properties.
eWLM Correlator support
The IBM Toolbox for Java will accept an IBM Enterprise Workload Manager (eWLM) correlator and pass it on to the host as a connection attribute correlator for use with the Application Response Measurement (ARM) APIs. This correlator can be sent to the host at any time after a connection is made using the following method in the AS400JDBCConnection class:
public void setDB2eWLMCorrelator(byte[] bytes)
throws SQLException
Sets the eWLM Correlator. It is assumed a valid correlator value is used. If the value is null, all ARM/eWLM implementation will be turned off. eWLM correlators require i5/OS V5R3 or later servers. This request is ignored when running to OS/400® V5R2 or earlier servers.
- bytes: The eWLM correlator value
- SQLException: See the Class SQLException
information at the Sun Microsystems,
Inc. Web site.
For information about enhanced JDBC functions for previous releases, see Enhancements to JDBC support for Version 5 Release 3 and Enhanced JDBC functions for i5/OS Version 5 Release 2.
