SmartJCL VS Code extension
VS Code extension that provides JCL validation via SmartJCL on the z/OS mainframe, as well as other SmartJCL functionalities.
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.
Perform a SmartJCL JCL Reformat on the JCL currently open in your VS Code editor:
- Update the editor content directly with JCL reformatted according to SmartJCL rules (similar to the
JREF macro in ISPF).
The JCL check is done in the following way:
JCL lines are read from the currently open editor.
A check job is tailored which contains the JCL to be checked.
The check job is submitted on the host z/OS using a Zowe z/OSMF profile.
After check job finishes, spool output files are downloaded.
Output files are processed and the Check results are displayed in VS Code.
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.
JCL Reformat: Sends JCL from the current editor to z/OS to be reformatted by SmartJCL and replaces the editor content with the result.
Open JCKDTLO Webview: Opens the JCKDTLO webview which displays current editor's detailed check results.
Tailor and open job: Opens a new editor window with the tailored job, based on the selected skeleton file and current SmartJCL settings.
Clear Check results: Clears the check results from the Problems panel and related underlining in the current editor.
Import host configuration: Imports SmartJCL settings from the JCKXPARM member on the host z/OS.
Prerequisites
- 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.
- IBM z/OS Management Facility (z/OSMF) available on host z/OS with jobs REST services enabled.
- 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 a Zowe z/OSMF profile:
Extension Settings
This extension contributes the following settings, which must be set up before the first use:
smartjcl.profile.zoweProfile: Name of a Zowe z/OSMF profile (from zowe.config.json) used to submit SmartJCL jobs. If blank, the default profile is used.
smartjcl.parameters.useImportedParameterFile: Controls whether to use the imported parameter file, instead of parameter member on the host.
smartjcl.parameters.globalParameterMember: DSN of SmartJCL global parameter member on the host (default name: JCKXPARM).
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.1.2
- Fixed broken links in the README.
1.1.1
- Improved formatting of messages in the Problems tab.
1.1.0
Full restart of VS Code is required after installing this release to update the extension's settings fields.
New features:
- SmartJCL parameters are now loaded from the global parameter member on the host (default name: JCKXPARM).
- Only the DSN of this parameter member needs to be defined in the extension's settings, old settings fields are deprecated.
- Added command to import the SmartJCL global parameter member (JCKXPARM) from the host.
- Added setting to use the locally imported global parameter member.
- Added JCL Reformat via SmartJCL on z/OS.
- Added logging in the Output channel in VS Code for easier troubleshooting.
1.0.1
- Added support for older VS Code versions: 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!