node-red-contrib-db2-for-i 0.1.0

A Node-RED node to access a IBM Db2 for i database

npm install node-red-contrib-db2-for-i

A Node-RED node to read and write to a Db2 for i database from Node-RED on IBM i.


Run the following command in your Node-RED user directory - typically ~/.node-red

npm install node-red-contrib-db2-for-i


5733OPS Open Source free products with options for Node.js and Db2 for i driver located in /QOpenSys/QIBM/ProdData/OPS/Node6/os400/db2i/lib/db2a (default)


Allows basic access to a Db2 for i database. Supported queries: SQL SELECT, INSERT, UPDATE, DELETE.

msg.payload must hold the query for the database, and the result is returned in msg.payload.

The returned payload is one row per result message (Default). Useful for processing per row.

NEW - A more standard "Single Array Mode": result payload is an array containing all the result rows. Useful for bulk processing.

If nothing is found then null is returned.

Basic Example here or here - "db2" search to get an up to date example

Usage Details and Example

Input: msg.payload = SQL Query injected (SELECT, INSERT, UPDATE, DELETE)

Input (OPTIONAL since v0.0.8): The msg.database payload for injecting the connection name (ex: Connection1) which has to exist as a DB2 for i config node. The associated DB2 config node name is used as a connection name for connection reuse within a Node-RED flow. Useful for dynamic connection selection (Named Connection Pool like)

Db2 Config Node: Enter the connection name (ex Connection1), database name(ex dbname = *LOCAL), optional (since version 0.0.8): your credentials (user profile and password). If no user password specified, use the current user profile.

Output Result in msg.payload.

The returned payload will be an array (JSON Array) containing the result rows (array mode) or one message payload (JSON object) per row (default mode).

If nothing is found then null is returned.

Getting Started

Refer to the flow here or here - "db2" search to get an up to date example

Node Info

Version: 0.1.0
Updated 2 weeks, 5 days ago
License: Apache-2.0


0 in the last day
15 in the last week
226 in the last month


  • DB2 for i Config
  • DB2 for i


  • node-red
  • Db2 for i
  • db2
  • ibm
  • ibmi
  • os400
  • ibm i
  • iseries


  • bmarolleau