Table of Contents

• Node zosconnect
  • Installing
  • Usage
    • Connecting to z/OS Connect
      • HTTPs Support
      • Basic Authentication
    • Managing Items
  • Migrating from Version 3
  • Module Long Term Support Policy
  • License

Node zosconnect

A wrapper service for z/OS® Connect EE, enabling node applications to manage z/OS Connect EE APIs, Services and API Requesters. Version 3 of this module pre-reqs z/OS Connect EE V3.0.14 or later.

Installing

npm install @zosconnect/zosconnect-node

Usage

Connecting to z/OS Connect

var options = {
  uri:'http://mainframe:8080'
}
var zosconnect = new ZosConnect(options);

HTTPs Support

Create the options object with locations for the CA certificate file and optionally the client certificate and client private key (if using client authentication). If the strictSSL option is set to false then invalid SSL certificates can be used which may be of use in development environments.

var fs = require('fs');
var path = require('path');
var caFile = path.resolve(__dirname, 'ca.pem');
var certFile = path.resolve(__dirname, 'cert.pem');
var keyFile = path.resolve(__dirname, 'key.pem');
var options = {
  uri:'https://mainframe:9443',
  ca: fs.readFileSync(caFile),
  cert: fs.readFileSync(certFile),
  key: fs.readFileSync(keyFile),
  passphrase: 'passw0rd',
  strictSSL: true
}

Basic Authentication

Add the authentication credentials to the options object.

var options = {
  uri: 'http://mainframe:9080',
  auth: {
    user: 'userId',
    pass: 'password'
  }
}

Managing Items

APIs, Services and API Requesters can be retrieved and managed either by getting a list of all the installed items, or by getting a particular item by name. Once the application as an Object representing that item it can be further managed by calling methods on that Object.

Migrating from Version 3

With the deprecation of the request module the dependencies of this module have been updated. The only change is the type of the options object passed into the zosconnect has changed from a request.optionsWithUri to a http.RequestOptions | https.RequestOptions

Module Long Term Support Policy

This module adopts the Module Long Term Support (LTS) policy, with the following End Of Life (EOL) dates:

| Module Version | Release Date | Minimum EOL | EOL With | Status | |------------------|--------------|-------------|--------------|---------| | 4.x.x | May 2020 | Apr 2022 | Node 12 | Current | | 3.x.x | Nov 2018 | Apr 2021 | Node 10 | LTS | | 2.x.x | Jul 2018 | Apr 2021 | Node 10 | LTS | | 1.x.x | Jul 2017 | Dec 2019 | Node 8 | LTS |

License

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.