@broadcom/ca7-for-zowe-cli/README.md

CA 7 Workload Automation Plug-in for Zowe CLI

# 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 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

Validate the installed plug-in:
```
$ zowe plugins validate @broadcom/ca7-for-zowe-cli
```

### Create a Profile

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

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

To create an CA7 profile through configuration command, issue the following command and provide the above details as prompted:
```
$ zowe config init
```


For a full specification of any Zowe command, use the --help argument:
```
$ zowe <<command>> --help
```

### Uninstall the Plug-in
```
$ zowe plugins uninstall @broadcom/ca7-for-zowe-cli
```
To install the CA7 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/ca7-for-zowe-cli
```