Hitachi

JP1 Version 11 JP1/Performance Management - Agent Option for Service Response Description, User's Guide and Reference

4.5.2 Defining IE scenarios (creating IE scenario files)

In PFM - Agent for Service Response, you can define an IE scenario and save the definitions as an IE scenario file by using the IE Recorder. For details about IE Recorder, see 7.3 IE Recorder windows.

The following shows the procedure for defining an IE scenario. For details about each procedure, see the indicated sections.

Figure 4‒3: Definition procedures for measuring IE scenarios

[Figure]

The following shows how to use the IE Recorder to create an IE scenario file.

Reference note:

In the IE Recorder, you can use the icons on toolbar, as well as the command buttons on menu bar. For details about the icons on the toolbar in the IE Recorder (main) window, see 7.3.1 IE Recorder (main) window.

Organization of this subsection

(1) Starting the IE Recorder

The following shows the procedure for starting the IE Recorder.

  1. Logging on by the account for the measurement to the host where you create IE scenario files.

  2. Specify a value for ie_rec_browser_mode in the IE Recorder action condition definition file (jpcvierec.conf).

    For details about the value of ie_rec_browser_mode, see ie_rec_browser_mode in the Table 8-31 Definition in the IE Recorder section.

  3. From Windows Start menu, choose All Programs, Performance Management, Agent Option for Service Response, then IE Recorder.

    The IE Recorder (main) window appears.

To Page Top

(2) Setting the Internet Options

If you create new IE scenarios, you set the Internet Options to record an IE scenario and define the environment for measurement.

The following shows the procedure for setting the Internet Options.

  1. In the IE Recorder (main) window, from the Tools, choose the Internet Options.

    The Internet Options window appears.

  2. In the Internet Options window, define the environment for recording and measuring IE scenarios.

  3. Click the OK button.

To Page Top

(3) Recording the IE scenario

In the IE window section of the IE Recorder (main) window, you record the browser operations performed as an IE scenario.

The following shows the procedure for recording the IE scenarios.

  1. In the IE Recorder (main) window, from the File, choose the New. A new IE scenario file is created.

  2. From the Action, choose the Record.

    It is started to record the IE scenario.

  3. Enter the URL of the monitoring target Web page in the Address bar, and press the Enter key.

    The Web page is displayed in the IE window section.

  4. In the IE window section, conduct operations in the displayed Web page.

    The browser operations performed are recorded as an IE scenario. The recorded information is displayed in the Operation list. You can record not only a single operation but also a series of tasks consisting of multiple operations as an IE scenario.

  5. From the Action, choose the Stop.

    It is stopped to record the IE scenario.

To Page Top

(4) Setting the scopes

You can define a series of operations in an IE scenario as a scope and measure the performance information within that scope. In this case, set the start and end scopes in IE scenarios.

The following shows the procedure for setting and deleting start scopes and end scopes.

(a) Setting start scopes

The following shows the procedure for setting start scopes:

  1. In the Operation list in the IE Recorder (main) window, choose the operation that you want to set as a start scope.

  2. From the Scope, choose the Set Start Scope.

    The Start Scope Settings window appears.

  3. Select the scope ID that you want to set as a start scope in the Start Scope Settings window.

  4. Click the OK button.

    The start scope operation in the Operation list is displayed in the following way: START [scope-name].

(b) Setting end scopes

The following shows the procedure for setting end of a scope.

  1. In the Operation list in the IE Recorder (main) window, choose the operation that you want to set as an end scope.

  2. From the Scope, choose the Set End Scope.

    The End Scope Settings window appears.

  3. Select the scope ID that you want to set as an end scope in the End Scope Settings window.

  4. Click the OK button.

    The end scope operation in the Operation list is displayed in the following way: END [scope-name].

(c) Deleting the Scopes

The following shows the procedure for deleting the start and end scopes.

  1. In the Operation list in the IE Recorder (main) window, select the start scope (SCOPE scope ID(scope name)) or the end scope (SCOPE scope ID(scope name)) that you want to delete.

  2. From the Scope, choose the Delete Scope.

    The setting of the start and end scopes is deleted.

To Page Top

(5) Setting the IE scenario options

To customize the options of the recorded IE scenario, you can replay and measure IE scenarios to suit your needs.

(a) Identifying the Tags

After you record the IE scenario, the positions and attributes of the operation target tags in the HTML file may be changed due to the layout change of the target site. In that case, PFM - Agent for Service Response provides the way for you to customize how to identify the operation target tags, without changing the IE scenarios.

The following shows the procedure for specifying how to identify the operation target tags.

  1. In the IE Recorder (main) window, from the Edit, choose the Operation Settings.

    The Operation Settings window appears.

  2. In the Operation Target page in the Operation Settings window, customize how to identify the tags for recording Web pages, click the OK button.

The following shows how to identify the operation target tags:

Inner text:

Identifies the operation target tags targets by the inner text that is surrounded by the start and end tags. If you select the Inner text, the tag that has the specified inner text is selected and operated when replaying the IE scenario.

The following example shows the inner texts in the HTML file and how it is displayed:

Figure 4‒4: Example of the Inner texts in the HTML File and How it is Displayed

[Figure]

In the HTML file of the Figure 4-4, if you specify the inner text Hitachi, Ltd. of the a tag as the filter condition, the tag with the inner text Hitachi, Ltd. is selected and operated when replaying the IE scenario.

The following example shows the inner texts in the HTML file and how it is displayed, after you modify the HTML file:

