npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

cics-exci

v0.2.0

Published

CICS sample node for EXCI

Vulnerabilities

Powered byPowered by Snyk
  • 0High
  • 0Medium
  • 0Low

Links

Git

Maintainers

markjhollandsmarkjhollands

Keywords

Readme

cics-exci Node.js module

Sample Node.js for z/OS node module demonstrating how to access CICS from z/OS Unix System Services (USS) using the external CICS interface (EXCI)

Important: This cics-exci node module is provided as a SAMPLE and is intended only for internal use for evaluation purposes and not for use in a production environment. IBM provides the information and node module without obligation of support and “as is” without warranty of any kind, under the Apache 2.0 license.

To get started with this sample, it is recommended you download and install the sample web app, which can be found here: https://github.com/cicsdev/cics-nodejs-exci-webapp-sample. Follow the instructions for the web app for use of this node module with an application. Alternatively, to use this sample, you can install using the instructions below.

Whichever installation method you use, you will also need to:

  1. Configure EXCI in your CICS region
  2. Set up USS for EXCI

Optionally, if you would like to make changes to the sample, you will have to re-build the Native Add-On component.

Instructions for all these steps are provided in this README.

Features

  • Node.js application running on z/OS can access CICS over EXCI
  • Pass data to and from CICS over EXCI using CICS Channels and Containers
  • Concurrent EXCI requests into CICS

Sample applications

Pre-requisites

  • IBM CICS Transaction Server for z/OS (CICS) V5.4 - you may run the cics-exci node against a pre-V5.4 CICS region, however the node module utilises EXCI Channels and Containers functionality implemented in CICS V5.4. As such the SDFHEXCI V5.4 library must be in your STEPLIB during execution.
  • IBM SDK for Node.js - z/OS, beta 2 - Download
    • Note: ensure that all setup has been completed before you try to use the cics-exci sample node. If you would like to build the cics-exci code, you will also need to install all prerequisites for compiling Node.js Native Add-ons, as described below.

Installation

$ npm install cics-exci

Or include as a dependency in package.json

Manual installation

If you would like to install the cics-exci module from source you will need to complete the following steps:

  1. Clone GitHub repository
  2. Install the sample
  3. Use in Node.js application

Instructions for all these steps are provided below.

Cloning GitHub repository

You will first have to clone this GitHub repository onto z/OS. When cloning the GitHub repo, you have two options. Firstly, if possible, use the Git client for z/OS available for download from the Rocket Software Open Source Tools website.

Alternatively download zipped repo, or clone, onto your local workstation and transfer the files to z/OS. Take care when transferring the files and ensure any file conversions happen as expected. Any zip files should be transferred as binary.

Installing the sample

To install this sample, from within the repository's root directory, run:

$ npm install

This will pull down all dependencies and install.

Use in Node.js application

Once the installation is done copy the contents of this directory into the node_modules directory for any Node.js application that needs to use it. For example:

$ mkdir /u/user/myNodeApp/node_modules/cics-exci/
$ cp -R * /u/user/myNodeApp/node_modules/cics-exci/

Note: The node module includes a Node.js Native Add-on used to access EXCI functionality. This Native Add-on is supplied as a prebuilt binary hosted in this GitHub repository, and downloaded at install time. The code is also supplied in the GitHub repository and can be built manually. For instructions on building the Native Add-on see the instructions at the bottom of this page.

Using the sample

Configuring EXCI to work with the sample

It is advised that you consult with your CICS Systems Programmer to determine how to setup EXCI in your CICS region, and verify that it is working correctly before you use the cics-exci node module.

EXCI setup instructions

You will need to configure the External CICS Interface (EXCI) in your CICS region. Instructions for how to do this can be found here: Setting up EXCI for static routing. These instructions include installing the required CONNECTION and SESSION resources for EXCI.

Additionally, as with any EXCI application, you may need to create a custom EXCI options table. You can use this to, for example, override the CICSSVC if required. For more information on the using the DFHXCOPT EXCI options table see the CICS Knowledge Center: Using the EXCI options table, DFHXCOPT

USS EXCI setup instructions

You will need the EXCI load library in the STEPLIB in USS. You can set this by executing the following command:

$ export STEPLIB=CICSTS54.CICS.SDFHEXCI:$STEPLIB

Note: Substitute the CICSTS54.CICS high-level qualifier to match the location of the SDFHEXCI load library.

If you require a DFHXCOPT options table, once this has been built, you will need to include the data set containing the DFHXCOPT load module in the USS STEPLIB, in addition to the SDFHEXCI library. You can do this by executing the following command:

$ export STEPLIB=USERID.LOADLIB:$STEPLIB

Where USERID.LOADLIB is the data set containing the built DFHXCOPT member.

Building the cics-exci-bindings Native Add-on

For convenience, the Native Add-on portion of the cics-exci, which includes using the cics-exci-64bit-connector sample to implement EXCI, has been prebuilt and is downloaded as binary when the cics-exci node module is installed. If you would like to extend or view the code for this module, you can build the Native Add-on manually by following the instructions below.

Pre-reqs

Building and installing the Native Add-on

Before building you need to set the LD_FLAGS environment variable to point to the SDFHEXCI V5.4 library. You can you this as follows:

$ export LDFLAGS=\"-l//\'CICTS54.CICS.SDFHEXCI\'\"

Note: Substitute the CICSTS54.CICS high-level qualifier to match the location of the SDFHEXCI load library.

You are now ready to build the node module. To do this, run the following:

$ npm install --build-from-source

This should output build results similar to this:

> [email protected] install /u/user/GitHub/cics-nodejs-exci-module
> node-pre-gyp install --fallback-to-build

make: Entering directory '/u/user/GitHub/cics-nodejs-exci-module/build'
  CXX(target) Release/obj.target/cics-exci-bindings/cics-exci.o
include_end nan.h
../nan_temp.h
nan_temp.h
include_end string.h
../string_temp.h
string_temp.h
include_end unistd.h
../unistd_temp.h
unistd_temp.h
include_end entry.h
../entry_temp.h
entry_temp.h
In file included from ../cics-exci_temp.cc:11:
In file included from ../node_modules/nan/nan.h:24:
/u/marholl/.node-gyp/6.11.0/include/node/node_version.h:14:9: warning: 'USTR' macro redefined [-Wmacro-redefined]
#define USTR(x) u8##x
        ^
../cics-exci_temp.cc:1:9: note: previous definition is here
#define USTR(x) U8##x
        ^
1 warning generated.
  SOLINK_MODULE(target) Release/obj.target/cics-exci-bindings.node
  COPY Release/cics-exci-bindings.node
  COPY /u/user/GitHub/cics-nodejs-exci-module/lib/cics-exci-bindings/cics-exci-bindings.node
  TOUCH Release/obj.target/action_after_build.stamp
make: Leaving directory '/u/user/GitHub/cics-nodejs-exci-module/build'
[email protected] /u/user/GitHub/cics-nodejs-exci-module

This has manually built the node module, which can now be used in a Node.js application hosted in z/OS batch.

License

This project is licensed under Apache License Version 2.0.