Install VSCode

VSCode install package can be found here

You need to grab the System installer

On the ADDI Windows host, open the above link and download the latest version of VSCode for Windows.

Make sure you are connected as the Windows Administrator.

Install it to this following Path

VSCode Configuration

• Instructions followed: https://ibm.ent.box.com/s/3e4jshd4pdqcmkp231ug1dkedaiuc1ki
• This has to be done before initiating the demo
• Environment: Ubuntu 22.04 on WSL2
• Install IBM Semeru 21.0.1.0
  • https://developer.ibm.com/languages/java/semeru-runtimes/downloads/
• Install JDK from tar.gz (https://gist.github.com/filipelenfers/ef3f593deb0751944bb54b744bcac074)
  • Had to remove all the other java from Ubuntu first
• Configure JVM in VSCode
  • Open VS Code
  • Ctrl+Shift+p
  • Preferences: Open Settings (UI)
  • Enter/search for: java.configuration
  • Installed JDKs
  • Click "Java > Configuration: Runtimes"
  • "Edit in settings.json"
  • "java.jdt.ls.java.home": "/opt/jdk-21.0.1+12",
• Install IBM Z Open Editor extension
• Set JAVA_HOME on extension settings
• Restart VSCode
• Install language support for Java extension (already done)
• While enabling WCAz, the enter API key didn't prompt as shown in the instructions, use Ctrl+Shift+p menu and search for API key and continue

Installing IBM z/OS Developer

Install the IBM Developer for z/OS client

info

The installation process is covered in more depth here

Open the following link in a browser

https://ibm.github.io/mainframe-downloads/downloads.html

Click on the eclipse tools

Choose your products, select the check box beside IBM Developer for z/OS and click Select. Continue to follow the instructions in the wizard prompts to choose an Aqua version, the IBM Installation Manager installation client, and a starting point.

Select the latest Aqua version

Select the Eclipse P2 option

Assuming a fresh install, select Starting from fresh

Click the Download 64-bit button

Make sure to agree to the license agreement.

Extract and install. In our instance we created a directory in C:\ called IDZ and extracted there.

This may take a little while...

Once extracted, navigate to the extracted folder and double click the exe:

This will ask for a workspace directory. This tends to be user specific.

And we're up and running!

Pin the executable to the task bar.

Troubleshooting

• Problem: After IBM Z Open Editor extension installed, error shown on startup

Error: Failed to load Keytar module: libsecret-1.so.0: cannot open shared object file: No such file or directory ProfInfoErr: Failed to initialize secure credential manager   Source: Zowe Explorer (Extension)

• Resolution: Install libsecret libraries on Ubuntu and restart VSCode
  • sudo apt install libsecret-1-dev
  • restart VSCode