Figure 4‒5: Example of the Inner texts in the HTML file and How it is Displayed (the HTML File Modified)

[Figure]

In this case, even when you change the position of the tag with the inner text Hitachi, Ltd. as in the Figure 4-5, PFM - Agent for Service Response search the tag with the specified inner text Hitachi, Ltd. and replays the operation without re-recording the IE scenario, if you select Inner text.

Attributes:

Identifies the operation target tags by the attribute value of the tag.

If you specify the attribute, the tag with the specified attribute value is selected and operated when replaying the IE scenario. If there are multiple tags with the specified attribute value, the tag that appears first in the HTML file is selected and operated.

The following example shows the attributes in the HTML file and how it is displayed.

Figure 4‒6: Example of the Attributes in the HTML File and How it is Displayed

[Figure]

In the Figure 4-6, if you specify the inner text HTML version of the a tag as the filter condition, PFM - Agent for Service Response cannot replay the IE scenario correctly, because there are multiple a tags with the inner text HTML version. If you specify the attribute href of the a tag as the filter condition, the tag with the attribute href and appears first in the recorded IE scenario is selected and operated when replaying the IE scenario.

Tag position:

Identifies the operating target tags by the position of tag with the same inner text or attribute value in the HTML file.

If you specify the tag position, the tag in the specified position is selected and operated when replaying the IE scenario.

If there are multiple tags with the same inner texts or attribute values in the HTML file, the recorded IE scenario may be replayed incorrectly. In that case, if you specify the tag position, the IE scenarios will be replayed correctly.

When there are multiple tags with the same inner texts and attribute values in the HTML file, you combine inner texts, attributes, and tag positions to identify the operation target tag. When you combine these conditions, the tag that matches all the conditions is selected and operated when replaying the IE scenario.

When you specify the tag position, you specify nth match among the tags that meet the specified conditions searched from the top in the HTML file.

For details about setting items, see 7.3.2(2) Operation Target page.

(b) Response Determination

When you replay or measure IE scenarios, you can check whether HTTP responses are correct. For each operation, you specify the response determination condition for the HTTP responses. The all response pages for each operation are checked. You specify the character strings in the HTML file as the response determination conditions.

If the HTML file that meets the specified conditions is displayed, PFM - Agent for Service Response judges the response to be correct and continues on replaying or measuring. If the HTML fie that does not meet the specified conditions is displayed, PFM - Agent for Service Response stops replaying or measuring.

The following shows the procedure for setting the response determination conditions.

  1. In the Operation list in the IE Recorder (main) window, choose the operation that you set as a start scope.

  2. From the Edit, choose the Operation Settings.

    The Operation Settings window appears.

  3. In the Response Determination page in the Operation Settings window, customize the response conditions for recording the Web page, click the OK button.

For details about setting items, see 7.3.2(3) Response Determination page.

To Page Top

(6) Checking the IE scenario

To replay the recorded IE scenario, you can check whether the scenario is measured correctly. PFM - Agent for Service Response provides the following functions to check IE scenarios:

The following explains each function:

(a) Replaying IE scenarios

You can replay IE scenarios to the breakpoint or the end of the recorded operations.

In the IE Recorder (main) window, from the Action, choose the Replay, and then start replaying the IE scenario.

In the IE Recorder (main) window, from the Action, choose the Stop, and then stop replaying the IE scenario.

If the recorded IE scenario is not replayed correctly, take the actions listed below:

  • In the IE Recorder (main) window, from the Edit, choose the Operation Settings, in the Operation Target page of the Operation Settings window, change the settings.

  • Check whether the operations that cannot be recorded in the IE scenario, and if they exist record the IE scenario again to exclude these operations.

For details about the operations that cannot be recorded, see 5.2.3(3) Notes on recording and replaying the IE scenarios.

(b) Replaying by step IE scenarios

You can replay the IE scenario step by step to test IE scenario measurement.

In the IE Recorder (main) window, from the Action, choose the Replay by Step, and then IE scenario is replayed step by step.

(c) Setting breakpoints

When replaying the IE scenario, you can suspend the replay at the point set as a breakpoint to check the operations or set scopes.

The following shows the procedure for setting the breakpoints.

  1. In the Operation list in the IE Recorder (main) window, choose the operation that you suspend.

  2. From the Action, choose the Set Breakpoint.

The following shows the procedure for canceling the breakpoints.

  1. In the Operation list in the IE Recorder (main) window, choose the operation that you set as a breakpoint.

  2. From the Action, choose the Delete Breakpoint.

(d) Testing measurements

The IE scenario is replayed to the end of the recorded operations. After its replaying terminates, the result of replaying IE scenario in the Replay Report window is displayed. For details about the Replay Report window, see 7.3.8 Replay Report window.

In the IE Recorder (main) window, from the Action, choose the Test Measurement, and the IE scenario measurement test starts.

If the recorded IE scenario is not replayed correctly, you take appropriate actions based on the displayed information of the Replay results in the Replay Report window.

To Page Top

(7) Saving the IE scenario

The following shows the procedure for saving the recorded or edited IE scenario.

  1. In the IE Recorder (main) window, from the File, choose the Save As.

    The Save As window appears.

  2. Specify a file name to the File name, and click the Save button.

    The information of the IE scenario is saved into the IE scenario file.

Note:

If you save the IE scenario file in the folder other than jp1pc\agtv\probe\iescena, you must copy iescena.dtd to the destination folder.

To Page Top

Copyright (C) 2016, 2017, Hitachi, Ltd.

Copyright (C) 2016, 2017, Hitachi Solutions, Ltd.