BMC Compuware Topaz Utilities

Overview

This plugin provides access to various Compuware Topaz (R) utilities, such as submitting Jobs on the mainframe.

Prerequisites

The following are required to use this extension:

• Azure Pipelines - in Azure DevOps Services or Azure DevOps Server
• BMC Common Configuration Extension
• Topaz Workbench CLI version 19.02.01 or later. Refer to the Topaz Workbench Install Guide for instructions.
• A valid Topaz for Program Analysis, Topaz for Enterprise Data or Topaz for Total Test license
• Host Communications Interface

Installing in an Azure Pipelines - in Azure DevOps Services or Azure DevOps Server

1. Install the BMC Compuware Topaz Utilities extension according to the Azure Devops Server instructions for installing extensions. Dependent extensions will automatically be installed.
2. Install the Topaz Workbench CLI on the Azure Devops Pipeline Agent that will execute the plugin. The Topaz Workbench CLI is available in the Topaz Workbench installation package. If you do not have the installation package, please visit support.bmc.com. For Topaz Workbench CLI installation instructions, please refer to the Topaz Workbench Install Guide.

Configuring for Topaz Workbench CLI & Host Connections

In order to use Topaz utilites you will need to point to an installed Topaz Workbench Command Line Interface (CLI). The Topaz Workbench CLI will work with host connection(s) you also need to configure to use Topaz utilities.

• See Configuring for Topaz Workbench CLI & Host Connections

Submit JCL datasets or members on the mainframe

This integration allows submitting JCL datasets or members on the mainframe.

While creating the new Azure pipeline, we can add a new task "BMC Compuware Topaz Utilities" by clicking + sign on Agent Job.

This task has following parameters:

• Host connection : Select the host connection to be used to connect to the z/OS host.

Alternatively, to add a connection,click on BMC Common Configuration extension in application hub.

• User ID : Enter userID to use for logging onto the z/OS host.

• Password : In this feild, please pass pipeline variable name which is storing Password as secret in Azure pipeline. Example $(variablename). The password stored against UserId provided in UserId feild.

• Maximum condition code : Enter the maximum condition code or keep the default value. The submitting of JCL jobs will terminate if any job's return code is greater than the maximum condition code.

• Windows Topaz Workbench CLI Home : Select a option from Pre-Populated list which is configured in BMC Common Configuration extension.

• Select JCL Format : Select any option from 'Free form JCL' or 'JCL Members' according to the requirement,based on selection inputs will be presented to enter Jcl or DataSet members and jobs will be submitted based on the inputs provided.

• JCL(Enter free-form JCL): Enter JCL statements.

• Dataset(member): List JCL dataset / dataset(member)s, each on a separate line.

Click Save.

Run the pipeline, which submits each specified JCL dataset or member on the mainframe.

Product Assistance

BMC provides assistance for customers with its documentation, the BMC Support Center web site, and telephone customer support.

BMC Support Center

You can access online information for BMC products via our Support Center site at https://support.bmc.com. Support Center provides access to critical information about your BMC products. You can review frequently asked questions, read or download documentation, access product fixes, or e-mail your questions or comments. The first time you access Support Center, you must register and obtain a password. Registration is free.

Contacting Customer Support

At BMC, we strive to make our products and documentation the best in the industry. Feedback from our customers helps us maintain our quality standards. If you need support services, please obtain the following information before calling BMC's 24-hour telephone support:

• The Azure pipeline job output that contains any error messages or pertinent information.

• The name, release number, and build number of your product. This information is displayed in the installed extensions page. Apply filter: BMC in order to display all of the installed BMC extension.

• Environment information, such as the operating system and release on which the Topaz CLI is installed.

You can contact BMC in one of the following ways:

Web

You can report issues via BMC Support Center: https://support.bmc.com.

Note: Please report all high-priority issues by phone.

Corporate Web Site

To access BMC site on the Web, go to https://www.bmc.com/. The BMC site provides a variety of product and support information.