Resolving DB2 Connection Errors in Compatible Query Mode

Troubleshooting

Problem

If the DB2 connection is not properly configured any attempt to establish a connection to this data source will fail. The error message that is returned can be a result of several factors listed below.

Symptom

On Windows the message will be listed as:

QE-DEF-0285 Logon failure.
QE-DEF-0285 Logon failure.
QE-DEF-0325 The cause of the logon failure is:
QE-DEF-0068 Unable to connect to at least one database during a multi-database attach to 1 database(s) in:
testDataSourceConnection
UDA-SQL-0432 Unable to locate the gateway "cogudad2"

On UNIX systems the message will be reported as:

[{"Product":{"code":"SSEP7J","label":"Cognos Business Intelligence"},"Business Unit":{"code":"BU048","label":"IBM Software"},"Component":"Cognos Connection","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"10.2.2;10.2.1;10.2","Edition":"","Line of Business":{"code":"LOB76","label":"Data Platform"}},{"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"}}]

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

More support for:
Cognos Business Intelligence

Software version:
10.2.2, 10.2.1, 10.2

Operating system(s):
AIX, Solaris, Windows

Document number:
386855

Modified date:
08 May 2025

UID

swg21367693

IBM Support

Tips