RACF

This NodeJS module enables your application to validate against RACF

Installation

Before installing, download and install Node.js. Node.js 8.16 for z/OS or higher is required.

Setup

In order to use this module, you must set the Program Control bit on Node and its dependent DLLs using the following command:

extattr +p <file>

A convenience script, setup.sh, is provided and can do this for you automatically

./setup.sh

Simple to use

Install

npm install racf

Use

const racf = require("racf");
 
// Check if user belongs to a RACF group
if (racf.isUserInGroup("myuserid", "GROUP")) {
  // Authenticate user and password against RACF
  var isSuccessful = racf.authenticate("myuserid", "mypassword");
  console.log(isSuccessful);
}

Test

Prior to running the tests, make sure to set the RACF_TEST_ID, RACF_TEST_PASSWORD, RACF_TEST_INGROUP and RACF_TEST_NOTINGROUP environment variables.

Run the tests:

RACF_TEST_ID="MYUSERID" RACF_TEST_PASSWORD="MYPASSWORD" RACF_TEST_INGROUP="DEV_REALGROUP" RACF_TEST_NOTINGROUP="DEVFAKEGROUP" npm test

Troubleshooting

When running the setup.sh scripr or the extattr command, you may receive the following error:

chattr() error: rv=-1, errno=8B, rsn=0924041B

This indicates that may not have READ access to the BPX.FILEATTR.PROGCTL resource in the FACILITY class. Provide access to your userid or contact your system administrator.