IBM Db2 is a relational database management system that’s designed to handle the operational and analytic workloads for any size organization. IBM Db2 provides storage optimization, in-memory technology, data compression, workload management, and other features that help ensure high performance, availability, reliability, scalability, and security for your business-critical information.

You can use IBM App Connect to pass key data between IBM Db2 and other apps – automatically, in real time. You can do so using configuration and data mapping without a need for coding, and can achieve a return on your investment in minutes/hours, not days/months.

This guide shows you how.

If you can’t find what you want, or have comments about the “how to” information, please either add comments to the bottom of this page or .

A business scenario

The challenge

You are steadily building up your e-commerce business and new customers are signing up for online accounts and placing orders every day. You know your customers are your most important asset, so you’re using IBM Db2 to collect and maintain valuable customer data, and build up a history of buying patterns. You’re exploring opportunities to build relationships with your customers and establish them as repeat customers.

How App Connect can help

Use App Connect to connect your IBM Db2 server to your other apps, to pass key information automatically. So when new online registrations are submitted, you might want to create new customer records in your Db2 database, with corresponding order and sales records that capture pertinent details about the orders placed. Perhaps you’d like to generate emails to customers to confirm their orders and delivery dates, and maybe even send out a questionnaire to evaluate their satisfaction with your service for further action or follow-up. And, for a personal touch, why not subscribe your customers to mailings lists that can be used to generate automated personalized marketing campaigns?

What should I consider first?

Before you use App Connect Designer with IBM Db2, take note of the following considerations:

  • App Connect supports IBM Db2 Database on Linux, UNIX, and Windows (LUW) editions that run on premises. For further details of these Db2 offerings, see
  • If you don’t have a paid/business account or restrictions are placed on your business account, you can create a free IBM Db2 account to test how Db2 integrates with App Connect. You can choose one of these free editions to use in your test or proof-of-concept environment: IBM Db2 database (Trial period restricted to 90 days), IBM Db2 Developer Community Edition, or IBM Db2 Express-C Edition. You’ll require an IBM account with an IBMid and password to download the product.
  • Ensure that your Db2 server is running and that a database connection exists for the database you want to use with App Connect.
  • App Connect supports operations against the following database objects only: tables and views. User accounts that App Connect will use to connect to the Db2 database must have GRANT privileges to create, retrieve, and update or create (INSERT, SELECT, MERGE) rows/records in tables and views.

    For example, the App Connect connection to Db2 shown in the following figure provides operations for the tables CONTACTS and CUSTOMERS and for the views CUSTOMERS_VIEW and V1. For the V1 view, the operation Retrieve V1 records is supported.

    Example of Db2 tables and views in App Connect. (Click image to view full size.)
  • If the Db2 server is in a private network (for example, behind a firewall in your on-premises data center), you’ll need to set up a gateway that App Connect will use to securely access the Db2 server. You can use the IBM Secure Gateway Client to set up the required network connection for accessing protected data.

    If you’ve previously used the Secure Gateway Client to set up a network connection for an App Connect application that is on the same private network as the Db2 server, you can use this network connection with Db2. If you don’t have such a network connection in place, configure one as described in Configuring a private network for IBM App Connect. Also ensure that the Db2 server’s host and port are defined in the Secure Gateway Client’s access control list.

  • To create an integration flow that passes key data between IBM Db2 and other apps, you must connect App Connect to each app in the flow. To connect App Connect to your IBM Db2 account, you’ll need the following database connection details. If you are not the owner or administrator of your Db2 instance, you can obtain this information from your Db2 administrator.
    • Db2 host name and port: The Db2 database server host name or IP address, and the port number of the database server listener. Use the following format: hostname:port.

      Tip: The default value of localhost can be used for the host name if the database is running on the same system as the IBM Secure Gateway Client. If using the Db2 default port, 50000 is used for a connection without SSL.

    • Database: The Db2 database name, specified in uppercase.
    • User name: A Db2 database user name, specified in uppercase.
    • Password: The password for the Db2 database user.
    • Schema: The schema qualifier, specified in uppercase, for the collection of database objects you want to perform operations on. If left blank, the schema qualifier defaults to the Db2 database user name.
    • Network name: The name of the network (configured using the IBM Secure Gateway Client) for connecting to a Db2 server in a private network.

      Important: Ensure that the Secure Gateway Client has been started. If you need to, you can start the Secure Gateway Client as described in Configuring a private network for IBM App Connect: Finally, start and configure the Secure Gateway Client.

    • Example of completed fields for connecting from App Connect

      These entries relate to a locally-installed Db2 server.

      Example of IBM Db2 connection details

    You can connect to the IBM Db2 app either from the Applications tab on the App Connect Catalog page, or when you add the app to a flow. After you connect, the Db2 database objects, and applicable events and actions can be discovered.


    • Immediately after you connect, rename your account with a meaningful name that helps you identify which schema the account relates to. You’ll find this useful if you’d like to access multiple schemas in your flows. You can rename an account only from the Applications tab on the Catalog page, and before it’s used in a flow.
    • If you’d like to access multiple schemas in your flows, you’ll need to add an account for each schema whose objects you want to run operations on.

      For information about renaming accounts and setting up multiple accounts, see Managing accounts in App Connect.

  • To use IBM Db2 as the source application in a flow, you’ll need to configure the Db2 polled event that should trigger the flow. You can poll the Db2 server at specific time intervals for new or updated records in your tables or views, and then configure a target application to perform an action whenever such records are detected. The polling mechanism queries time stamps to detect changes to your database objects, and requires Db2 to add a time stamp when a record is created or updated. This means that polling can be configured only for Db2 tables and views that include datetime columns (with a data type of TIMESTAMP) which store the created or updated time stamps for a record. For more information about configuring polled events, see Configuring polled events to trigger flows.
  • To use IBM Db2 as a target application in a flow, you can choose from a set of discovered actions that enable you to create, retrieve, or update or create records for your database objects.


SFTP, CSV parser, and IBM Db2 flow image

Create an event driven flow that creates records in an IBM Db2 database by using the parsed contents of a new CSV file in an SFTP server

Learn how to use App Connect Designer to create an event-driven flow that parses the contents of a new comma-separated values (CSV) file in an SFTP server, creates records in an IBM Db2 database from the parsed contents, and then renames the file to indicate it’s been processed.

Creating an event-driven flow that retrieves a lead’s history from an IBM Db2 table when a new lead is created in Salesforce, and then emails lead history details to the lead owner

Learn how to use App Connect Designer to create an event-driven flow that retrieves a lead’s history from an IBM Db2 database table when a new lead is created in Salesforce, and then emails lead history details to the lead owner.

Join The Discussion

Your email address will not be published. Required fields are marked *