Operations Framework

ART Test Manager uses a concept of a project to help users manage the tasks of defining and running testing activities. A project is a top level container on which operations can be performed. Additionally, sub-containers created within a project are test groups which contain test cases.

This topic contains the following sections:

•	Project Operations

•	Group Operations

•	Test Plan Operations

Project Operations

Project operations include:

•	Create new project

•	Open existing project

•	Close opened project

•	Delete project

•	Inventory synchronization

Enter project context by clicking a project in the left tree pane. The project details will be displayed in the main operations panel, including the top action bar and project detail table.

Operations on top bar related to the project are:

•	Locate: shows the locations of the deployment and project, as well as the subdirectories under project path.

•	Dashboard: show test case execution statistics of the Project. Details are in Chapter 10.

See Group Operations for other operations.

Detail table lists project members, which are test groups. The initial groups are created automatically by analyzing the ART runtimes used in the deployed APPDIR the project has been associated with. Additional groups can be added manually. The table of test groups includes the following columns:

•	Name: group name

•	Type: group type

•	Case Count: number of test cases in the group

•	Configuration: icon to click in order to view configuration information for the group, such as ubbconfig, etc. or upload pre-/post-processing scripts for the group. “Configuration” in group table is similar.

•	Result: icon to click in order to view execution result and logs. “Result” in group table is similar.

Creating a New Project

Before creating a TM project, the application must be migrated using Tuxedo ART Workbench, packed and deployed to a location on a Linux server using the Deploy wizard in the Workbench lifecycle plug-in, and the data reloading process completed by using the same life-cycle plug-in. Refer to the ART Workbench User Guide for plug-in details. Once the deployment is done, the ART Test Manager project can be created by clicking the “Create project” button in the Context Path Bar.

The create project dialog requires three parameters as show in the figure below

•	Project Name

•	Deploy Path: The path of the migrated applications, which is created by life-cycle plug-in when migrating the application. This is referred to as APPDIR in the ART Workbench and Runtimes environment.

•	Project Path: The path of the ART Test Manager project. This project is populated by copying relevant content from the Deploy Path. Some metadata created by ART Test Manger is stored in this path as well.

Input all required information and click “Create” to create this project and display in left tree.

If the “Deploy Path” is not on the same host where ART Test Manger is installed and running, choose “Remote Project” using the check-box shown above, and provide host and connection information. The connection uses SSH and Test SSH Connection button is provided to verify the connectivity and user credentials. If the test fails, the reason for failure must be analyzed and resolved before proceeding.

Note:

Creating a remote project may take some time. If default Java version is 1.8 or higher, “Java Home" can be blank.

The SSH login password can be changed for remote project. Right click on the project in the project tree, and choose "Change SSH Login".

Open Existing Project

By clicking the folded project in left tree, the existing project can be opened. The project context will be displayed in the main operations panel.

Close and Delete Project

When right clicking the project name in left tree, the context menu will show:

•	Close Project: project in left tree will fold and its context in right panels will disappear.

•	Delete Project: removes the project from current user’s workspace, but the original deployment still exists and can be used again for creating another project by another user or the current user.

Inventory Synchronization

Migration and testing is an iterative process. To resolve some test issues changes in the migration project in ART Workbench may be required. When these changes are implemented and the project is re-deployed, the Test Manager project must be updated as well. This function provides synchronization between the deployed APPDIR and the Test Manager project and should be used whenever Deploy operation has been performed in ART Workbench lifecycle plug-in

Clicking “Sync Project” in project context menu displays the synchronize dialog. By default, all directories which relate to the user programs are selected. Clicking “Sync”, synchronizes all selected directories.

Group Operations

Test groups are containers of test cases. Each group can contain test cases that correspond to one of the three runtimes: CICS, IMS, and Batch. When the project is initially created, one to three test groups are created based on runtimes defined in APPDIR. Test units are automatically discovered for each runtime from its configuration information and are populated as test cases in each respective group. To view the groups, enter project context by clicking the project in left tree.

Operations in the project top bar related to the group are:

•	Run: run test cases in the selected groups in parallel

•	Advanced Run: run selected groups repeatedly; run groups sequentially

•	Delete: delete selected groups

•	Create Group: create a new group

For “Advanced Run”, specify the number of run times, then click “OK” to run.

