zrexx

Call z/OS REXX scripts that reside in a PDS from node-js with IRXEXEC

Installation

Before installing, download and install IBM Open Enterprise SDK for Node.js 16 or higher. zrexx v1.0.8 or higher is required for Node.js 18 or higher.

Simple to use

Install

npm install zrexx

Use

There are two versions of rexx calls

zrexx.execute is the Synchronous version of the call

Arguments:

1. file descriptor to write REXX program output to (e.g. 2 to stderr)
2. fully qualified PDS name
3. member name of PDS that has the REXX script
4. first argument to the rexx program
5. second argument to the rexx program etc. (note that to this addon does not create the __argv. stem and all the arguments are space separated, thus arguments with embedded space are not distinguishable with arguments separated by spaces.
6. third etc
7. ...

zrexx.execute_async is Asynchronous

Arguments:

1. file descriptor to write REXX program output to (e.g. 2 to stderr)
2. fully qualified PDS name
3. member name of PDS that has the REXX script
4. first argument to the rexx program
5. second argument to the rexx program etc. (note that to this addon does not create the __argv. stem and all the arguments are space separated, thus arguments with embedded space are not distinguishable with arguments separated by spaces.
6. third etc.
7. ...

[last argument] is the call-back function for asynchronous call.

Example:

const zrexx = require('zrexx');

id = require("os").userInfo().username
dsn = id + ".REXX.TESTPDS"

console.log(zrexx.execute(2,dsn,"HELLO","3","second_rexx_arg","third_rexx_arg"));

zrexx.execute_async(2,dsn,"HELLO","12","second_rexx_arg","third_rexx_arg","fourth_rexx_arg","fifth_rexx_arg",function(err,rc) {
  console.log("async call back");
  console.log("error",err);
  console.log("Rexx call RC",rc);
} );

Test

bash examples/setup_sample.sh to create a sample REXX script in a PDS

node examples/sample.js