@broadcom/jclcheck-for-zowe-cli v2.0.0

CA JCLCheck™ Workload Automation Plug-in for Zowe™ CLI

The CA JCLCheck™ Workload Automation Plug-in for Zowe™ CLI lets you validate the accuracy of Job Control Language (JCL) during development or automated processes. Use the plug-in to identify execution-time errors, such as security violations and missing data sets, that can cause jobs to fail and lead to delays in production cycles.

• Use cases
• Plug-in Limitations
• Install the JCLCheck Plug-in From Packages
• Install the JCLCheck Plug-in From Source
• Uninstall the JCLCheck Plug-in
• Create an JCLCheck Profile

• Use Cases and Commands

Use cases

The plug-in lets you perform the following tasks:

• Review JCL while editing in a local IDE/editor.
• Validate JCL before you submit batch workloads in a CI/CD pipeline.
• Validate changes to JCL before you merge it with the master branch in a CI/CD pipeline.

Plug-in Limitations

The following limitations apply to the CA JCLCheck Plug-in:

• The plug-in does not currently support using REXX execs with the STDREXX option.
• The AUTOPROC option is required, and is set automatically by the plug-in.
• The JES3 option is set automatically if CA JCLCheck is running on JES3 system. The option is ignored if you include it in a command.
• You must use these alternatives for the following JCLCheck options:
  • CNTLOVDD (use CNTLOVER)
  • LOADOVDD (use LOADOVER)
  • MCOUsr (use MCOSYS)
  • OPRoc (use OPROCLIB)
  • UPDTDD (use UPDTDSN)
• You cannot use the following JCLCheck options with the plug-in at this time:
  • NOOption
  • REMote
  • TLms
  • Graph
  • PROc
  • TERM

Install the JCLCheck Plug-in From Packages

To install the JCLCheck plug-in to the Zowe CLI from packages, issue the following commands:

Install the plug-in:

$ zowe plugins install @broadcom/jclcheck-for-zowe-cli

Validate the installed plug-in:

$ zowe plugins validate @broadcom/jclcheck-for-zowe-cli

Install the JCLCheck Plug-in From Source

Download and Build the Source Code

To install the JCLCheck plug-in to the Zowe CLI from source, issue the following commands:

1. Clone this repository to your PC.
2. In a command line, navigate to the repository.
3. Install dependencies:

$ npm install

4. Build and install the plug-in:

$ npm run installPlugin

5. Validate the installed plug-in:

$ zowe plugins validate @broadcom/ops-for-zowe-cli

Uninstall the JCLCheck Plug-in

To uninstall the plug-in from Zowe CLI, issue the following command:

$ zowe plugins uninstall @broadcom/jclcheck-for-zowe-cli

Create an JCLCheck Profile

To create an JCLCheck plug-in profile via config command gather the following data:

1. The host name of the LPAR on which JCLCheck Web Services is running
2. A username that has authority to access JCLCheck Web Services
3. The password to the account tied to the username

To create an JCLCheck profile through configuration command, issue the following command and provide the above details as prompted:

$ zowe config init

Use Cases and Commands

Issue the following command to check JCL in a given data set:

$ zowe jclcheck check data-set "MY.DATASET(JCL)"