OPS/MVS® Plug-in for Zowe CLI

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.

Key Features

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.
• *Display SSM parms.
• *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.

Prerequisites

• Install Zowe CLI on your computer.

• Install one of the following OPS/MVS components:

  • The REST API
  • RESTful Web Services

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.

Security Requirements

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.

Install the OPS/MVS Plug-in From a Local Package

To install the OPS/MVS plug-in to the Zowe CLI from a local package:

1. Issue the following command to install the plug-in.

   zowe plugins install @broadcom/ops-for-zowe-cli

2. 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.         

Installation Failure

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.

Create an OPS/MVS Profile

You can set up an OPS/MVS profile to avoid typing your connection details on every command.

1. 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

2. 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:

Create an OPS/MVS Profile for the Zowe API ML

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:

1. 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

2. 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:

Using the OPS/MVS Plug-in for Zowe CLI

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.

Return Codes

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

Changes in Release 5.0.0

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.

Breaking Change: Positional Arguments

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.

5.0.0 Commands

Note: The following 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)''"

5.1.0 Commands

Note: The following command is only available when you use the OPS/MVS plug-in for Zowe CLI with the OPS/MVS REST API.

Use the new show parms command to display all the SSM parameters defined to a subsystem.

Enhanced Commands in 5.0.0

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

Uninstall the OPS/MVS Plug-in From Zowe CLI

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

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