This content has been archived and is no longer being updated. Links may not function; however, this content may be relevant to outdated versions of the product.

Table of Contents

Troubleshooting: InvalidParameterException, database column aliases not found after JDBC driver update (DB2 LUW driver v4.12.55)


The Pega log reports "InvalidParameterException: Column named <column name> was not found in SQL columns or embedded object" on PRPC 6.3 SP1 with DB2/LINUXX8664 using DB2 driver version 4.12.55. This error will occur anywhere PRPC tries to read a result set with database column aliases.

Apart from PRPC, the following query runs successfully against the DB2 database:

SELECT DISTINCT e.pzImplementationKey, e.pzPrimaryPageClassName, e.pzAppHash, c.pxHeight as pxClassHeight, e.pzAspect, a.pzAppHeight as pxappheight, e.pzExpirationTime, e.pzContextPathHash, e.pzInsKey FROM pr_sys_appcache_entry e, pr_sys_class_ancestors c, pr_sys_app_hierarchy_flat a WHERE e.pzrulename = {ACAAQueryPage.ruleName} AND e.pzruletype = {ACAAQueryPage.ruleType} AND e.pzcacheconfigid = {ACAAQueryPage.cacheConfigId} AND e.pzprimarypageclassname = c.pxclassname AND c.pxleafclassname = {ACAAQueryPage.appliesToClassName} AND e.pzapphash = a.pzapphash AND a.pztopapphash = {ACAAQueryPage.appHash} ORDER BY c.pxheight, a.pzappheight

The errors reported in the Pega log are caused by the fact that the DB2 JDBC 4.x drivers conform to the JDBC 4.0 standard, which changes how the results of a query are retrieved when aliases are part of the query.

Read the Reference cited and follow the Suggested Approach.

Error (example)

2013-02-21 16:35:16,720 [ http-] [ Developer] [ PegaRULES:06.03] (che.appcentric.AppShortcutImpl) ERROR dd976c2n12| -

Failed to infer a shortcut from an AppCentric entry. Column named pxClassHeight was not found in SQL columns or embedded object










at com.pega.pegarules.generation.internal.cache.appcentric.

at com.pega.pegarules.generation.internal.cache.appcentric.RACacheAppCentricImpl.

at com.pega.pegarules.generation.internal.cache.appcentric.RACacheAppCentricImpl.find

at com.pega.pegarules.generation.internal.cache.AssemblyCacheWrapper.find

at com.pega.pegarules.generation.internal.assembly.FUAManagerImpl.getInternal

at com.pega.pegarules.generation.internal.assembly.FUAManagerImpl.get(

at com.pega.pegarules.generation.internal.PRGenProviderImpl.get(

Suggested Approach

The DB2 JDBC driver version 4.0 has been changed to support the JDBC 4.0 standard. One of the changes involves aliases.

  1. Read the Reference cited to understand how the IBM® Data Server Driver for JDBC and SQLJ Version 4.0 and later versions changes to conform to the JDBC 4.0 standard, compared to the IBM Data Server Driver for JDBC and SQLJ Version 3.50 and earlier JDBC drivers.
    The values returned for ResultSetMetaData.getColumnName and ResultSetMetaData.getColumnLabel are different.
  2. If you plan to use DB2 JDBC driver version 4.0 or later version, set the connection property as follows:

    <connection-property name="useJDBC4ColumnNameAndLabelSemantics">2</connection-property>

  3. Alternative to Step 2: Return to using the DB2 JDBC driver version 3.5.


ResultSetMetaData returns different values for the IBM Data Server Driver for JDBC and SQL Version 4.0

100% found this useful

Have a question? Get answers now.

Visit the Collaboration Center to ask questions, engage in discussions, share ideas, and help others.