Scenario reference settings

You can configure references or dependencies from the operations that are part of a test suite.

Note: An operation that is contained in a test suite references itself.

To import a scenario from Rational® Test Control Panel into a test suite in your project, the following conditions apply:

If a Rational® Test Control Panel user has specified that a stub within the scenario to import must run only on specific agents, those settings are discarded when you import the scenario into Rational® Integration Tester. That means the stubs affected will run on any available agents in the execution environment in Rational® Test Control Panel when you run the test suite.
If there are multiple stub definitions for an operation, only one will be imported and the others will be discarded. Th is because, unlike Rational® Test Control Panel, Rational® Integration Tester can execute only one stub for each operation.
If there are multiple configurations for a single stub, only one will be imported and the others will be discarded. This is because, unlike Rational® Test Control Panel, Rational® Integration Tester can execute only one configuration for each stub. This limitation includes agent selection criteria, so only one agent selection criterion is imported.

The following table describes how to use the controls on the References tab on the Scenario Editor window.


Control	Description
Load scenario from Rational® Test Control Panel	Clicking this button opens the Load scenario from Rational Test Control Panel window. Here, you select the configuration of a scenario that is saved on Rational® Test Control Panel to be copied into the currently selected scenario. This action overwrites any conflicting stubs that are already configured. Note: Only scenarios that are available under the domain that is configured for the project are available. If Rational® Test Control Panel is not running or if your Rational® Integration Tester project is not configured with the correct Rational® Test Control Panel URL, the Load scenario from Rational Test Control Panel button is unavailable. If any operations are not satisfied by the selected scenario, you can specify how they are handled while they are being loaded into Rational® Integration Tester. Options are as follows: Do not change: Any operations that are not assigned a stub by the scenario that is loaded from the server keep their existing selection. Clear selection: Selections are cleared for any operations that are not assigned a stub by the scenario that is loaded from Rational® Test Control Panel. Set to Live System: Selections are changed to "Live System" for any operations that are not assigned a stub by the scenario that is loaded from Rational® Test Control Panel. This means that all traffic goes to the live system. By default, only the stubs that are part of the scenario and the current project is listed. To load stubs that are published by users into a different project but are added into the same scenario in Rational® Test Control Panel, select the Include non-referenced stubs check box. Clicking OK on the Load scenario from Rational® Test Control Panel window loads any stubs for the operations that are listed on the References tab from the currently selected scenario. When you use the Load scenario option, the details of the stub configuration (from the stub in Rational® Test Control Panel) are copied to the stub in the Rational® Integration Tester scenario. When the test suite is run the stub in the scenario is launched as an external stub in the Rational® Test Control Panel Environments dashboard and can be identified by the icon it displays. The original stub in the Rational® Test Control Panel Environments dashboard which was used by Rational® Integration Tester to load in the scenario exists in Rational® Test Control Panel Environments dashboard as a server-based stub identified by the icon it displays. For information about external stubs, see Server-based stubs. Scenarios from Rational® Test Control Panel can be loaded into a test suite scenario from any environment. The scenario can then be executed in any environment if the stubs it contains exist at the correct version in that environment. Stub response time, engine, performance configuration and agent attributes are imported from the Rational® Test Control Panel scenario but other stub configuration is not imported.
Reference	This column displays any referenced operations for the tests within this scenario. Note: By default, the References window is sorted in ascending order by using the Reference column. To change the sort, or to sort by any other column, click the title of the wanted column. As you click, the sorting order cycles through ascending, descending, and no sort.
Satisfied by	If a referenced operation can be stubbed, clicking the cell under Satisfied by displays a list that contains the following options: Blank: Selecting this option means that no changes are made to anything currently running in IBM® Rational® Test Virtualization Server. Note: This option is useful if you are working with nested scenarios and you want to prevent the tearing down of any stubs in a parent scenario. Live system: Selecting this option stops any stubs that are running for this operation either in Rational® Integration Tester or in the execution environment in Rational® Test Control Panel when the scenario is executed. For other rows displayed on the References window, clicking the operation under Satisfied by displays a list that contains the following options: Blank Live system
Location & version	If a stub is selected (under Satisfied by) for a referenced operation, clicking the cell under Location & version displays a list that contains the following options: Local Remote `stub version number` A remote stub is a stub that was previously published from Rational® Integration Tester to Rational® Test Control Panel. The stub version number that is displayed refers to the version number specified when it was published. Only stub versions that are published to the domain configured for the current project are available.
Config	If a stub is selected (under Satisfied by) for a referenced operation, clicking the cell under Config displays the Stub Configuration window. In the Stub Configuration window, you can override the following configurations for the currently selected stub: Response time Agents Stub performance Test engine for the stub For more information on the configuration options, see Starting stubs: Rational® Test Control Panel method Note: The Stub Configuration window cannot be used to import or modify a stubs input tags, behavior properties, or logging settings.

After making any changes on the References tab, click OK to close the Scenario Editor window.

When you run the modified test suite that contains the modified scenario, the following happens:

Any stubs that were running on the selected environment in Rational® Integration Tester stop for any operations in the scenario where Live System or a stub was selected.
The selected environment in Rational® Integration Tester is locked if you clicked the Lock the environment in Rational® Test Control Panel check box on the References tab.
Any stub or stubs that are linked to the modified scenario are executed.
When the scenario finishes, all stubs (both remote and local) that it started are stopped.