zowe-native-proto

Setup

create your own config.local.json adjacent to config.default.jsonc with something like:

{
    "host": "my.mainframe.net",
    "username": "ibmuser",
    "password": "ibmpass",
    "deployDirectory": "/u/users/ibmuser/zowe-native-proto"
}

Deploy & Build

• npm run tools:init (once)
• npm run tools:deploy [file(s)|dir(s)]
• npm run tools:build [file(s)|dir(s)]
• npm run tools:deploy:build [file(s)|dir(s)]
• npm run tools:artifacts (to download binaries)

Example: npm run tools:deploy:build c/zowex.cpp to deploy and build one file

Test

On remote system, cd to deploy dir and run test.sh (or run zowex)

Troubleshooting

go: FSUM7351 not found

Ensure go is part of PATH

Client connection error - Error: All configured authentication methods failed

Check that your username and password are correct.
For private keys, confirm that you can ssh into the LPAR/zVDT using it.

FSUM9383 Configuration file `/etc/startup.mk' not found

You should be able to find the startup.mk file in /samples

• cp /samples/startup.mk /etc/startup.mk
  source: https://www.ibm.com/support/pages/fsum9383-configuration-file-etcstartupmk-not-found

Building zut.o - FSUM3221 xlc++: Cannot spawn program /usr/lpp/cbclib/xlc/exe/ccndrvr

The only way we (DKelosky) knew how to fix this is via SYSVIEW commands.

⚠️ These commands could ruin your system. ⚠️

linklist
linkdef zowex from current
linklist zowex
add CBC.SCCNCMP
linkact zowex
set asid 1
linkupd *

Note 1: You may need to run linkact zowex after an IPL.
Note 2: You may need to replace * with your mask character. For example, linkact zowex =

Architecture

Click on a component in the diagram below to learn more about it:

graph LR
  subgraph Client
  sdk[Node.js SDK Package]
  cli[Zowe CLI Plug-in]-->sdk
  vsce[VS Code Extension]-->sdk
  other[<My Custom App>]-->sdk
  end
  subgraph z/OS Server
  ioserver["Golang I/O Server<br>(Middleware)"]<-->zowex["C++ CLI Binary<br>(Backend)"]
  sdk<-->|SSH|ioserver
  subgraph Mainframe Resources
  ds[Data Sets]
  uss[USS Files]
  jobs[Jobs]
  end
  zowex-->ds
  zowex-->uss
  zowex-->jobs
  ioserver-->uss
  end
  click sdk "https://github.com/zowe/zowe-native-proto/blob/main/doc/client/architecture.md#sdk-package"
  click cli "https://github.com/zowe/zowe-native-proto/blob/main/doc/client/architecture.md#cli-plug-in"
  click vsce "https://github.com/zowe/zowe-native-proto/blob/main/doc/client/architecture.md#vs-code-extension"
  click ioserver "https://github.com/zowe/zowe-native-proto/blob/main/doc/server/ioserver_architecture.md"
  click zowex "https://github.com/zowe/zowe-native-proto/blob/main/doc/server/zowex_architecture.md"

Loading