Node.js runtime environment

To use Node.js applications with CICS, you need to install the IBM® SDK for Node.js -z/OS®. It provides the Node.js runtime that is used by Node.js applications in CICS V5.5.

For more information about the system requirements, see Detailed system requirements.

A Node.js runtime environment in CICS runs under the CICS region user ID, and involves a Language Environment (LE) enclave. The enclave runs the Node.js process and a single such enclave exists for each Node.js application. The workload for the Node.js application runs within the enclave, isolated from any other Node.js application instances.

A Node.js application in CICS is represented by a NODEJSAPP resource. The configuration information that is required for the Node.js application (such as the installation location of the IBM SDK for Node.js -z/OS) is specified in the Node.js application profile.

This application profile, together with the other artifacts that make up the Node.js application, must be packaged together into a CICS bundle. The CICS BUNDLE resource represents the Node.js application to CICS and you can use it to manage the lifecycle of the application. If the bundle is enabled, the associated Node.js application runs within the enclave. If the bundle is disabled, the associated Node.js application is stopped.