Starting the Record Test Case dialog box

You can start the recording of a test case in 2 ways:

• from the Topaz for Total Test Perspective
  This option allows you to start the dialog box without having to switch perspectives.
• from the Troubleshooting-Xpediter-Eclipse-Debugging
  This option allows developers to record a test case while in an Xpediter debug session.

Recording test case from Topaz for Total Test

1. Perform one of the following actions:
   • Click the  Record test case using Total Test icon in the toolbar. (By default the Record test using Total Test will only appear in the Total Test perspective. For instructions on how to manage toolbar icons, see Toolbar icons)
   • Right-click a folder in the Project Explorer and select  Topaz for Total Test >Record Test Case.
     
2. Total Test displays the Record Test Case dialog box.
   
3. In the General tab, select the Xpediter Session Type and a pre-defined Launch configuration from the respective drop-down lists, 
   1. Choose from the four Session types:
      1. Xpediter Batch Debug Session
      2. Xpediter CICS Debug Session
      3. Xpediter DB2 SP Debug Session
      4. Xpediter IMS MPP Debug Session
   2. Click Edit… to edit an existing Xpediter launch configuration
   3. Click New… to create a new Xpediter debug session
      For instructions on creating and editing a debug launch configuration, see Debugging in Xpediter/Eclipse in the Topaz-Workbench-Xpediter-Eclipse-User-Guide.
4. Select the type of program to be recorded. When Record the program specified in launch configuration is selected the main program is recorded. If Record a called program is selected, the specified called program is recorded as per the number of times specified in the Maximum program executions to record.
5. Select the Run in the background (initial default) to record the test in the background or select the Record in debug mode to start Xpediter debug session for recording the test case.

   1. If Run in the background is selected:

      The test is recorded in background mode. During the recording session a progress bar and status bar will show the progress of the recording. The UI (user interface) will not be locked, so that you are free to do other work while the test case is being recorded. When running in background mode the following are not supported and will be ignored:

      • Using the Runtime Visualizer
      • Using existing breakpoint for programs
      • Log after debug session is complete
      • Scripting is limited to basic commands

   2. If Run in debug mode is selected:

      The test will run in Debug Mode. In this mode the Xpediter perspective is opened. All Total Test required breakpoints for recording the specified program are set. You can set any additional breakpoints. Click  Resume in the tool bar to start the recording. During the recording session a progress bar and status bar will show the progress of the recording. If you are recording multiple called program tests you can utilize the Resume Recording and Skip Entry Breakpoints option by right clicking when stopped at a breakpoint. This will eliminate having to press Resume after each test is recorded.

6. Select the Project to save the test under from the drop-down list.

   CLick New… to create a new project.

7. Select or specify the Folder to save the test under.
   Multiple folder levels can be entered in the folder name. For example, MyTests/SimpleDB2.
8. In the Scenario drop-down, the last scenario specified for this program is pre-selected. Otherwise, a new scenario is displayed, using the name of the program with the suffix _Scenario (<program>_Scenario), for example, CWKTVSKS_Scenario.
9. Optionally, you may specify the project's test suite into which the recorded test scenarios or context files will be copied.

10. Select which test to record, either Unit Test (Virtualized Test, default), Functional Test (Non-virtualized Test), or both.

    Warning

    Important

    The Functional Test selection is only available when using a Repository Server (Window > Preferences > Compuware > Topaz for Total Test > Repository Server with check box Use repository server.)

11. If you selected Functional Test, select the Host connection from the Functional Test Environment drop-down list. Click Configure to add or modify a connection.

    Warning

    Important

    The Unit Test Options tab includes fields and settings specific for generating Virtualized Test test cases. For detailed descriptions, see to Context Menus from Xpediter Debug Session

12. Click OK to start recording.
13. If you selected Run in background, continue with Run in Background.
    If you did not select Run in background, continue with Run in Foreground.

Run in Background

• As the test is being recorded, the user is free to perform other tasks.
• As the test is being recorded, progress bar and status bar will appear showing the progress of the recording.

• When the test is complete, a pop-up will appear containing a link. Clicking on the link takes to user to the newly created test scenario.
  Topaz for Total Test also populates the project folders with the recorded data. See Scenarios Folder for a description.

Run in debug mode

• Total Test will switch to the Xpediter perspective to launch the debug session. Provide your credentials to log in to the mainframe.
• When Xpediter is at initial breakpoint, click the  Resume icon in the toolbar. This will start recording
• As the test is being recorded, progress bar and status bar will appear showing the progress of the recording.

• When the test is complete, a pop-up will appear containing a link. Clicking on the link takes to user to the newly created test scenario.
  Topaz for Total Test also populates the project folders with the recorded data. See Scenarios Folder for a description.