Skip to main content

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.

Support Article

Unable to connect to external DB2 11.1 Function Mode



System connects to an external DB2 z/OS database as well as the DB2 LUW PegaRULES database using an XA driver.

Upgraded DB2 z/OS database from 10.1 to 11.1 but running in compatibility mode and did not see any issues.

After switching DB2 z/OS from compatibility mode to function(conversion) mode in version 11.1 unable to connection to any of the tables in the DB2 z/OS database.

Error Messages

Caused by: [jcc][10341][11670][4.21.29] An SQL OPEN for a held cursor was issued on a XA connection ERRORCODE=-4496, SQLSTATE=null
... 76 more

Steps to Reproduce

Upgrade DB2 (z/OS) from 10.1 to 11.1 and activate the conversion mode.

Root Cause

A defect or configuration issue in the operating environment.

The application is using the JDBC API to access the database metadata.

There should not be any change needed to the application after the database upgrade.

By running db2zos host variable trace on the database showed that the driver querying against DB2 catalog did not return any row and was passing junk characters.

Found that the DB2 zos upgrade was not completed correctly which caused metadata stored procedures to be bound with wrong encoding - ebcdic instead of unicode.


Make the following change to the operating environment: Correct the database to use the correct encoding.

Published May 15, 2017 - Updated October 8, 2020

Was this useful?

0% found this useful

Have a question? Get answers now.

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

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best.

Pega Community has detected you are using a browser which may prevent you from experiencing the site as intended. To improve your experience, please update your browser.

Close Deprecation Notice
Contact us