Test Mode Buttons and Menus

There are buttons and icons on the TIBCO Designer toolbar used when testing process definitions. There is also a View > Test Options menu that performs the same actions as the toolbar buttons. The following table describes these buttons and menu items.

Toolbar icons for testing

Button / Icon

View > Test Options Menu Item

Description

 

 

Set Breakpoints

Brings up the Set Breakpoint dialog that allows you to specify which activities should have breakpoints. Breakpoints stop the process instance and allow you to examine process data before the process continues.

 

 

Add Input Data

Allows you to specify data for the process starter’s input schema. This icon is enabled only for process definitions that begin with a Start activity that requires an input schema.

This brings up a dialog for creating an input schema. You can use this dialog to save the input data you supply to disk.

 

 

Information icon displayed when a process engine has been started for testing process definitions.

 

Go To Started Process

This item is available only on the View>Test menu, there is no toolbar icon.

Displays the process definition with which you began this testing session.

 

Moving Ball Options

This item is available only on the View>Test menu. There is no toolbar icon.

Brings up a dialog that allows you to set whether the moving ball is displayed. The moving ball shows the current execution path.

You can also set the speed of the moving ball.

The test panel also has several buttons for manipulating the process instances during testing. The Tools > Tester menu has menu items that perform the equivalent actions as these buttons. The following table describes these buttons and menu items.

Test panel icons

Button/ Icon

Tools > Tester Menu Item

Description

 

 

Start

Allows you to load the viewed process and select any other processes you wish to load. All dependent subprocesses for any loaded processes are also loaded. The process definitions are loaded into a process engine.

Once in testing mode, your process definition cannot be changed. Return to design mode by using the Stop Testing icon if you want to add/remove/change process definitions.

 

Resume

Resumes any process instances that are paused or stopped at a breakpoint.

 

 

Stop

Kills the current engine and exits testing mode. All process instances are removed from the test panel. You must click the Start icon to start another engine if you wish to resume testing.

Note: In some situations, this button may not stop the process immediately because ActiveMatrix BusinessWorks might be waiting for the current operation to be completed. For example, if the current activity is FTP Put and you are attempting to place a very large file on the remote server, the process engine stops only after the FTP command has completed, failed, or a timeout has been reached.

 

 

Pause

Temporarily suspends the process instance. Resume the process instance with the Resume icon.

 

 

Step Over

When a process instance is paused on an activity, click this icon to step ahead in the process definition and execute the next activity.

 

 

Step Into

Once a Call Process activity is reached, this icon allows you to display the process definition of the called process and step through it.

This icon is only available when Call Process is the next activity to be processed.

 

 

Step Out

After stepping into a subprocess, this toolbar icon can be used to return to the process that called the subprocess.

This icon is only available when you are in a subprocess.

 

 

Show Current Job Location

When a process instance is paused at a breakpoint or any other point, you can change focus to display or edit other resources in your project. This icon and menu item allow you to return focus to the process definition for the currently running process instance.

Focus returns to the highlighted activity in a process where the process instance is paused.

 

 

Deletes the selected jobs marked as (completed job) from the test panel. You can only delete completed jobs.

 

 

 

Creates a new process instance for the selected process definition.

You can also select and right click a process definition name in the test panel to bring up a popup menu. This menu has the item Create a Job that performs the same function as the button in the test panel.

 

 

Stop Current Job

Stops the currently executing process instance, but does not exit test mode. This is useful if you wish to examine the data of the process instance, but you do not want to continue running the process.

There are also menu items on the popup menus for each activity in a process definition. You can access these menu items by right clicking on the activity. These are the popup menu items for activities that are used in testing: Set Breakpoint Before, Set Breakpoint After, Clear Breakpoint Before, Clear Breakpoint After, and Run To This Resource.

The Set/Clear Breakpoint Before/After menu items sets or clears the specified breakpoint on the selected activity.

The Run To This Resource menu item executes the running process instance up to the selected activity. For example, if a process instance is halted on a breakpoint, selecting an activity later in the process definition and choosing the Run To This Resource menu item resumes processing of the process instance and executes all activities between the breakpoint and the selected activity. The process instance pauses when it reaches the activity where you selected the Run To This Resource menu item.