Troubleshooting
Problem
When attempting to create a connection to Db2 using the CLI connection type in Cognos Analytics, users may receive errors related to the SSL version being used.
This error is a result of the latest Db2 clients using a GSKit version which forces TLS 1.3 communication. TLS 1.3 is not supported by Cognos Analytics at this time. Therefore, when testing the CLI connection, users will see SSL related errors.
Note that JDBC connections to Db2 will succeed.
Symptom
When testing the data source connection, users see the following error:
QE-DEF-0285 The Logon Failed
Upon expanding the details of the error message, users will see evidence of a communication error related to SSL coming from the Db2 CLI driver:
[IBM][CLI Driver] SQL30081N A communication error has been detected. Communication Protocol being used: "SSL". Communication API being used: "Sockets". Location where the error was detected: "". Communication Function detecting the error: "SQLccSetClientSSLVersions". Protocol specific error code(s): "701", "*", "*". SQLSTATE=08001.
Document Location
Worldwide
[{"Type":"MASTER","Line of Business":{"code":"LOB76","label":"Data Platform"},"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSTSF6","label":"IBM Cognos Analytics"},"ARM Category":[{"code":"a8m50000000Cl6nAAC","label":"Data Source"},{"code":"a8m50000000Cl5lAAC","label":"Security-\u003ESSL\/Cryptography"}],"ARM Case Number":"TS011589486","Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"11.1.7;11.2.4"},{"Product":{"code":"SS6G84","label":"IBM Cognos Analytics on Cloud"},"Business Unit":{"code":"BU048","label":"IBM Software"},"Component":" ","Platform":[{"code":"","label":""}],"Version":"","Edition":"","Line of Business":{"code":"LOB76","label":"Data Platform"}},{"Product":{"code":"SSLKT6","label":"IBM Maximo Asset Management"},"Business Unit":{"code":"BU048","label":"IBM Software"},"Component":" ","Platform":[{"code":"","label":""}],"Version":"","Edition":"","Line of Business":{"code":"LOB77","label":"Automation Platform"}}]
Log InLog in to view more of this document
This document has the abstract of a technical article that is available to authorized users once you have logged on. Please use Log in button above to access the full document. After log in, if you do not have the right authorization for this document, there will be instructions on what to do next.
Was this topic helpful?
Document Information
Modified date:
15 January 2026
UID
ibm16854401