@zosconnect/zosconnect-node


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.

$3

``
npm install @zosconnect/zosconnect-node
`

$3

#### Connecting to z/OS Connect

`js
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.
`js
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.
`js
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.

$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

$3

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 |

$3

`
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.
``