Skip to main content
Version: Release 24.1

Topaz for Total Test Plugin

The Compuware Topaz for Total Test plugin enables execution of the Topaz for Total Test CLI with parameters required to automate testing using Release for continuous delivery.

Compuware Topaz for Total Test is a unit testing product for COBOL batch programs. It utilizes Xpediter, Compuware's mainframe application debugging and analysis tool, to collect unit test data and select the location in a COBOL program to create a unit test.

The following task type is included:

  • Topaz Total Test: Run test

Requirements

The Topaz for Total Test integration requires the following:

  • A Release server with the Remoting plugin installed.
  • The Topaz for Total Test plugin installed.
  • The Topaz Workbench CLI installed on a Windows or Linux server. Refer to the Topaz Workbench Installation Guide for instructions.
  • If the CLI client server is not in same network of z/OS host, you need a Pulse Secure VPN connection setup. Contact Compuware customer support for details.

Install and configure the plugin and Workbench CLI

  1. From the Release Plugins tab, install the Topaz for Total Test plugin (xlr-topaz-total-test-integration).

    Install Topaz for Total Test plugin

  2. Setup the Topaz Workbench CLI on a Windows/Linux server. Follow the Topaz Workbench Installation Guide for instructions to install the CLI.

Configuration

Windows configuration

  1. From the navigation pane, go to Configuration > Connections. Click the + sign to add a new Windows Host.

Setup CLI on Windows host

Linux configuration

  1. From the navigation pane, go to Configuration > Connections. Click the + sign to add a new Unix Host.

Setup CLI on Linux Machine

Topaz Client Configuration for Windows

  1. From the navigation pane, go to Configuration > Connections. Click the + sign to add a new Topaz Client Configuration.
  2. In the OS Type field, select Windows.
  3. In the Windows Client Host field, select the Windows client host you created in Windows configuration.
  4. In the Topaz Path field, select the path where Topaz for Total Test CLI is installed.
  5. In the Mainframe Server URL and Mainframe Server Port fields, enter the mainframe server IP address and port.
  6. In the Username and Password fields, enter the username and password for mainframe server.
  7. In Encryption Protocol, select the encryption protocol.

Topaz Client Configuration for Linux

  1. From the navigation pane, go to Configuration > Connections. Click the + sign to add a new Topaz Client Configuration.
  2. In the OS Type field, select Linux.
  3. In the Linux Client Host field, select the Linux client host you created in Linux configuration.
  4. In the Topaz Path field, select the path where Topaz for Total Test CLI is installed.
  5. In the Mainframe Server URL and Mainframe Server Port fields, enter the mainframe server IP address and port.
  6. In the Username and Password fields, enter the username and password for mainframe server.
  7. In Encryption Protocol, select the encryption protocol.

Create a template and task for Topaz for Total Test

  1. From the Release menu, select Templates.
  2. Click Add template > Create new template.
  3. From the newly-created template, add a task. Enter the task title (e.g., run test), select Topaz > Run complete end to end test.

Create Task for Topaz Total Test Integration

  1. In the Client field, select the client where the unit test is to be run.
  2. In the Project field, enter the Topaz for Total Test project folder path.
  3. In the Test suite or test scenario name, enter the name of a test suite from the Suites folder or the name of a test scenario from the Scenario folder.
  4. In the Target encoding field, enter the character encoding (charset) used on the target platform.
  5. In the JCL field, enter the name of a JCL file from the JCL folder.

Configure Topaz Task

  1. Start the release. When the task is run, the result will be shown in the LOG OUTPUT section, and can be downloaded as an attachment.

Download result