Updating your ODBC definitions when migrating

As part of migrating a broker, you must create ODBC definitions for broker and user databases, with database drivers that are appropriate for the new product version. You must do this before you run the mqsimigratecomponents command. The way that you do this depends on your operating system:
Windows

ODBC definitions are stored by the operating system. There is only one repository of ODBC data source names. You do not need to change DB2 and SQL Server data source definitions. Change Oracle and Sybase data source definitions according to the instructions in Changing the 32-bit ODBC connection and XA resource manager definitions for a migrated broker.

Linux and UNIX

ODBC definitions are stored in a text file. For previous versions of the product, this file was located in /var/mqsi/odbc/.odbc.ini. When working with Version 6.0, create a new text file under this directory, but do not replace the existing file. This means that you do not affect existing brokers. Set the environment variable ODBCINI to point to the new file; perform this step as part of the setup for a Version 6.0 Command Console.

In your new Version 6.0 ODBC configuration file, ensure that you list all of the data sources that will be used by brokers that you want to migrate. For information on how to create a new ODBC.INI file, see Defining an ODBC connection to a 32-bit database on Linux and UNIX. If you are using XA to enable coordinated transactions, you must also update your qm.ini file for WebSphere MQ, as described in Changing the 32-bit ODBC connection and XA resource manager definitions for a migrated broker.

If you revert to a previous version of WebSphere Message Broker, you must reverse the changes that you make to the ODBC definitions.
  • On UNIX, reset the ODBCINI environment variable to point to the previous version of the odbc.ini file.
  • On Windows, use the Control Panel to adjust the ODBC settings.
Update the odbc.ini after you have run the mqsimigratecomponents command, but before you restart the broker.
Related tasks
Connecting to the databases
Defining an ODBC connection to a 32-bit database on Linux and UNIX
Defining a connection to a 64-bit database on UNIX
Changing the 32-bit ODBC connection and XA resource manager definitions for a migrated broker