Creating and configuring a Microsoft SQL Server database for recording data

To record data to a Microsoft SQL Server database, create the database, and configure an ODBC definition to it. Configure your integration node so that it can connect to the database.

1. Use the script that is provided with IBM Integration Bus to create and configure an SQL Server database to store your recorded data. Note that the script creates some tables that are not currently used, and are reserved for future use, such as WMB_EVENT_FIELDS and WMB_EVENT_TYPES.
   1. Locate the script at install_dir\server\ddl\sqlServer\DataCaptureSchema.sql, where install_dir is the location of your IBM Integration Bus installation.
   2. Optional: Customize the provided DataCaptureSchema script.

      If you modify the SQL to specify a particular schema, you must also set the same schema name in the DataCaptureStore configurable service.

   3. To run the script, at a command line, navigate to the script location and enter the following command:

      sqlcmd -d databaseName -i DataCaptureSchema.sql

2. Create an ODBC definition for the database.

   If you used the supplied script to create your database without modifications, create an ODBC definition for the database that is called MBRECORD, with MBRECORD as the data source name (DSN). For more information, see Enabling ODBC connections to the databases.

3. Use the mqsisetdbparms command to set a user identifier and password for the integration node to use when it connects to the database.
   For example:

   mqsisetdbparms integrationNodeName -n dataSourceName -u userID -p password

   • integrationNodeName is the name of your integration node.
   • dataSourceName identifies the database to which you want to record data.
   • userID and password specify the user identifier and the password that the integration node uses to connect to the database.

   If Integrated Windows Authentication is being used for SQL Server database access, then the service user ID under which the broker process runs is used by Windows to access the SQL Server database. It ignores any user ID and password credentials that are set using the mqsisetdbparms command.

4. To ensure that the changes to the mqsisetdbparms command take effect, restart the integration node.
   For more information, see Starting and stopping an integration node.
5. Test the connection to your database by using the mqsicvp command.
   For more information, see mqsicvp command.