# CA 7 Workload Automation Plug-in for Zowe™ CLI

You can now use the CA 7 Plugin for Zowe CLI to perform the following tasks without having to leave the ZOWE CLI interface: 
  
  - [Use cases](#Use-cases)
  - [Software Requirements](#Software-Requirements)
  - [Install](#Install)
  - [Create a Profile](#Create-a-Profile)
  - [Uninstall the Plug-in](#Uninstall-the-Plug-in)
  
### Use cases
Combining Zowe commands, you can have many useful scripts to either write a report, alert, and alterations of your workflow. 

You can issue the following CA7 Commands: 
  * POST ADDRQ
  * POST CANCEL
  * POST DEMAND
  * POST DEMANDH
  * POST HOLD
  * POST JCLOVRD
  * POST POST
  * POST PRSCF
  * POST PRSQA
  * POST RELEASE
  * POST REQUEUE
  * POST RESOLV
  * POST RESTART
  * POST RMTSUB
  * POST RMTTRK
  * POST RUN
  * POST RUNH
  * POST SUBMIT
  * POST SUBTM
  * POST VERIFY

You can issue the following commands to retrieve/create/update/delete the Dataset related information:
  * PUT DATASET
  * POST DATASET
  * DELETE DATASET
  * PUT DATASET NAME
  * PUT DATASET TRIGGER
  * POST DATASET TRIGGER
  * DELETE DATASET TRIGGER

You can also request job status from the CA7 Event Manger
  * GET JOBSTATUS

You can issue the following commands to retrieve/update/create/delete the job definition related information: 
  * GET JOB
  * PUT JOB
  * POST JOB
  * DELETE JOB
  * GET JOB PROSE
  * GET REQUIREMENT-PREDECESSOR
  * PUT REQUIREMENT-PREDECESSOR
  * POST REQUIREMENT-PREDECESSOR
  * DELETE REQUIREMENT-PREDECESSOR
  * GET REQUIREMENT-SUCCESSOR
  * PUT ADDRESS SPACE RESOURCE
  * POST ADDRESS SPACE RESOURCE
  * DELETE ADDRESS SPACE RESOURCE
  * PUT COREQUISITE RESOURCE
  * POST COREQUISITE RESOURCE
  * DELETE COREQUISITE RESOURCE
  * PUT VARIABLE RESOURCE
  * POST VARIABLE RESOURCE
  * DELETE VARIABLE RESOURCE
  * PUT EXCLUSIVE RESOURCE
  * POST EXCLUSIVE RESOURCE
  * DELETE EXCLUSIVE RESOURCE
  * PUT SHARED RESOURCE
  * POST SHARED RESOURCE
  * DELETE SHARED RESOURCE
  * PUT RESOURCE COUNT RESOURCE
  * POST RESOURCE COUNT RESOURCE
  * DELETE RESOURCE COUNT RESOURCE
  * GET RESOURCE
  * GET SCHEDULE
  * PUT SCHEDULE
  * POST SCHEDULE
  * DELETE SCHEDULE
  * GET STEPDD
  * GET TRIGGER-PREDECESSOR
  * GET TRIGGER-SUCCESSOR
  * PUT TRIGGER-SUCCESSOR
  * POST TRIGGER-SUCCESSOR
  * DELETE TRIGGER-SUCCESSOR

You can issue the following commands to retrieve/update/create the job instance related information: 
  * POST ACTIVE RESOURCE
  * GET JCL
  * PUT JCL
  * GET LIST
  * POST LIST CUSTOM
  * GET REQUIREMENTS
  * POST WAITING RESOURCES
  
You can get the CA7 historical job information with following command:
  * GET PRIOR-RUN

You can retrieve/update/create/delete the CA7 Resource Count Resource information with following command:
  * GET RESOURCE COUNT RESOURCE
  * PUT RESOURCE COUNT RESOURCE
  * POST RESOURCE COUNT RESOURCE
  * DELETE RESOURCE COUNT RESOURCE

You might want to create a Zowe CLI plug-in to accomplish the following:

* Provide new scriptable functionality for yourself, your organization, or to a broader community.
* Make use of Zowe CLI infrastructure (profiles and programmatic APIs).
* Participate in the Zowe CLI community space.

### Software Requirements
* Install [Node.js v10](Node.js V8.0 or higher LTS versions) or later on your computer.
* Install [Zowe CLI](https://www.npmjs.com/package/@zowe/cli).

### Install

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

* zowe plugins install @broadcom/ca7-for-zowe-cli@latest

### Create a Profile
You can create a CA7 profile to connect with a specific REST API. You can create multiple profiles and switch between them as needed. 

* zowe profiles create ca7-profile CA7SYSPROF --host [hostname] --port [porntnumber] --user [restUser] --password [restPass] --protocol [http/https] --base-path [apiml instance name]

For a full specification of the available options, use the --help argument:
* zowe profiles create ca7-profile --help

### Uninstall the Plug-in
* zowe plugins uninstall @broadcom/ca7-for-zowe-cli