@broadcom/jclcheck-for-zowe-cli

JCLCheck Plug-in for Zowe CLI

Usage no npm install needed!

<script type="module">
  import broadcomJclcheckForZoweCli from 'https://cdn.skypack.dev/@broadcom/jclcheck-for-zowe-cli';
</script>

README

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

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 plug-in does not currently support executing CA JCLCheck commands that contain options that require APF authorization. Commands that require APF authorization might fail and produce message CAY6399I or CAY6399S. For a complete list of options that require APF authorization, see "Establish CA JCLCheck as APF Authorized" in the CA JCLCheck documentation on https://techdocs.broadcom.com/.

To circumvent the behavior, you can configure the command to run the affected JCLCheck options as not authorized. Specify the following options in the command:

--jo NOAS NOAU NOHCD NOJCL NORES NOSIGN

Software Requirements

Before you install and use the plug-in:

  • Install Node.js v10 or later on your computer.
  • Install Zowe CLI.
  • Install and configure CA JCLCheck Workload Automation on the mainframe system.
  • Apply PTF SO11500 on the system where JCLCheck is running. For more information, see the CA JCLCheck documentation.

Install

To install the @latest version of the plug-in, issue the following command:

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

Note: The @latest npm tag installs an active development version of the plug-in, which accepts breaking changes. For information about installing a stable, supported version of the plug-in, see Zowe CLI > Install CLI > Installing Plug-ins in the CA Brightside documentation.

Create a Profile

​ You can create CA JCLCheck profile to avoid typing your connection details on every command. The profile contains the host and port JCLCheck instance of your choice. You can create multiple profiles and switch between them as needed.

Create the profile using the following command:

zowe profiles create jclcheck-profile <profileName> --host <hostname> --port <portnumber> --user <username> --password <password> --base-path [apiml instance name] --reject-unauthorized [--ru] --protocol [https|https] --overwrite [--o]

For a full specification of the available options, use the --help argument:

zowe profiles create jclcheck --help

Get Started

To get help for the available command groups, issue the following command:

zowe jclcheck --help

Uninstall the Plug-in

To uninstall the plug-in, issue the following command:

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