SmartJCL VS Code extension

VS Code extension which provides JCL validation via SmartJCL on the z/OS mainframe.

Features

Perform a SmartJCL JCL Check on the JCL currently open in your VS Code and display the results:

• SmartJCL messages are shown in VS Code's Problems panel and corresponding JCL lines are underlined in the editor.
• Also provided is a view which will show the message and note lines embedded in the original JCL (similar to SmartJCL JCK macro in ISPF).
• Detailed check results are also available as a JSON object.

The check is done in the following way:

1. JCL lines are read from the currently open editor.

2. A check job is tailored which contains the JCL to be checked.

3. The check job is submitted on the host z/OS using a Zowe z/OSMF profile.

4. After check job finishes, spool output files are downloaded.

5. Output files are processed and a JSON object is created which represents the check output.

6. Check results are displayed in VS Code based on this JSON object.

The extension provides these VS Code commands:

• JCL Check: Sends JCL from the current editor to z/OS to be checked by SmartJCL and displays the detected problems.
• Open JCKDTLO Webview: Opens the JCKDTLO webview which displays current editor's detailed check results.
• Open JCKDTLO JSON: Opens the JCKDTLO JSON object in a new editor window.
• Open JCKDTLO: Opens the original JCKDTLO file in a new editor window.
• Open Check job: Opens the check job, tailored using the current settings, in a new editor window.
• Clear Check results: Clears the check results from Problems panel and related underlining in current editor.

Prerequisites

1. An installation of SmartJCL with a valid license key must be available on the host z/OS. The Extension Settings must be set up accordingly.
2. IBM z/OS Management Facility (z/OSMF) available on host z/OS with jobs REST services enabled.
3. A Zowe z/OSMF profile will be used for the z/OS connection. For first time setup, either Zowe Explorer for VS Code or Zowe CLI can be used to create the Zowe z/OSMF profile:
   • Zowe Explorer setup steps: Zowe Docs: Creating Zowe Explorer profiles,
   • Zowe CLI setup steps: Zowe Docs: Creating user profiles.

Extension Settings

This extension contributes the following settings, which must be set up before first use:

• smartjcl.profileSettings.checkProfile: Name of a Zowe z/OSMF profile (from zowe.config.json) used to submit the SmartJCL Check job. If blank, default profile is used.
• smartjcl.checkSettings.jobCard: SmartJCL Check job jobcard.
• smartjcl.checkSettings.loadLibrary: DSN of SmartJCL LOAD library.
• smartjcl.checkSettings.checkParametermMember: DSN of SmartJCL Check parameter member (default name JCKKPARM).

Documentation

Access to the detailed documentation is restricted and only available to HORIZONT customers through the Customer Portal.

Support

If you have a problem that requires technical support, please contact HORIZONT through the support portal.

Known Issues

At this time there are no reported issues.

Release Notes

1.0.1

• Added support of older VS Code versions, require VS Code 1.99.3 and up.

1.0.0

Initial release of the SmartJCL VS Code extension. It includes the following features:

• JCL Check via SmartJCL on z/OS,
• Display of messages in Problems tab and in editor,
• JCKDTLO Webview with check details.

Enjoy!