What are the best practices for troubleshooting Heterogeneous ODBC connections?

Question

I am trying to establish a heterogeneous ODBC connection from an Oracle 21c XE database to a Progress OpenEdge 11.7 database. I have installed a 32 bit ODBC driver on the Windows 2019 server where the 21c XE DB resides. I have set up an ODBC System DSN, tested it and it works.

I created a initTIMEDATA.ora file in the C:\app\Administrator\product\21c\homes\OraDB21Home1\hs\admin folder.

It contains;

HS_FDS_CONNECT_INFO = TimeData
HS_FDS_TRACE_LEVEL = 4
HS_FDS_TRACE_FILE_NAME = TimeData.trc

Where TimeData matches the ODBC System DSN name.

I modified the listener.ora adding;

  (SID_DESC=
     (SID_NAME=TimeData)
     (ORACLE_HOME=C:\app\Administrator\product\21c\dbhomeXE)
     (PROGRAM=C:\app\Administrator\product\21c\dbhomeXE\bin\dg4odbc)
     (ENVS = LD_LIBRARY_PATH=C:\Progressx86\OpenEdge\lib:C:\app\Administrator\product\21c\dbhomeXE\bin)
    )

I modified my tnsnames.ora file adding;

TIMEDATA=
  (DESCRIPTION=
   (ADDRESS=
     (PROTOCOL=TCP)
     (HOST=10.254.10.41)
     (PORT=4621)
   )
   (CONNECT_DATA=
     (SID=TimeData))
   (HS=OK))

I created a DBLink like;

CREATE PUBLIC DATABASE LINK time_data_link CONNECT TO "sqluser" IDENTIFIED BY "myPassword" USING 'TIMEDATA';

After restarting everything (DB, Listener...) the listener shows;

Service "TimeData" has 1 instance(s).
 Instance "TimeData", status UNKNOWN, has 1 handler(s) for this service...

When I try to run a query;

SELECT * FROM employee_view@time_data_link;

I get;

ORA-28545: error diagnosed by Net8 when connecting to an agent
Unable to retrieve text of NETWORK/NCR message 65535
ORA-02063: preceding 2 lines from TIME_DATA_LINK
28545. 0000 - "error diagnosed by Net8 when connecting to an agent"
*Cause:  An attempt to call an external procedure or to issue SQL
      to a non-Oracle system on a Heterogeneous Services database link
      failed at connection initialization. The error diagnosed
      by Net8 NCR software is reported separately.
*Action:  Refer to the Net8 NCRO error message. If this isn't clear,
      check connection administrative setup in tnsnames.ora
      and listener.ora for the service associated with the
      Heterogeneous Services database link being used, or with
      'extproc_connection_data' for an external procedure call.
Error at Line: 1 Column: 29

I see no errors in the listener.log, I cannot find TimeData.trc. In poking around the DB trace files I found a trace file related with multiple copies of;

HS connect: nscall returned status ffffffff (-1)
  ns main err code: 12569
  ns (2) err code: 0
  nt main err code: 0
  nt (2) err code: 0
  nt OS  err code: 0

*** 2022-04-03T17:01:07.758909-04:00 (XEPDB1(3))
HS: Unable to establish RPC connection to HS Agent...
HS: ... Agent SID = (DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=10.254.10.41)(PORT=4621))(CONNECT_DATA=(SID=TimeData))), NCR error = 65535 Unable to retrieve text of NETWORK/NCR message 65535

I have reached the end of my troubleshooting skills and hope someone else may be able to point me in the right direction.

Answer 1

I had two problems.

1. The TNSNAMES.ORA file needed to point to the Oracle DB server, running on localhost in my case. Once I changed this, the error changed to

Error;

ORA-28500: connection from ORACLE to a non-Oracle system returned this message:
[Microsoft][ODBC Driver Manager] The specified DSN contains an architecture mismatch between the Driver and Application {IM014}

New TNSNAMES.ORA;

TIMEDATA=
   (DESCRIPTION=
      (ADDRESS=
         (PROTOCOL=TCP)
         (HOST=localhost)
         (PORT=1521)
      )
      (CONNECT_DATA=
         (SID=TimeData))
      (HS=OK))

2. Once I saw this error it became apparent I needed the 64 bit version of the ODBC driver which I acquired.

After making these changes everything seems to work.