how to use testDataSourceConnection method in C8 java SDK

[canoe]

I'm trying to use the java SDK to test a data source connection but the documentation is ambiguous.Ã,  An example or just some advice would be appreciated.

The developer guide says there are three args: "connectionString", "username" and "password" while the generated javadoc says there are two args: "String connectionString" and "XmlEncodedXML credentials".

I am accustomed to specifying a data source connection and data source signon as a report parameter through a <credentials> xml tag, but am confused about which parts of that info belong in "connectionString" and in "credentials" when invoking the testDataSourceConnection method.

[Berndb]

COG8 sdk has two methods for testDataSourceConnection:

first)Ã,  with signatureÃ,  (connection, user, pwd)
second) with signatureÃ,  (connection, credentials)

first method is depricated! belongs to ReportNet sdk and will later be removed

[canoe]

Thanks.  For the Cognos 8 version, can you define the two args?  An example would help.  In particular, is connectionString how the db driver refers to the db, or is it how Cognos identifies the dataSourceConnection?  I was assuming the latter, but in other SDK calls the dataSourceConnection and the dataSourceSignon are both specified in a credentials XML arg.