About this task
The Environments Dashboard page also enables you to perform the following tasks:
- Override a stub’s tag setting.
- Control a stub’s behavior configuration.
- Adjust a stub’s response time.
In Rational Test Control Panel 8.0.1 or later, you can also start scenarios, which are collections of configured stubs that can be started and stopped together.
Procedure
- On the Environments Dashboard page, under
the Satisfied by column, click the stub’s Plus icon
(
). Note: If the Plus icon is unavailable, no stubs are available for the selected operation.The Start Stub window is displayed on the Environments Dashboard page.
The following table describes the controls on the Start Stub window.
Control Description Stub (page)
Use this page to select the stub, including the stub version, that you want to start.
Note: If you are using Rational Integration Tester 8.5.0.1 or later, and the Rational Test Control Panel command line or Apache Ant tasks are used to start a stub, and if no stub version information is provided, it is the latest version of a stub that is run. If you are Rational Integration Tester 8.5.0 or earlier, and the Rational Test Control Panel command line or Apache Ant tasks are used to start a stub, and if no stub version information is provided, it is the earliest version of a stub is run.For each stub listed on the page, the Documentation column displays any text that is entered for that stub on the Documentation tab of the Stub Editor in Rational Integration Tester.
After selecting a stub, you can modify its properties by using the other pages on the window.
Note: For database stubs, only one stub for each database can be run at any given time.Configuration (page)
Use this page to override the default input tag values (for each specified behavior) that were published with the currently selected stub.
Under the Input tags column, each behavior specified for the stub is listed by name.
Clicking a behavior displays its default input tag values. To override an input tag’s default value, click the behavior and then click the tag and enter a new value under Value. To force the value of the tag to be null instead of being blank, select the Null? check box.
Use the Logging option to modify the currently selected stub’s log level, which determines the level of details that will be written to the project results database. By default, a stub uses the log level that was published with it.
Log level options are as follows:- Default (as defined in the stub)
- None
- Normal
- Debug
Note: If you observe any delays with the stub response time, set the log level to None. This would avoid any delays due to the time taken to log details to the results database.Agents (page)
If you are using a version of Rational Test Control Panel earlier than 8.5.1, use this page to select the agents where the currently selected stub will run after it is started. The available agents are displayed, including host name, status, software version number, and system statistics. To select an agent, select its check box.
Note: If the currently selected stub is a database stub, it can run on only one agent at any given time.If you are using Rational Test Control Panel 8.5.1 or later, this page provides the following two options:- Use any agents
- Use specific agents
If you click Use any agents, you can specify how many agents you want to use and the attributes of any agents used. Agent attributes are used to define the capabilities of an agent or to indicate the hardware or software that is available to an agent. The default attribute of an agent is the operating system upon which it runs.
Note: To create custom attributes, you must insert additional <attribute> elements in the <agentAttributes> section of the Agent.config file, which is located in <Rational Integration Tester Agent installation directory>\config.Click Use specific agents to see the available agents including host name, status, software version number, and system statistics. However, you cannot filter or select any agents by attribute. To select an agent, select its check box. The selected stub will run on the selected agent or agents after it is started.
If you are using Rational Test Control Panel 8.5.1 or later and you select a specific agent:- If you save that stub startup setting to a scenario, when the scenario is started, Rational Test Control Panel will try to find the agent with that identifier and run the stub on that agent. However, if Rational Test Control Panel cannot find the agent with that identifier, Rational Test Control Panel will select another agent with the same host name. If Rational Test Control Panel cannot find another agent running on that host name, Rational Test Control Panel will not start the scenario.
- If you subsequently change the configuration of that agent, restart the agent, and then try to start a scenario containing the currently selected stub on that agent, Rational Test Control Panel will run the stub on any agent with the selected host name because the agent has been restarted with a different configuration.
- If you try to start more instances of the currently selected stub than there are available agents (for example, two stub instances on one agent), Rational Test Control Panel displays a message about insufficient agents and prompts you to ignore these problems and continue, which will mean that the stub will start on the available number of agents.
Response time (page)
Use this page to override the currently selected stub’s response time behavior. By default, the stub response time behavior will be as it was defined when the stub was published. You can choose to have no delay to responses, or to configure a fixed, uniform or Gaussian delay distribution.Note: The overridden settings apply to all operations in the stub.Delay distributions options are as follows:
- As published
- No delay
- Fixed
- Uniform
- Gaussian
Note: After a stub has started, its response time can be modified while it is running.Pass Through
Clicking an operation on the page displays the Action list.
Stub label (field)
This is an optional field to enter a custom label for the currently selected stub so that you can distinguish multiple running instances of the stub from each other.
Results
After the stub has started, Deploying... changes to Ready under the Status column, and you have the option to save the started stub as a scenario.
),
click Clone on the pop-up menu, modify the
agent settings on the pop-up window, and click Start stub.