Topaz Workbench Topaz for Total Test User Guide

When you use this space, it is presumed that,

  • Topaz for Total Test has already been properly installed, and, if necessary, customized for your specific environment.

    For details, see the separate document Topaz Workbench Installation Guide.

  • Topaz for Total Test mainframe test runner (Virtualized Test) and z/OS Agent (Non-virtualized test) modules included in the Enterprise Common Components (ECC) product have already been properly installed with current maintenance applied, and, if necessary, customized for your specific environment.

    For details, see the separate documents Enterprise Common Components Installation and Configuration Guide  and Topaz for Total Test Non-virtualized Test z/OS Agent Configuration Guide.

  • Topaz for Total Test Web Client has already been properly installed, and, if necessary, customized for your specific environment.

    For details, see the separate document Compuware Web Products Installation and Configuration Guide.

To use the features of Topaz for Total Test:

  • Compuware Host Explorer, Xpediter, Xpediter/CICS, Xpediter/Code Coverage, and Xpediter/Eclipse features must also be installed.
  • For Topaz Workbench users, the Host Explorer is included with the kit and is installed accordingly.
Important

To use Topaz Workbench, you must define an HCI connection and connect Topaz Workbench to a mainframe system. Connections are defined within the Preferences dialog box, which is available from the Window menu by selecting Preferences> Compuware>Host Explorer>Host Connections.

A Host Communication Interface (HCI) connection between the mainframe host and Topaz Workbench should have already been established during the installation and configuration of Topaz Workbench.
 Contact your system administrator to obtain specific connection credentials for your site for establishing Host Connections. (For system administrators, see to the appropriate installation guide for further information on installing and configuring the HCI.)

Performance

Note

Generating Topaz for Total Test test cases for very large programs may require increasing the memory allocated to 

Topaz Workbench

 based on the available memory of the system.
It always helps to improve the performance by providing more Java memory if it is possible. There are two ways to do this:

  1. Edit the topaz.ini file in your installation directory of Topaz Workbench (by default the path is C:\Program Files\Compuware\Topaz Workbench\eclipse):
    1. Find the entries:
      -Xms256m
      -Xmx2048m
    2. Change them to:
      -Xms512m
      -Xmx3072m
      This change increases the amount of memory available to the Topaz Workbench and Topaz for Total Test.
      When working with very large data structures, change the setting to:
      -Xms2048m
      -Xmx4096m
    3. Save the topaz.ini file and restart Topaz Workbench.
  2. Alternatively, you can create a Windows shortcut to override the memory values specified in the topaz.ini file without making changes to the executable file:
    1. Right-click the topaz.exe file in your installation directory of Topaz Workbench (by default the path is C:\Program Files\Compuware\Topaz Workbench\eclipse).
    2. Select Create Shortcut.
    3. Click Yes in the pop-up to create the shortcut on the desktop.
    4. Go to your desktop.
    5. Right-click the newly created shortcut icon.
    6. Select Properties.
    7. In the Target field of the Shortcut tab, add the following memory parameters to the end of the entry, for example:
      C:\Program Files\Compuware\Topaz Workbench\eclipse\topaz.exe -vmargs -Xms512m -Xmx3072m
    8. Click OK.
    9. Double-click the shortcut to start Topaz Workbench with the new memory parameter values.

Intended Audience

This User Guide is provided for the users of Topaz for Total Test who actually create and execute test scenarios. Its purpose is to help them in using Topaz for Total Test in an optimum way.

How This Guide is Organized

This guide contains the following:

Non-virtualized Test User Guide

Virtualized Test User Guide

Supported Technologies

Topaz for Total Test works with the following mainframe technologies:

Operating Systems

  • IBM z/OS 2.3, 2.4
  • LE libraries for the supported z/OS releases

Major Subsystems

  • IBM CICS Transaction Server for z/OS 5.4, 5.5, 5.6
  • IBM Db2 for z/OS 11.1, 12.1
  • IBM IMS Transaction and Database Servers (Virtualized Test only) 15.1, 15.2
  • IBM MQSeries (Non-virtualized Test only) 9.1, 9.2

Languages

  • IBM Enterprise COBOL for z/OS 4.2, 6.1, 6.2, 6.3
  • IBM Enterprise PL/I for z/OS (Non-virtualized Test only) 5.1, 5.2, 5.3

This section provides information about the following topics:

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*