Checking “Run groups sequentially”, keeps groups from running in parallel. When checked, the run order of groups can be specified by using arrow buttons on the right side of the screen, and clicking “OK” to run as shown in the following figure.

To enter group context click group in left navigation tree or click group name in the detail table.

The top bar contains operations for Tuxedo domain associated with this group. See Run Group for additional details.

The Action below top bar provides the following buttons:

•	Run, Run Repeatedly, Delete, Create Plan, Add Case will show in following sections.

•	Upload: upload user scripts of this group. Plan is similar with group

•	View: show configuration of this group

•	Dashboard: show case execution report of this group

Default Group

When creating a project ART Test Manger will automatically explore the deployment path and create default groups including all the discovered test cases. Default groups are always named as “BATCH_RT” for BATCH cases, “CICS_RT” for CICS cases and “IMS_RT” for IMS cases.

•	For “Batch_RT”, the default job list is generated by checking the file list under JCL directories listed for the JOBREPOSITORY in the jesconfig file.

•	For “CICS_RT”, the default 3270 case list is generated by analyzing the transactions.desc configuration file, the default DPL case list is generated by analyzing the programs.desc configuration file.

•	For “IMS_RT”, the default case list includes both MPP and BMP types, generated by analyzing the imstran.desc and imsapp.desc configuration files.

Default groups contain all available test cases.

Create/Delete Group

Enter project context by clicking project in left tree. In the project panel, click “Create Group”.

Input Group Name and select group type from the drop down list then click “Create”. The new group “g1” will be created as shown in the figure below.

In project panel, select group(s) to delete, then click “Delete”. The selected groups will be deleted.

Run Group

In group context, the top tool bar provides control of domain operations.

“Run” and “Run repeatedly” launches selected test cases. The arrow buttons on the right provide for ordering the test cases in a specific order they should be run. The detail view can be sorted by clicking on any column header. Clicking R button in the ordering toolbar on the right will re-order the test cases in the last specified execution or run order.

Start Execution Environment

Start the execution environment by clicking “Startup Domain”, the result can be viewed on right of the top bar, and the console window will show the log messages from domain startup.

Note:

If the domain is down, you can click "Run" or "Run repeatedly" to start the domain automatically.

Clicking “Domain up”, will show the server details.

Shutdown Execution Environment

Shutdown the execution environment by clicking “Shutdown Domain”. Clicking “Domain up” or “Domain down”, will show the server details.

Monitor Execution Environment

To monitor the execution environment, first install Test Manager agents on the test machines using Provision function from the drop down menu in the upper right corner. Refer to Install ART Test Manager Agents for details.

Click “Monitor Domain” to open the Domain Monitoring screen and view execution details information with periodic updates based on the polling interval.

•	CICS Domain: list all running tasks/transactions in current CICS region

•	Batch Domain: list batch Initiators and job metrics by JES class

•	IMS Domain: list transaction/program execution information from IMS MPP and BMP regions.

For more information about each of the three domain types, refer to Monitor Tuxedo Domain with CICS Region, Monitor Batch Domain, and Monitor Tuxedo Domain with IMS Region.

Cleanup Execution Environment

Click “Cleanup Domain” to do all necessary cleanup work for the current domain, in case of configuration changes, such as ubbconfig or setenv. Make sure the current domain is down before clicking Cleanup Domain.

Add/Remove Cases to/from Group

Click “Add Case” and select cases to be added from the available list, then click “Add”. Test cases can be filtered by entering search criteria in each of the four columns: Name, Type, Transaction, Program Name.

Select cases to delete then click “Delete”.

Add/Remove Test Plans to/from Group

Click “Create Plan” from the Group screen and input a test plan name to create a new plan.

Select test plans to delete and Click “Delete”.

Test Plan Operations

Enter test plan context by clicking the plan name in left tree or clicking in the plan entry in the detail table.

The Test Plan panel is shown below.

Create/Delete Test Plan

Refer to Add/Remove Test Plans to/from Group.

Add/Remove Cases to/from Test Plan

Similarly to group, click “Add Case” to add selected cases to a test plan, and click “Delete” to remove selected cases from a test plan.

Run Test Plan

In group context, select a plan and click “Run”. It is same as selecting all cases in plan context then clicking “Run”.

The number of time to run selected cases /plans can be specified by clicking “Run Repeatedly” and entering the number of times. Click “OK” to run.