mvsutils

Node.js interface to z/OS resources

Installation

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

``bash
npm install mvsutils
`


$3

#### SimpleConsoleMessage
* Arguments: String or type that can be converted to a string via ToString(). When more than one argument
is provided, it will be space delimited.
e.g
`
mvsutils.SimpleConsoleMessage("Write this to","System console")
`
#### GetFileCcsid
* First argument: Path name of file descriptor, if path name is a number prepend with ./ to make it a string
* Returns object contains either "fd" or "file" and "ccsid", "text" or "error".
e.g
`
fs.open("./somefile.txt","r",function (err,fd) {
let attr = mvsutils.GetFileCcsid(fd)
console.log("file text mode", attr.text, " file ccsid", attr.ccsid)
})
`
or
`
let attr = mvsutils.GetFileCcsid("./sometext.txt")
console.log("file text mode", attr.text, " file ccsid", attr.ccsid)
`
#### SetFileCcsid
* First argument: Path name of file descriptor, if path name is a number prepend with ./ to make it a string
* Second argument: text mode bit in file attribute, 1 or 0
* Third arguemnt: CCSID to set
* Return object contains "rc", "error" may be set
`
fs.open("./somefile.txt","r+",function (err,fd) {
let result = mvsutils.SetFileCcsid(fd,1,1047)
console.log(result.rc)
})
`
or
`
let result = mvsutils.SetFileCcsid("./somefile.txt",1,819)
console.log(result.rc)
`
#### GuessFileCcsid
Function to perform a content scan on a file descriptor or path name.
* First argument: Path name of file descriptor, if path name is a number prepend with ./ to make it a string
* Second argument: optional call back function
* Return object contains "fd" or "file", "rc", "error" may be set, "ccsid" contains best guess CCSID of the file.
If the file contains well formed unicode in utf-8, "ccsid" will be set to 819
e.g
`
fs.open("./somefile.txt","r+",function (err,fd) {
mvsutils.GuessFileCcsid(fd,function(obj){
if (obj.ccsid) {
console.log("file ccsid guessed:", obj.ccsid)
}
})
})

`
or
`
let result = mvsutils.GuessFileCcsid("./somefile.txt");
if (result.ccsid) {
console.log("file ccsid: ", result.ccsid)
} else {
console.log(result)
}

``

$3

npm test

$3

fixv6.js contains an example to fix untag files created by node.js V6 npm downloads.