The Broadcom® OPS/MVS® Plug-in for Zowe CLI lets you interact with OPS/MVS automation elements, enabling efficient automation administration and resource management from a single command-line interface. The plug-in also lets you include automation administration and resource management in workflows to foster continuous integration.
Using the plug-in, you can benefit from the following OPS/MVS features:
- Display the status of specific automation rules and *rule sets.
- Enable and disable specific automation rules.
- Display the state of specific System State Manager (SSM) resources.
- Start and stop specific SSM resources.
- *Display the status of a REST API server.
- *Display the log names.
- *Display the subsystems.
- *Display RDF tables.
- *Execute a REXX program.
- *Execute a operator command.
- *Create a generic AOF event for API rules processing.
Note: * Indicates only available if you are using the plug-in with the OPS/MVS REST API.
-
Install Zowe CLI on your computer.
-
Install one of the following OPS/MVS components:
To use the plug-in with multiple OPS/MVS instances running on different systems, install and configure the RESTful Web Services component or the REST API to one OPS/MVS instance on each system. When you have multiple instances of OPS/MVS running on a single system, only one instance of the RESTful Web Services component or the REST API is required.
Note: To use the OPS/MVS Plug-in for Zowe CLI with the Zowe API Mediation Layer (API ML), you must use the OPS/MVS REST API. For more information, see Create an OPS/MVS Profile for the Zowe API ML.
To issue OPS/MVS commands through the plug-in, you must be authorized for those commands through OPS/MVS security. For more information, refer to the article REST API Security.
To install the OPS/MVS plug-in to the Zowe CLI from a local package:
-
Issue the following command to install the plug-in.
zowe plugins install @broadcom/ops-for-zowe-cli
-
Issue the following command to validate the installed plug-in.
zowe plugins validate @broadcom/ops-for-zowe-cli
After the installation process completes, it validates that the plug-in was installed correctly and that the names of its commands, options, and arguments do not conflict with that of any other plug-ins that you have installed into your Zowe CLI implementation.
When the validation process is successful, the following message displays:
_____ Validation results for plugin '@broadcom/ops-for-zowe-cli' _____
This plugin was successfully validated. Enjoy the plugin.
If the validation process fails, a failure message displays. You can troubleshoot the installation by addressing the issues that the message describes. You can also review the information contained in the log file that is located in the Zowe CLI home directory.
You can set up an OPS/MVS profile to avoid typing your connection details on every command.
-
Gather the following data:
- The host name of the LPAR on which OPS/MVS Web Services or the OPS/MVS REST API server is running
- The port number for OPS/MVS Web Services or the OPS/MVS REST API server
- A user name that has authority to access OPS/MVS Web Services or the OPS/MVS REST API server
- The password to the account assigned to the user name
-
Do one of the following:
-
Edit the global configuration file located at
~/.zowe/zowe.config.json
by issuing the following command.zowe config edit --gc
-
Use
zowe config set profiles
commands to set the OPS/MVS profile. In the examples below,ops
is the profile name.zowe config set profiles.ops.properties.port 1234 --gc zowe config set profiles.ops.properties.user user --gc zowe config set profiles.ops.properties.password password --gc zowe config set profiles.ops.properties.reject-unauthorized true or false --gc zowe config set profiles.ops.properties.protocol http or https --gc zowe config set profiles.ops.properties.subsystem sys1 --gc zowe config set profiles.ops.properties.rest-api true or false --gc
-
The following image shows an OPS/MVS profile inside a global configuration file:
Important: The Zowe API Mediation Layer (API ML) can only be used with the OPS/MVS REST API, which must be registered with the API ML server used in the profile.
To create an OPS/MVS plug-in profile for the Zowe API ML:
-
Gather the following data:
- The host name of the LPAR on which the API ML is installed
- The API ML server port number
- A user name that has authority to access the registered OPS/MVS REST API server
- The password to the account assigned to the user name
- The base path for your API ML instance. The first part of the base path is the service ID of the REST API server that is defined to the API ML server, for example:
<service_id>/api/v1
-
Follow the directions in step 2 of Create an OPS/MVS Profile, including the additional data you gathered in step 1 of this section.
The following image shows an OPS/MVS profile for the Zowe API ML inside a global configuration file:
For details about the commands, actions, and options in this plug-in, refer to the Zowe CLI Help.
When Zowe CLI is installed, you can display Zowe CLI Help for the OPS/MVS plug-in by doing one of the following from a command line:
-
Enter
zowe ops
to display a summary of available commands and options for the plug-in in the command prompt window. -
Enter
zowe ops --hw
to display Zowe CLI web help for the plug-in in a browser window.
When you enter a command using the OPS/MVS Plug-in for Zowe CLI, you will receive one of the following return codes:
0 - Execution succeeded
1 - Execution failed
This section describes changes that have been made to the OPS/MVS Plug-in for Zowe CLI since the previous release (4.1.2).
Release 5.0.0 includes a breaking change and support for the OPS/MVS REST API.
The commands start resource
and stop resource
have the following positional arguments.
In a breaking change, tablename
is now a required positional argument.
resourcename (string)(optional)
The name of the resource.
tablename (string)(required)
The name of the table that contains the resource.
Note: The following new commands are only available when you use the OPS/MVS plug-in for Zowe CLI with the OPS/MVS REST API.
show ruleset
Use the new show ruleset
command to display the status of a specific automation rule set.
show logname
Use the new show logname
command to display the logs defined to a subsystem.
show status
Use the new show status
command to display the status of the REST API server.
show subsystem
Use the new show subsystem
command to display the subsystems running on an OPS system.
execute rexx
Use the new execute rexx
command to execute the specified OPS/MVS REXX program.
Note: There is a bug in @zowe/cli v2 that strips the single quotes when specifying a program name that requires single quotes to delimit the fully qualified dataset name. The work-around is to specify two single quotes. Example: "''fully.qualified.dataset(member)''"
Note: The following enhanced commands are only available when you use the OPS/MVS plug-in for Zowe CLI with the OPS/MVS REST API.
show resource
Use the show resource
command to show the current and desired state of all resources in the table MYTABLE for the OPSS subsystem, as shown in the following example:
zowe ops show resource * --table MYTABLE --subsystem OPSS
Use the show resource
command to show the current and desired state of all resources in all tables for the OPSS subsystem, as shown in the following example:
zowe ops show resource * --subsystem OPSS
show rule
Use the show rule
command with the syntax shown in the following example to display the status of all rules in rule set OPSRULES for the OPSS subsystem:
zowe ops show rule OPSRULES * --subsystem OPSS
Use the show rule
command with the syntax shown in the following example to display the status of all rules in all rule sets for the OPSS subsystem:
zowe ops show rule * * --subsystem OPSS
To uninstall the plug-in from Zowe CLI, issue the following command:
zowe plugins uninstall @broadcom/ops-for-zowe-cli