JCL Language Support
The JCL Language Support extension provides an interface in VS Code for developers and system administrators to interact with Job Control Language (JCL) on IBM z/OS mainframes. Edit JCL in a local environment complete with syntax highlighting, linting, and access to a library of sample job snippets. Integrate this extension with CA JCLCheck Workload Automation™ to ensure quality before submitting jobs. The extension provides the following benefits:
You can use the JCL syntax highlighting and snippets features features without installing any prerequisite software.
If you want to use CA JCLCheck linting and reporting features, meet the following requirements:
To connect with a JCLCheck instance on the mainframe, create a
After you create the profile in the CLI, it becomes available for use in VS Code. You can now perform actions in the extension against your default profile.
You can use Zowe CLI to set which profile is your default. Issue the following command:
Note: Future enhancements will provide the ability to create profiles directly in the VS Code interface.
To access extension settings, navigate to File > Preferences > Settings, then select Extensions > JCL configuration.
You can configure the following options:
Review the following use cases to understand how to use the JCL Language Support extension:
Accessing JCL locally
This extension does not provide the ability for you to download from, upload to, or submit jobs on the mainframe. To access mainframe code on your computer, use a tool such as Zowe CLI or Zowe Explorer.
JCL syntax highlighting
For basic syntax highlighting and symbol resolution, use the shortcut
Perform linting to check your JCL for programmatic or stylistic errors. You can perform linting manually, or enable automatic linting on save.
Note: To use linting, meet the software requirements and enable the "JCLCheck features" option. Automatic linting is enabled by default. See Configuring for more information.
Follow these steps:
Producing and sharing JCLCheck reports
Run CA JCLCheck against your code and produce convenient reports in markdown format.
Note: To use reporting, meet the software requirements and enable the "JCLCheck features" option. See Configuring for more information.
Follow these steps:
The report opens in VS Code after it is generated. Reports are created in the folder that you specified in the prompt, or that you specify in the extension settings.
Tip: If you want to convert your JCLCheck report from Markdown format into PDF, HTML, PNG, or JPEG, we recommend using the extension Markdown PDF by yzane.
Using JCL snippets
Before you write JCL from scratch, check the snippet library for useful job templates.
Follow these steps:
For a quicker way to access the snippets:
Creating JCL snippets
You can add your own JCL templates to the snippet library.
Navigate to File > Preferences > User Snippets and select the JCL language.
Refer to Create your own snippets in the VS Code documentation for detailed information about creating the snippet.
For more information about this extension, please visit the documentation on Broadcom TechDocs.
Technical Assistance and Support for JCL Language Support extension
The JCL Language Support extension is made available to customers on Visual Studio Code Marketplace in accordance with the terms and conditions contained in the provided End-User License Agreement (EULA).
If you are on active support for CA JCLCheck Workload Automation or CA Brightside, technical assistance and support is provided to Broadcom customers in accordance with the terms, guidelines, details and parameters located within Broadcom’s “Working with Support” guide located at:
This support generally includes:
Technical support cases must be submitted to Broadcom in accordance with guidance provided in “Working with Support”.
Note: To receive technical assistance and support, you must remain compliant with “Working with Support”, be current on all applicable licensing and maintenance requirements, and maintain an environment in which all computer hardware, operating systems, and third party software associated with the affected Broadcom CA software are on the releases and version levels from the manufacturer that Broadcom designates as compatible with the software. Changes you elect to make to your operating environment could detrimentally affect the performance of Broadcom CA software and Broadcom shall not be responsible for these effects or any resulting degradation in performance of the Broadcom CA software. Severity 1 cases must be opened via telephone and elevations of lower severity incidents to Severity 1 status must be requested via telephone.
Copyright © 2020 Broadcom. The term "Broadcom" refers to Broadcom Inc. and/or its subsidiaries.