Notoriously Pedantic Magistrate

    mvsutils

    1.0.8 • Public • Published

    mvsutils

    Node.js interface to z/OS resources

    Installation

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

    npm install mvsutils

    Availble interfaces

    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)
    }
    
    

    Tests

    npm test

    Examples

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

    Install

    npm i mvsutils

    DownloadsWeekly Downloads

    26

    Version

    1.0.8

    License

    Apache-2.0

    Unpacked Size

    5.57 MB

    Total Files

    997

    Last publish

    Collaborators

    • itodorov
    • backflips