e ManagerUserGuide

USER GUIDE

e-Manager User Guide Version 5.1

Empirix, Inc.

Copyright NoticeCopyright NoticeCopyright NoticeCopyright Notice

Copyright 1997-2001 Empirix, Inc. All rights reserved. The contents of this document and the associated e-TEST suite software are the property of Empirix, Inc. and are copyrighted. No part of this document may be copied or distributed, transmitted, transcribed, stored in a retrieval system, or translated into any human or computer language, in any form, or by any means, electronic, mechanical, magnetic, manual, or otherwise, or disclosed to third parties without the express written permission of Empirix, Inc.

Printed in the United States of America

TrademarksTrademarksTrademarksTrademarks

Data Bank Wizard, e-Manager, e-Reporter, e-Spider, e-TEST, e-Tester, d-Tracker, ServerStats, TrueLoad, and Visual Scripts, are all trademarks or service marks and e-Load and e-Monitor, are registered trademarks of Empirix, Inc in the United Stats and other countries. Microsoft is a registered trademark and Windows, Visual C++, Visual J++, and Visual Basic are trademarks of Microsoft Corporation. Java is a trademark of Sun Microsystems. Pentium is a registered trademark of the Intel Corporation. All other names are used for identification purposes only and may be trademarks of their respective owners.

Empirix, Inc. 1430 Main St. Waltham, MA 02451 Ph: 781-993-8500 Fax: 781-993-8600 Web: http://www.empirix.com Email: [email protected]

USA, Japan, Singapore, UK/Europe To contact a local Empirix office, visit our Web site at www.empirix.com

Contents

Contents iiiiiiiiiiii

Contents

Preface About This Guide ..........................................................................................vii Conventions...................................................................................................viii Related Documentation.................................................................................viii

e-TEST Suite Printed Manuals ............................................................viii Other Printed Manuals ...........................................................................ix Electronic Documentation........................................................................x

Using Help .....................................................................................................xi Obtaining Technical Support ........................................................................xii

C h a p t e r 1C h a p t e r 1C h a p t e r 1C h a p t e r 1 Introduction

System Requirements .......................................................................................1 C h a p t e r 2C h a p t e r 2C h a p t e r 2C h a p t e r 2 e-Manager Basics

Installing and Starting e-Manager ..................................................................3 Jobs and Schedules...........................................................................................4 Windows...........................................................................................................4

Main Window...........................................................................................5 Current Job Window ................................................................................6 Job Editor Window ..................................................................................7 Current Schedule Window .......................................................................9 Overview of the Menu Options..............................................................11

Configuring e-Manager.................................................................................14 Configuring the Mail Server ..................................................................14 Configuring d-Tracker Account Information........................................15

Contents

iviviviv e-Manager User Guide

C h a p t e r 3C h a p t e r 3C h a p t e r 3C h a p t e r 3 Creating and Running Jobs

Creating a New Job........................................................................................17 Defining the Workspace and Scripts......................................................18 Specifying Log Messages .......................................................................19 Specifying Email Details.........................................................................21

Editing Jobs....................................................................................................22 Changing the Severity Mapping.............................................................23 Importing e-Monitor Shell Scripts.........................................................24

Running Jobs..................................................................................................25 Starting a Job Manually..........................................................................25

Viewing Job Playback Reports.......................................................................25 Submitting Bugs to d-Tracker................................................................27

C h a p t e r 4C h a p t e r 4C h a p t e r 4C h a p t e r 4 Working With Schedules

Creating Schedules .........................................................................................30 Editing Schedules...........................................................................................31 Hiding/Showing Playback Times in the Schedule........................................33 Schedule Menus.............................................................................................33

Right and Left Click Menu in an Unscheduled Block .........................33 Right Click in a Displayed Scheduled Block .........................................33 Right and Left Click in a Hidden Scheduled Block..............................34 Right Click in the Job Tree Pane ...........................................................34

Activating the Schedule..................................................................................34 C h a p t e r 5C h a p t e r 5C h a p t e r 5C h a p t e r 5 Using the Virtual User Display

Main Window Features.................................................................................37 Overview of the Menu Options..............................................................38 Overview of the Browser Pane................................................................39 Overview of the History List ..................................................................40 Overview of the Status Bar .....................................................................41

Setting Virtual User Display Limits ..............................................................42 Submitting Bugs to d-Tracker.......................................................................42

Specifying Log File Options ..................................................................43

Contents

Contents vvvv

A p p e n d i x AA p p e n d i x AA p p e n d i x AA p p e n d i x A Command Reference

Notification Variables.....................................................................................45 Script Execution and Event Triggering ........................................................46 Script File Names...........................................................................................46 Variables and Error Handling .......................................................................46 Working With Visual Scripts and VBA in e-Manager Jobs.........................48 Application Object .........................................................................................49 Result Object..................................................................................................50 ThisJob Object ...............................................................................................51 VisualScript Object ........................................................................................53 AppendLog Method......................................................................................54 CurrentResult Property..................................................................................54 CurrentScriptName Property ........................................................................55 DatabankIndex Property................................................................................55 DatabankValue Method.................................................................................56 DoRV Method ...............................................................................................56 Email Method................................................................................................58 ErrDescription Property ................................................................................59 ErrNumber Property .....................................................................................59 EventLog Method .........................................................................................60 Failure Event..................................................................................................60 FmtStr Function ............................................................................................61 GetValue Method...........................................................................................61 IterationsBegin Event ....................................................................................63 IterationsEnd Event.......................................................................................63 JobBegin Event ..............................................................................................64 JobEnd Event.................................................................................................64 JobName Property .........................................................................................65 LastDuration Property...................................................................................65 Log Method...................................................................................................65 MsgBox Method ...........................................................................................66 Notifier Property ............................................................................................66 PageBegin Event............................................................................................67 PageEnd Event ..............................................................................................68 PageTitle Property .........................................................................................68 PageURL Property........................................................................................69

Contents

vivivivi e-Manager User Guide

PlayIndex Property ........................................................................................69 RemoveValue Method ...................................................................................69 RunJob Method .............................................................................................71 RunNext Method...........................................................................................71 RunScriptNext Method.................................................................................72 SaveLog Method ...........................................................................................73 SaveScript Function .......................................................................................73 ScriptBegin Event ..........................................................................................74 ScriptEnd Event.............................................................................................74 ScriptName Property .....................................................................................75 SetNextRunDatabankIndex Method ............................................................75 SetValue Method............................................................................................76 SkipNextScript Method.................................................................................77 SNMPTrap Method .....................................................................................78 Status Property ...............................................................................................78 StopJob Method.............................................................................................79 StopSchedule Method....................................................................................79 StopScript Method.........................................................................................79 Tester Property...............................................................................................80 Workspace Property.......................................................................................80 I n d e x ..........................................................................................................81

viiviiviivii

Preface Welcome to the e-Manager User Guide. This guide explains how to get started using the features and options of e-Manager to build and schedule jobs for testing Web-based applications.

About This Guide

This guide contains the following chapters:

Chapter 1 Chapter 1 Chapter 1 Chapter 1 Introduction Introduction Introduction Introduction: provides an overview of the major features of e-Manager.

Chapter 2 Chapter 2 Chapter 2 Chapter 2 e e e e----Manager BasicsManager BasicsManager BasicsManager Basics: provides descriptions of the e-Manager windows, their features, and menu options.

Chapter 3 Chapter 3 Chapter 3 Chapter 3 Creating and RunningCreating and RunningCreating and RunningCreating and Running: explains how to use the e-Manager Wizard to create and edit jobs.

Chapter 4 Chapter 4 Chapter 4 Chapter 4 Working With Schedules Working With Schedules Working With Schedules Working With Schedules: explains how to create schedules for running jobs.

Chapter 5 Chapter 5 Chapter 5 Chapter 5 Using the Virtual User Display Using the Virtual User Display Using the Virtual User Display Using the Virtual User Display: describes the Virtual User Display main window features and menu options.

Appendix A Appendix A Appendix A Appendix A Command Reference Command Reference Command Reference Command Reference: explains the e-Manager Visual Basic objects, events, methods, and properties that are available.

Preface

viiiviiiviiiviii e-Manager User Guide

Conventions

This guide uses the following typographical conventions to identify specific items:

ConventionConventionConventionConvention DescripDescripDescripDescriptiontiontiontion

Bold Sans SerifBold Sans SerifBold Sans SerifBold Sans Serif Menu options and dialog box selections.

Sans Serif Underlined Web page hyperlinks.

Sans Serif File names and Visual Script nodes.

Fixed-Pitch type Program code.

Arrow between menu options. Select each option in sequence.

Related Documentation

The e-TEST suite includes a complete set of printed manuals, electronic manuals, and online help.

e-TEST Suite Printed Manuals

The e-TEST suite includes the following printed manuals:

Getting Started with e-TEST suite introduces the software tools in the e-TEST suite and provides step-by-step tutorials for e-Tester, e-Manager, e-Monitor, and e-Load (which includes ServerStats and e-Reporter).

e-Tester User Guide explains how to use the features and options of e-Tester to create Visual Scripts for regression/performance testing and monitoring of Web sites or applications. This guide also includes reference information for using the e-Tester Programming Interface for expanding Visual Script capabilities using Visual Basic for Applications (VBA).

Preface

Preface ixixixix

e-Tester for WAP User Guide explains how to use the Wireless Application Protocol recording features of e-Tester. This manual is a supplement to the e-Tester User Guide and is included only if you have the WAP enabled version of e-Tester.

e-Manager User Guide explains how to use the features and options of e-Manager to schedule and play back multiple Visual Scripts for regression testing of Web sites or applications. e-Manager uses the Visual Scripts developed by e-Tester.

e-Monitor User Guide explains how to use the features and options of e-Monitor to perform periodic or continuous monitoring of Web sites and related servers. e-Monitor uses the Visual Scripts developed by e-Tester.

e-Load User Guide explains how to use the features and options of e-Load to simulate multiple users accessing a Web site or application for performance testing. e-Load uses the Visual Scripts developed by e-Tester.

ServerStats User Guide explains how to use the features and options of ServerStats to monitor operational performance of a variety of application servers, Web servers, database servers and systems.

e-Reporter User Guide explains how to use the features and options of e-Reporter and WebReporter to generate graphs and reports for e-Load, e-Monitor, and ServerStats performance data.

Other Printed Manuals

In addition to the e-TEST suite documentation set, the following printed manuals are available with the d-Tracker product:

d-Tracker User Guide explains how to use the features and options of d-Tracker for issue/defect tracking and management.

d-Tracker Administrator Guide explains how to use the administrative features and options of d-Tracker for customizing the terminology and appearance of d-Tracker for your organizations requirements.

Preface

xxxx e-Manager User Guide

Electronic Documentation

The e-TEST suite download from our Web site automatically installs an Adobe Portable Document Format (PDF) version of the Getting Started with e-TEST suite manual and an e-Spider Tutorial. These documents require the Adobe Acrobat Reader, version 4.x, to open and view the .PDF files. You can download the free Acrobat Reader from the Adobe Web site: http://www.adobe.com/products/acrobat/readstep2.html.

The Getting Started with e-TEST suite PDF file is an option on the e-TEST suite StartStartStartStart menu. The e-Spider Tutorial PDF file is copied to the e-TEST suite installation directory (C:\Empirix\eTEST is the default).

The installation also includes a readme.doc file that contains release notes and the latest updates to the product documentation. The readme.doc file opens in Microsoft Wordpad when you select the Release NotesRelease NotesRelease NotesRelease Notes option on the e-TEST suite StartStartStartStart menu. Also included is an e-Monitor v5.0 to v5.1 conversion documentation (Wm50-51Conv.pdf) file that explains how to migrate existing 5.0 Shell Scripts to 5.1 jobs and schedules.

The full e-TEST suite documentation set is provided on the product CD-ROM in Adobe Portable Document Format (PDF). You can use the Acrobat Reader, version 4.x, to view, search, and print the documentation set. The e-TEST suite CD-ROM includes the Acrobat Reader application. You can install Acrobat Reader using the e-TEST suite CD-ROM setup program or by selecting ar40eng.exe in the Acrobat Reader directory. See the Adobe Web site, http://www.adobe.com, for additional information about Acrobat Reader.

The full documentation set includes the following files: e-Test Suite Getting Started.pdf e-Tester User Guide.pdf e-Tester for WAP User Guide.pdf e-Manager User Guide.pdf e-Monitor User Guide.pdf e-Load User Guide.pdf

WebReporter User Guide.pdf e-Spider Tutorial.pdf d-Tracker User Guide.pdf d-Tracker Administrator Guide.pdf readme.doc Wm50-51Conv.pdf

All of the .PDF files are in the Documentation directory of the product CD-ROM. The e-Test Suite Getting Started.pdf, e-Spider Tutorial.pdf, WM50-51Conv.pdf, and readme.doc files are installed during the e-TEST suite setup procedure. You can copy the user guide .PDF files to a local drive or open them in Acrobat Reader from the CD-ROM.

Preface

Preface xixixixi

If you downloaded the product from the our Web site and wish to receive electronic versions of the User Guides in .PDF format, please send an email message to [email protected]. Youll need the Acrobat Reader v4 to open and view the documents.

The e-TEST suite CD-ROM also includes the Microsoft Visual Basic Scripting Edition (VBScript) Language Reference documentation. You can install the files using the e-TEST suite CD-ROM setup program or by selecting vbsdoc.exe in the MS VB Script Documentation directory.

Using Help

e-Manager provides a comprehensive online help system. The help topics include step-by-step how to instructions for common tasks and a complete reference.

You can press the F1 key at any open dialog box for an explanation of the options. You can select Help Help Help Help Contents Contents Contents Contents to open the online help contents and index.

Preface

xiixiixiixii e-Manager User Guide

Obtaining Technical Support

If you have questions about e-Manager, first look in this guide, the online help, and the release notes delivered with the software.

You can also check our Web site for the latest information about upgrades and other issues at http://www.empirix.com.

If you wish to contact Empirix Web Test & Monitoring Support, please use the following contact numbers and email addresses:

Tel. North AmericaNorth AmericaNorth AmericaNorth America: (781) 993-8562 (8 a.m. to 8 p.m. EST) EuropeEuropeEuropeEurope: +44(0) 1344 725801 (8:30 - 18:00 GMT) JapanJapanJapanJapan: (03) 3791-2336

Fax. North AmericaNorth AmericaNorth AmericaNorth America: (781) 993-8600

Email North AmericaNorth AmericaNorth AmericaNorth America: [email protected] EuropeEuropeEuropeEurope: [email protected]

Key RequestsKey RequestsKey RequestsKey Requests: To request a software license key, please call (781) 993-8500 or send your request via email to [email protected].

1111

C h a p t e r C h a p t e r C h a p t e r C h a p t e r 1111 Introduction

e-Manager is a test management tool that lets you group multiple e-Tester Visual Scripts to create jobs. The jobs can be run manually at any time or you can create schedules for automatically running these jobs at specific times.

The e-Manager Wizard provides a convenient way to build e-Manager jobs. The e-Manager scheduler provides a way to schedule one or more jobs. The e-Manager Wizard includes steps for selecting Visual Scripts, setting notification options, and scheduling playback times.

FeaturesFeaturesFeaturesFeatures

Playback of multiple e-Tester Visual Scripts

Wizard for defining e-Manager jobs

Scheduler for scheduling and automatically running jobs

VBA integration for adding custom code

Job results reports in HTML Format

System Requirements

The e-Test suite has the following system requirements:

Operating System: Microsoft Windows NT 4.0, Windows 2000, or Windows 98 (e-Tester and e-Manager only). The e-TEST suite is NOT supported on Windows 95.

Recommended Memory: minimum 64 MB, 128 MB recommended

Disk Space: 100 MB

System: IBM-compatible PC with Pentium Pro or faster processor recommended

System Requirements

2222 e-Manager User Guide

[This page intentionally left blank]

3333

C h a p t e r C h a p t e r C h a p t e r C h a p t e r 2222 e-Manager Basics

This chapter explains how to install and start e-Manager and describes the e-Manager windows, their features, and their menu options.

e-Manager allows you to do the following:

Group together Visual Scripts developed using e-Tester to create jobs.

Create a schedules for running particular jobs, that, when activated, automatically execute the scripts in the jobs at the scheduled days and times.

Use email notification for error handling when problems occur with Web pages.

Import Shell Scripts created in e-Monitor 5.0.

Add Visual Basic code that executes on certain job and script events.

Installing and Starting e-Manager

There are two ways that you can install e-Manager:

http://www.empirix.com/products/download.html

Download the product (ets##.exe) from the Web site and save it to a temporary directory on your hard disk.

Unzip ets##.exe. and then run setup.exe to install Empirix e-TEST suite.

1.1.1.1. From the CD:

Insert the Empirix e-TEST suite CD into your CD-ROM drive.

In Windows, click Start Start Start Start Run Run Run Run and browse to the drive letter that corresponds to the CD-ROM drive.

Run setup.exe located in the root directory of the CD-ROM.

Jobs and Schedules


2.2.2.2. Follow the setup instructions to install the e-TEST suite.

3.3.3.3. When the installation is complete, click Start Start Start Start Programs Programs Programs Programs e e e e----TEST TEST TEST TEST suite suite suite suite e e e e----ManagerManagerManagerManager to start e-Manager.

Jobs and Schedules

e-Manager lets you create jobs using the e-Manager Wizard and to create schedules using the Current Schedule window. A job is a group of Visual Scripts in a particular order, any associated Visual Basic code, error notification information, and severity mappings. It does not have a schedule associated with it. A schedule contains the days and times that particular jobs will be run. A schedule can have more than one job associated with it.

When you run the e-Manager wizard after selecting File File File File New Job New Job New Job New Job, you can create a job. The job is saved to a file with a .mjb extension. You can edit the job by selecting Edit Edit Edit Edit Edit Job Edit Job Edit Job Edit Job to display the Job Editor window. In this window, you can change the scripts included in the job, the error notifications, and the severity mappings, that is, you can indicate when the job should pass or fail based on the type of error that occurs.

You create a schedule by selecting File File File File New Schedule. New Schedule. New Schedule. New Schedule. The schedule is saved to a file with an .mjm extension. You can edit the schedule by selecting Edit Edit Edit Edit Edit Schedule Edit Schedule Edit Schedule Edit Schedule to display the Current Schedule window. Only one schedule can be open at any one time.

Once you create a job you can run it manually, regardless of whether or not it is included in an open schedule, or automatically when you activate a schedule in which it is included.

Windows

e-Manager has several windows for creating, maintaining, and viewing jobs and schedules.

Main WindowMain WindowMain WindowMain Window Displays the menus and toolbar buttons used for the job and schedule windows. The available options are based on which window is the active window.

Windows

Chapter 2: e-Manager Basics 5555

Current Job WindowCurrent Job WindowCurrent Job WindowCurrent Job Window Displays the progress of a running job or details of the results from the last time the job was played back, including status, description, and the log.

Job Editor WindowJob Editor WindowJob Editor WindowJob Editor Window Lets you edit the job, including the scripts included, error notifications, and severity mapping. You can also use this window to test the job.

Current Schedule WindowCurrent Schedule WindowCurrent Schedule WindowCurrent Schedule Window Lets you create, edit, activate, and deactivate a schedule.

Main Window

The e-Manager main window is where you perform e-Manager activities. The main window consists of the title bar, menu options, and toolbar. The schedule and job windows are displayed within the main window. The menu options and toolbar buttons that are available differ for each window and are determined by which window is the active window.

The Title bar of the window shows the program name followed by the file name that is open in the active window.

Windows


Current Job Window

The e-Manager Current Job window is where you view the progress of a currently running job or the results from the last time the job was run. The Current Job window consists of the title bar, toolbar, status bar, and two panes: the Visual Script Job pane, and the Results Log pane, which are all fully scrollable.

Job Pane

Results Pane

Status Line

Job Pane The Job pane lists the Visual Script in the current e-Manager job with summary play back information for each Visual Script. The e-Manager jobs list include the following columns:

ScrScrScrScript Nameipt Nameipt Nameipt Name the name of the e-Tester Visual Script.

ResultResultResultResult shows if the Visual Script play back passed or failed.

Duration (Seconds)Duration (Seconds)Duration (Seconds)Duration (Seconds) shows the amount of time required to play back the Visual Script.

SummarySummarySummarySummary shows a summary of the Visual Script playback results.

Results Pane The Results log pane shows a summary of the Visual Script playback results. Entries include time stamps, Visual Script playback progress, and error information.

Windows


Results logs are automatically saved to a .slg file in the same Workspace as the Schedule and Job files. The default file name is the same name as the e-Manager job file. Periodically these files should be deleted if not needed.

You can save the results log to an ASCII file using Results Results Results Results Export Log Export Log Export Log Export Log.

You can clear the results log pane and the contents of the default file using Results Results Results Results Clear Log Clear Log Clear Log Clear Log.

You can customize log messages in the Job Editor window using Edit Edit Edit Edit Notifications Notifications Notifications Notifications.

Status Bar The Status Bar shows the current status of schedules, jobs, and Visual Scripts in e-Manager.

The status bar panes from left to right are as follows:

JobJobJobJob shows the current e-Manager job status: Idle, Running, or Stopping.

Visual ScriptVisual ScriptVisual ScriptVisual Script shows the name and page number of the currently running Visual Script.

Job Editor Window

The Job Editor window lets you view, change, and test e-Manager jobs created using the e-Manager Wizard. The Job Editor window consists of the title bar, toolbar, Job Tree pane, and Options pane, as well as a menu accessed from the toolbar.

The Job Tree shows the name of the job, the Visual Scripts in the job, the notification options, and the severity mapping. The Options pane shows the options related to the selected job tree node. They include the same

Windows


script and notification options that are in the e-Manager Wizard plus the severity mapping settings.

Initially, the Options pane displays the job details.

The Job pane lists the Visual Scripts in the job with summary play back information for each. The Job Editor toolbar includes the following buttons:

Pulldown MenuPulldown MenuPulldown MenuPulldown Menu Contains options that allow you to save jobs and edit jobs

Save JobSave JobSave JobSave Job saves the job using the same name.

Test JobTest JobTest JobTest Job starts immediate play back of the Visual Scripts in the job.

Stop JobStop JobStop JobStop Job stops play back of the Visual Scripts in the job.

Clear LogClear LogClear LogClear Log clears the contents of the Results pane and the log file.

View Job SummaryView Job SummaryView Job SummaryView Job Summary displays the latest e-Manager Job Report in a browser window.

View HTMLView HTMLView HTMLView HTML displays the Virtual User Display for viewing Visual Script page content during playback.

Edit VBAEdit VBAEdit VBAEdit VBA opens the Microsoft Visual Basic Editor for adding custom code to the Visual Script play back event handlers.

Edit ScheduleEdit ScheduleEdit ScheduleEdit Schedule makes the Current Schedule window active and opens the Edit dialog box.

Windows


Current Schedule Window

The Current Schedule window displays the scheduled jobs and lets you edit the schedule. The window consists of the Job tree in the left pane that lists the Workspaces and available jobs, a calendar that shows a grid displaying the jobs that are scheduled, and the job summary panel at the bottom that shows the playback results.

The Job Summary pane in the Current Schedule window has the following options:

Job NameJob NameJob NameJob Name displays the name of the job. Double-click on the name to display the Current Job window for any running job.

IterIterIterIter displays the iteration being run.

FailFailFailFail displays the number of failures.

WarnWarnWarnWarn displays the number of warnings.

StatusStatusStatusStatus displays the name and page number of the Visual Script currently being played back. Displays the last date and time when the job finishes.

Windows


Last ErrorLast ErrorLast ErrorLast Error indicates the last error encountered during job playback.

First ErrorFirst ErrorFirst ErrorFirst Error indicates the first error encountered during job playback.

Show Job DetailsShow Job DetailsShow Job DetailsShow Job Details displays the Current Job window.

Clear Job ResultsClear Job ResultsClear Job ResultsClear Job Results clears the Last ErrorLast ErrorLast ErrorLast Error and Worst ErrorWorst ErrorWorst ErrorWorst Error columns for the selected job.

Show Job LogShow Job LogShow Job LogShow Job Log displays the job log.

Show Job ReportShow Job ReportShow Job ReportShow Job Report displays the e-Manager job report in a browser window.

Show Job HTMLShow Job HTMLShow Job HTMLShow Job HTML displays the Virtual User Display.

The Job Summary pane also has the following right-click menu options:

Job DetailsJob DetailsJob DetailsJob Details displays the Current Job window.

Clear Job ResultsClear Job ResultsClear Job ResultsClear Job Results clears the Last ELast ELast ELast Errorrrorrrorrror and Worst ErrorWorst ErrorWorst ErrorWorst Error columns for the selected job.

Show LogShow LogShow LogShow Log displays the job log.

Show Error HTMLShow Error HTMLShow Error HTMLShow Error HTML displays the Virtual User Display.


Remove Unscheduled JobsRemove Unscheduled JobsRemove Unscheduled JobsRemove Unscheduled Jobs removes jobs that are not scheduled from the job list.

To schedule a job, click on the job in the left pane and drag it onto the schedule. To adjust the time or days, right click on the job and select Edit Edit Edit Edit ScheduleScheduleScheduleSchedule from the menu.

To view the job scheduled at a particular time, place the cursor over the time to display the job name and its path.

To view the details about a scheduled job, right click on the job and select Edit ScheduleEdit ScheduleEdit ScheduleEdit Schedule from the menu.

Refer to Chapter 4 for details about scheduling jobs.

Windows


Overview of the Menu Options

The e-Manager Main window menu has the following menus:

In addition to these menus, the Job Editor window has a menu. The following sections explain each of the menu options and shows the associated tool bar buttons.

File Menu The File menu options let you work with e-Manager Job and Schedule files. You can also import e-Monitor 5.0 Shell Scripts for use with e-Manager. The following options are available:

New JobNew JobNew JobNew Job opens the e-Manager Wizard for defining a new e-Manager job.

Open Job Open Job Open Job Open Job closes the current open job, if any, and displays the Open JobOpen JobOpen JobOpen Job dialog box for opening a saved job file.

New ScheduleNew ScheduleNew ScheduleNew Schedule opens the e-Manager Current Schedule window for defining a new e-Manager schedule.

Open Open Open Open ScheduleScheduleScheduleSchedule opens a saved e-Manager schedule in the Current Schedule window.

SaveSaveSaveSave saves the current e-Manager schedule or job using the same name. Whether the schedule or job is saved is determined by the active window.

Save AsSave AsSave AsSave As saves the current e-Manager schedule or job using a different name. Whether the schedule or job is saved is determined by the active window.

Import from eImport from eImport from eImport from e----Monitor 5.0Monitor 5.0Monitor 5.0Monitor 5.0 imports an e-Monitor 5.0 script and runs the e-manager wizard to create a new job.

ExitExitExitExit closes e-Manager.

Windows


Edit Menu The Edit menu options let you change Visual Script options, error notifications, job scheduling, severity mapping, and Visual Basic code. The following options are available:

Edit ScriptsEdit ScriptsEdit ScriptsEdit Scripts opens the Workspaces and Script screen of the Wizard in the right pane of the Job Editor window for changing the list of Visual Scripts contained in the e-Manager job.

Edit NotificationsEdit NotificationsEdit NotificationsEdit Notifications opens a dialog box in the right pane of the Job Editor window for selecting the type of error notification you want to change.

Edit Severity MappingEdit Severity MappingEdit Severity MappingEdit Severity Mapping opens the severity mapping information in the right pane of the Job Editor window for changing the severity mapping, which determines when scripts pass or fail.


Edit ScheduleEdit ScheduleEdit ScheduleEdit Schedule displays the Current Schedule window for changing the play back times for jobs.

Control Menu The Control menu options let you activate and deactivate the job schedule and start and stop the current e-Manager job. The following options are available:

Activate ScheduleActivate ScheduleActivate ScheduleActivate Schedule activates the current schedule. When scheduling is activated, e-Manager automatically plays back the Visual Scripts in the scheduled jobs at the time specified in the schedule. This button is available when the Current Schedule window is active.

Deactivate ScheduleDeactivate ScheduleDeactivate ScheduleDeactivate Schedule deactivates the currently activated e-Manager schedule. When scheduling is deactivated, playback of any open schedules is ignored. You can use the Start Job and Stop Job options to play back e-Manager jobs manually.

Windows


Results Menu The Results menu options let you clear or save the results log, open the Virtual User display, and view the HTML job report. The following options are available:

View Job DetailsView Job DetailsView Job DetailsView Job Details Hides and shows the Current Job window.

Clear LogClear LogClear LogClear Log clears the contents of the e-Manager log pane and the log file.

Export LogExport LogExport LogExport Log exports the contents of the e-Manager log pane to an ASCII file.

View Job ReportView Job ReportView Job ReportView Job Report opens a browser window and displays the latest e-Manager job report.

View HTMLView HTMLView HTMLView HTML starts the Virtual User Display for viewing Visual Script page content during playback.

Tools Menu The Tools menu options allow you to start e-Tester, configure the mail server for email notification of errors during script play back, and configure the d-Tracker server for submitting bugs.

eeee----TesterTesterTesterTester starts the e-Tester program.

Configure Mail ServerConfigure Mail ServerConfigure Mail ServerConfigure Mail Server sets up the mail server type and related information.

Configure dConfigure dConfigure dConfigure d----Tracker ServerTracker ServerTracker ServerTracker Server sets up the d-Tracker account information.

Help Menu The Help menu options let you access the e-Manager on-line help. The following options are available:

ContentsContentsContentsContents opens the help system contents.

About eAbout eAbout eAbout e----ManagerManagerManagerManager provides version, licensing, and serial number information.

Job Editor Menu The Job Editor window has a menu that is accessed by clicking on the job editor menu button. It allows you to save jobs, edit jobs, and import e-Monitor scripts into the job. The menu contains the following options:

Save JobSave JobSave JobSave Job saves the job using the same name.

Configuring e-Manager


Save Job AsSave Job AsSave Job AsSave Job As saves the job using a different name.

Edit ScriptsEdit ScriptsEdit ScriptsEdit Scripts opens the Workspaces and Script screen of the Wizard in the right pane of the Job Editor window for changing the list of Visual Scripts contained in the e-Manager job.

Edit NotificationsEdit NotificationsEdit NotificationsEdit Notifications opens a dialog box in the right pane of the Job Editor window for selecting the type of error notification you want to change.

Edit Severity MappingEdit Severity MappingEdit Severity MappingEdit Severity Mapping opens the severity mapping information in the right pane of the Job Editor window for changing the severity mapping, which determines when scripts pass or fail.


ExitExitExitExit Closes the Job Editor window.


Before you begin activating jobs, the mail server and d-Tracker account information must be configured. The mail server configuration allows email error notification when an error occurs during script playback. d-Tracker configuration allows you to enter bug reports from the Virtual User Display and the Job Report.

Configuring the Mail Server

1.1.1.1. Select ToolsToolsToolsTools Configure Mail Server. Configure Mail Server. Configure Mail Server. Configure Mail Server.

2.2.2.2. Select the type of server to use for error handling notifications.



3.3.3.3. For SMTP servers, enter the following server information.

EEEE----Mail SenderMail SenderMail SenderMail Sender specifies the email address from which error notification messages will be sent.

Outgoing Mail Server (SMTP)Outgoing Mail Server (SMTP)Outgoing Mail Server (SMTP)Outgoing Mail Server (SMTP) specifies the name of the outgoing SMTP mail server.

For MAPI servers, enter the following server information:

ProfileProfileProfileProfile specifies the email profile for a MAPI mail server. Use the BrowseBrowseBrowseBrowse button to select a previously configured MAPI profile.

4.4.4.4. Click OKOKOKOK.

Configuring d-Tracker Account Information

1.1.1.1. Select ToolsToolsToolsTools Configure d Configure d Configure d Configure d----Tracker ServerTracker ServerTracker ServerTracker Server.

2.2.2.2. Enter the URL address at which the d-Tracker server is hosted.

3.3.3.3. Enter the user name and password for the d-Tracker account.




[This page intentionally left blank.]

17171717

C h a p t e r C h a p t e r C h a p t e r C h a p t e r 3333 Creating and Running Jobs

The e-Manager Wizard walks you through the steps required to build a job that, when scheduled, plays back multiple Visual Scripts created with e-Tester. You select Visual Scripts and specify notifications for the job. After the job is created, you can edit it and create severity mappings using the Job Editor....

You can also create a job by importing an existing e-Monitor 5.0 Shell Script into e-Manager.

Creating a New Job

Click the e-Manager Wizard toolbar button. e-Manager displays the Wizard Welcome screen. If you do not want the Welcome screen to appear each time you run e-Manager, check the Skip this screen in the Skip this screen in the Skip this screen in the Skip this screen in the futurefuturefuturefuture check box.

You can use the BackBackBackBack button at any time to return to a previous screen in the Wizard.

Creating a New Job


Defining the Workspace and Scripts

The Workspace and Scripts screen of the e-Manager Wizard is where you specify the name of the job, the e-Tester Workspace, the Visual Scripts to include in the job, and the order in which they will be played.

The Workspace and Scripts screen has the following options:

Script Selection Script Selection Script Selection Script Selection lists the Workspaces with Visual Scripts that can be included in e-Manager jobs. Select the Workspace and then select the Visual Scripts. e-Manager jobs can include Visual Scripts from multiple Workspaces.

WorkspaceWorkspaceWorkspaceWorkspace select the e-Tester Workspace containing the Visual Scripts you want to include in the e-Manager job.

ScriptScriptScriptScript select the e-Tester Visual Script(s) to include in the e-Manager job. Click AddAddAddAdd or double-click the name to add the Visual Script to the Script OrderScript OrderScript OrderScript Order list.

ScrScrScrScript Ordeript Ordeript Ordeript Order lists the selected Visual Scripts and their Workspaces for the e-Manager job. Double-click the name to remove a Visual Script from the list. Click the up or down arrow buttons to change the order of the Visual Scripts in the list.

Creating a New Job

Chapter 3: Creating and Running Jobs 19191919

Data BanksData BanksData BanksData Banks enables or disables databank iteration. Databank iteration is not enabled by default for each selected script. You can enable databank iteration using all records or the current record by selecting the script, and clicking the appropriate option buttons.

Click the Next Next Next Next button to continue to the Job Notifications Log Window screen of the e-Manager Wizard.

Specifying Log Messages

The Job Notifications Log Window screen of the e-Manager Wizard is where you specify the message to write to the results log pane if an error occurs during playback of the Visual Scripts in the e-Manager job.

The Job Notifications Log Window screen has the following options:

Log Message FormatLog Message FormatLog Message FormatLog Message Format Any text entered into this edit box will appear in the log message. The e-Manager Wizard automatically creates a default error message. You can use the default message or modify the message. You can insert the following variables to pass details from the script playback to the log message.

Creating a New Job


Variable Description

%Time Returns the time the error occurred.

%curWorkspace Returns the name of the workspace in which the script is located.

%curScript Returns the name of the current Visual Script.

%curPage Returns the index of the current page of the Visual Script.

%curRecord Returns the number of the current Data Bank record being used for playback of the Visual Script.

%errNumber Returns the number of the error that occurred during playback of the Visual Script.

%errDescription Returns a description of the error that occurred during playback of the Visual Script.

Click the Next Next Next Next button to continue to the Job Notifications Email Window screen of the e-Manager Wizard.

Creating a New Job


Specifying Email Details

The Job Notifications - Email screen of the e-Manager Wizard is where you specify where to send the email and what information to include if an error occurs during playback of the Visual Script.

The mail server must be configured before notifications will be sent.

The Error Notification - Email screen has the following options:

On Job FinishedOn Job FinishedOn Job FinishedOn Job Finished specifies what information to send with the error notification.

Send HTML SummarySend HTML SummarySend HTML SummarySend HTML Summary specifies whether or not to include the HTML summary with the email notification.

Send Text LogSend Text LogSend Text LogSend Text Log specifies whether or not to include a text file version of the log with the email notification.

AddressAddressAddressAddress specifies the address to which to send the message. Separate multiple addresses either with a comma or semicolon.

SubjectSubjectSubjectSubject specifies the text to appear in the subject line of the email message.

Click the Finish Finish Finish Finish button. The Job Editor window is displayed and you will be prompted to save the job. and to schedule the job. Refer to Chapter 4 for information on creating schedules.

Editing Jobs


Editing Jobs

Once you have created a job, you can edit it using the Job Editor. The Job Editor displays the same windows as the e-Manager wizard. It also allows you to change the severity mappings and test the job.

To edit a job, make the Job Editor window active or select FileFileFileFile Open Open Open Open JobJobJobJob to open the Job Editor window.

By default, the job details are displayed in the right pane. Click on the option in the left pane that you want to change:

ScriptsScriptsScriptsScripts displays the Workspace and Scripts screen of the e-Manager wizard for changing the scripts included in the job, the script order, and data bank iteration.

NotificationNotificationNotificationNotification displays a screen for selecting whether you want to change log or email notification. This screen has the following options.

LogLogLogLog displays the error log notification screen of the e-Manager wizard for changing or adding a log message.

EmailEmailEmailEmail displays the email notification screen of the e-Manager wizard for changing or adding email notification when an error occurs.

Severity MappingSeverity MappingSeverity MappingSeverity Mapping displays the severity mappings for script errors.

TestTestTestTest executes the scripts in the job.

To save the changes select Save JobSave JobSave JobSave Job from the Job Editor menu.

Editing Jobs


Changing the Severity Mapping

The severity mapping determines the outcome result of the Visual Scripts in the job when an error occurs. Each possible visual script error is assigned a severity of pass, warning, fail, or error. When the error occurs, this result is assigned to the script.

UNKNOWN an unexpected error occurred.

FINE script playback was successful.

TIMEOUT script playback timed out.

STOPPED_BY_USER script playback was stopped by the user.

END_OF_AUTOPLAY page playback was successful.

STOPPED_BY_SHELL_USER playback was stopped programmatically by the user.

STOP_ONERR the script stopped because there was a page error and the script was set to stop on errors.

EXCEPTION an internal error occurred.

IE_DIALOG a browser dialog that was not dismissed stopped playback.

NAVIGATION_FAILED navigation to the next page failed.

FAILED_TESTS a text matching, server response, or VBA test failed.

IEI_NOT_FOUND playback failed because a browser window could not be found.

PAGE_CHANGED the page is not the one expected by the tester.

Editing Jobs


To change the severity mapping:

1. Click Severity MaSeverity MaSeverity MaSeverity Mappingppingppingpping in the left pane.

2. Click the drop down in the SeveritySeveritySeveritySeverity column and select the severity that you want to assign to the play outcome.

To assign the same severity to more than one error, click and drag over the errors that you want to change, select the severity that you want to assign, right click and select Apply to selected rowsApply to selected rowsApply to selected rowsApply to selected rows.

NoteNoteNoteNote: To restore the default severity mapping, right click to display the menu and click Reset to Default SettingsReset to Default SettingsReset to Default SettingsReset to Default Settings....

Importing e-Monitor Shell Scripts

Using the Job Editor, you can import e-Monitor 5.0 shell scripts into e-Manager jobs that you can then include in a schedule.

1.1.1.1. Select FileFileFileFile Import From e Import From e Import From e Import From e----Monitor 5.0Monitor 5.0Monitor 5.0Monitor 5.0.

2.2.2.2. Select the script you want to import and click the OpenOpenOpenOpen button. The Workspace and Scripts screen of the e-Manager wizard is displayed.

3.3.3.3. Edit the list of scripts to be included in the job, if necessary and click NextNextNextNext.

4.4.4.4. Edit the Error Log Message format, if necessary and click NextNextNextNext.

Running Jobs


5.5.5.5. Enter the email notification information and click NextNextNextNext.

6.6.6.6. Click FinishFinishFinishFinish to complete the job in the Wizard.

Running Jobs

Once you have created a job, you can run it immediately. Once you have created a schedule, you can activate the schedule so that it runs the jobs at the scheduled times.

Starting a Job Manually

Jobs can be run manually from the Job Editor window.

1.1.1.1. Create an e-Manager job.

2.2.2.2. If you want to view the pages as they are run in the Virtual User Display, select ResultsResultsResultsResults View HTML View HTML View HTML View HTML.

3.3.3.3. Select the Test Job button on the toolbar.

e-Manager plays back the Visual Scripts in the order listed.

Viewing Job Playback Reports

e-Manager displays the Job Playback Report in a browser window. This report shows the results of the last playback of the job.

1.1.1.1. Create an e-Manager job.

2.2.2.2. Run the e-Manager job.

3.3.3.3. Select Results Results Results Results View Job Report View Job Report View Job Report View Job Report.



Job reports are saved to an HTML file with the same name as the e-Manager Job file. The file is overwritten each time you run the job. You can use the browsers Print and Save As features to keep multiple versions of job reports.

Failed scripts are displayed first followed by scripts that passed. The report contains the following columns:

ScriptScriptScriptScript The name of the script.

Page Page Page Page NumberNumberNumberNumber The number of the page.

Error DescriptionError DescriptionError DescriptionError Description The reason why the script failed.

TimeTimeTimeTime The date and time that the script was run.

dddd----TrackerTrackerTrackerTracker A link to d-Tracker that allows you to submit a bug. Some fields are automatically completed based on the error.

DurationDurationDurationDuration The length of time the script, page, or job ran, in seconds.

ResultResultResultResult The result, failed, passed, or warning. A warning may occur when a script is halted before it is finished running.



Submitting Bugs to d-Tracker

1.1.1.1. View the job report by selecting Results Results Results Results View Job Report View Job Report View Job Report View Job Report.

2.2.2.2. Click on the submit link in the row of the error for which you want to submit a bug. A browser window is opened for d-Tracker and a new bug report is generated.

3.3.3.3. Complete the bug report and click SubmitSubmitSubmitSubmit.

You can also submit bugs to d-Tracker from the Virtual User Display.

29292929

C h a p t e r C h a p t e r C h a p t e r C h a p t e r 4444 Working With Schedules

e-Manager allows you to easily create schedules that include multiple jobs using the Current Schedule window. Once you have created the schedule, you can active it, causing the jobs to run at their scheduled times.

Jobs run once at their appointed time and stop. Jobs are run one at a time to completion. The next job scheduled does not run until the previous job finishes. For example, if job one is scheduled at 1:00 pm, and job two is scheduled for 2:00 pm, job two cannot start until job one finished. If job one takes more than an hour, job two is skipped.

Only one schedule can be open or activated at any one time.

Creating Schedules


Creating Schedules

To create a schedule:

1.1.1.1. Select FileFileFileFile New Schedule New Schedule New Schedule New Schedule to display the Current Schedule window.

The jobs are shown in the left pane and the schedule is shown in the right pane. Scheduled playback times are shown as white blocks preceded by a blue block in the schedule grid. The grid is divided hourly; however, the job can be scheduled at any time. The actual scheduled time is displayed in the block.

2.2.2.2. There are several ways to add jobs to the schedule:

Click on the job name and drag it onto the schedule at the time you want to play back the job.

Double click on the job name in the tree view to display the Edit dialog box.

To schedule the job at the same time for several days, drag the job to the schedule, right click on the job and select Edit ScheduleEdit ScheduleEdit ScheduleEdit Schedule to display the Edit dialog box. Change the days as necessary.

Editing Schedules

Chapter 4: Working With Schedules 31313131

3.3.3.3. Save the schedule by selecting FileFileFileFile Save or Save As Save or Save As Save or Save As Save or Save As. e-Manager uses the default name of Schedule.mjm.

Editing Schedules

The jobs are shown in the left pane and the schedule is shown in the right pane. Scheduled playback times are shown as white blocks preceded by a blue block in the schedule grid. The grid is divided hourly; however, the job can be scheduled at any time. The actual scheduled time is displayed in the block.

To edit a schedule:

1.1.1.1. Select EditEditEditEdit Edi Edi Edi Edit Schedulet Schedulet Schedulet Schedule to edit the schedule that is currently open or select FileFileFileFile Open Schedule Open Schedule Open Schedule Open Schedule to edit another schedule.

NoteNoteNoteNote: Only one schedule can be open at any one time.

The Current Schedule window displays the time in the block in which a job is scheduled. To see the name of the job, hold the mouse over the time and the path and job name are displayed.

Editing Schedules


2.2.2.2. To change an already scheduled time, right click on the time, and select Edit ScheduleEdit ScheduleEdit ScheduleEdit Schedule. The Edit Schedule dialog box is displayed.

3.3.3.3. Change the time, days, and job as necessary. Times do not have to be exactly on the hour.


NoteNoteNoteNote: You can also change a scheduled time by clicking on the blue bar in front of the time and dragging it to the new location.

5.5.5.5. You can also add jobs to the schedule in several ways:

Click on the job name and drag it onto the schedule at the time you want to play back the job.

Double click on the job name in the tree view to display the Edit dialog box.

To schedule the job at the same time for several days, drag the job to the schedule, right click on the job and select Edit ScheduleEdit ScheduleEdit ScheduleEdit Schedule to display the Edit dialog box. Change the days as necessary.

6.6.6.6. Delete playback times by right clicking on the time and selecting CutCutCutCut.

7.7.7.7. Save the schedule by selecting FileFileFileFile Save or Save As Save or Save As Save or Save As Save or Save As. e-Manager defaults to the existing name; however, you can save the schedule using a different name.

Hiding/Showing Playback Times in the Schedule


Hiding/Showing Playback Times in the Schedule

You can hide playback times in the schedule. The blocks for hidden playback times are shown in light yellow.

To hide a playback time, right click in the block and select HideHideHideHide.

To show a hidden playback time, right or left click in the hidden block and select ShowShowShowShow.

Schedule Menus

The Current Schedule window has several right and left click menus for editing and scheduling jobs. The menus differ based on whether you click in an unscheduled, scheduled block that is shown, or a scheduled block that is hidden. Following is a description of the various menus:

Right and Left Click Menu in an Unscheduled Block

PastePastePastePaste pastes the last playback time that was cut or copied into the schedule at the indicated time.

CancelCancelCancelCancel dismisses the menu without taking any action.

Right Click in a Displayed Scheduled Block

Edit ScheduleEdit ScheduleEdit ScheduleEdit Schedule displays the Edit Schedule dialog box, allowing you to change the selected playback time.

HideHideHideHide hides the selected playback time, displaying it in light yellow.

DeleteDeleteDeleteDelete deletes the selected playback time from the schedule.

CutCutCutCut deletes the selected playback time from the schedule.

CopyCopyCopyCopy copies the job into the selected playback time.



Activating the Schedule


Right and Left Click in a Hidden Scheduled Block

Edit ScheduleEdit ScheduleEdit ScheduleEdit Schedule displays the Edit Schedule dialog box, allowing you to change the selected playback time.

ShowShowShowShow displays the playback time.

DeleteDeleteDeleteDelete deletes the selected playback time from the schedule.

CutCutCutCut deletes the selected playback time from the schedule.

CopyCopyCopyCopy copies the job into the selected playback time.



Right Click in the Job Tree Pane

Refresh Job TreeRefresh Job TreeRefresh Job TreeRefresh Job Tree refreshes and redisplays the job tree.

VVVView Jobiew Jobiew Jobiew Job displays the Job Editor window for the selected job.


When you active a schedule, e-Manager automatically starts the scheduled jobs on the scheduled days and times. As the jobs are run, the results are displayed in the Job Summary window.

1.1.1.1. Open the schedule you want to activate by selecting FileFileFileFile Open Open Open Open ScheduleScheduleScheduleSchedule or make the Current Schedule window active by clicking on its menu bar.

2.2.2.2. Select ControlControlControlControl Activate Schedule Activate Schedule Activate Schedule Activate Schedule.

3.3.3.3. If you want to view the pages as they are run in the Virtual User Display, click Show Job HTMLShow Job HTMLShow Job HTMLShow Job HTML.



The Job Summary pane of the Current Schedule window displays the current and cumulative information resulting from job playback when a schedule is activated.

The Job Summary pane displays the following information for each job as it is played back:

Job NameJob NameJob NameJob Name displays the name of the job. Double-click on the name to display the Current Job window for any running job.

IterIterIterIter displays the iteration being run.

FailFailFailFail displays the number of failures.

WarnWarnWarnWarn displays the number of warnings.

StatusStatusStatusStatus displays the name and page number of the Visual Script currently being played back. Displays the last date and time when the job finishes.

Last ErrorLast ErrorLast ErrorLast Error indicates the last error encountered during job playback.

First ErrorFirst ErrorFirst ErrorFirst Error indicates the first error encountered during job playback.

Show Job DetailsShow Job DetailsShow Job DetailsShow Job Details displays the Current Job window.

Clear Job ResultsClear Job ResultsClear Job ResultsClear Job Results clears the Last ErrorLast ErrorLast ErrorLast Error and Worst ErrorWorst ErrorWorst ErrorWorst Error columns for the selected job.

Show Job LogShow Job LogShow Job LogShow Job Log displays the job log.


Show Job HTMLShow Job HTMLShow Job HTMLShow Job HTML displays the Virtual User Display.

While a script is running, you can display the Current Job window by double clicking anywhere in the grid on the Job Summary window. Double-click a second time to hide the Current Job window.

To stop playing back jobs, select ControlControlControlControl Deactivate Schedule Deactivate Schedule Deactivate Schedule Deactivate Schedule.

37373737

C h a p t e r C h a p t e r C h a p t e r C h a p t e r 5555 Using the Virtual User Display

The virtual user display lets you monitor the progress of virtual users as they are running or view errors as they occur.

Main Window Features

The main window of the virtual user display is where you select the virtual user actions to view. You can view all pages, only pages with errors, or source code.

Browser Pane

History List

Status Line



Overview of the Menu Options

The virtual user display window has the following menu options:

The following sections explain each of the menu options and shows the associated tool bar buttons.

File Menu These menu options let you open and save log files or exit the virtual user display. The following options are available:

Open LogOpen LogOpen LogOpen Log opens an existing virtual user log file.

Save LogSave LogSave LogSave Log saves the virtual user information to a log file. You can set the log file options using OptionsOptionsOptionsOptions LogLogLogLog. If the Prompt for log filenamePrompt for log filenamePrompt for log filenamePrompt for log filename check box is not selected in the Log options, the virtual user information is saved to the default file specified in the Log options. The file is saved in the current workspace. If Prompt for log filenamePrompt for log filenamePrompt for log filenamePrompt for log filename is selected, a dialog box opens for specifying a file name.

ExitExitExitExit closes the virtual user display window.

View Menu These menu options let you view specific types of virtual user action information. The following options are available:

Display Errors OnlyDisplay Errors OnlyDisplay Errors OnlyDisplay Errors Only displays only errors encountered by the virtual user.

SourceSourceSourceSource displays the source HTML for the pages accessed by the virtual user.

Clear DisplayClear DisplayClear DisplayClear Display clears the virtual user display. The page information is removed from the browser and the virtual user log information is removed from the history list. If you want to review the virtual user information at a later time, use File File File File Save Save Save Save to save it to a log file.

Navigate Menu These menu options let you navigate to specific pages accessed by the virtual user. The following options are available:

PreviousPreviousPreviousPrevious navigates to the previous page in the history list.


Chapter 5: Using the Virtual User Display 39393939

NextNextNextNext navigates to the next page in the history list.

ModeModeModeMode sets the navigation mode for the viewer window. The following options are available:

Single PageSingle PageSingle PageSingle Page view pages one-at-a-time using manual navigation.

Automatic Automatic Automatic Automatic displays pages as they are received by the viewer.

Stop Accepting New PagesStop Accepting New PagesStop Accepting New PagesStop Accepting New Pages stops the viewer from accepting new pages being accessed by virtual users.

Options Menu This menu option let you turn error logging on or off. The following option is available:

LoLoLoLogggg opens a dialog box for specifying the log file options.

Submit to DTrackerSubmit to DTrackerSubmit to DTrackerSubmit to DTracker starts d-Tracker in a browser window, allowing you to submit a bug. Use Tools Tools Tools Tools Configure DTracker Server Configure DTracker Server Configure DTracker Server Configure DTracker Server to configure the d-Ttracker account information.

Window Menu This menu option lets you make sure the virtual user display is always on top of other applications. The following option is available:

Always On TopAlways On TopAlways On TopAlways On Top when selected, the virtual user display is always on top of other applications.

Display Menu This menu option lets you select the jobs to display. The following options are available:

Switch to Time RangeSwitch to Time RangeSwitch to Time RangeSwitch to Time Range lets you select the time range to view.

Overview of the Browser Pane

The browser pane lets you view the pages being accessed by the virtual user. The SourceSourceSourceSource option on the ViewViewViewView menu lets you toggle between viewing the page or the HTML source for the page.



Overview of the History List

The history list of the virtual user display window shows the pages accessed by virtual users.

When viewing pages in manual mode, you can select any page in the history list to view the page in the browser. The blue and red buttons below the history list represent passed and failed pages. Clicking on a button displays that page in the browser.

The history list has the following columns:

LocationLocationLocationLocation shows the profile name and the page of the Visual Script being accessed by the virtual user.

URLURLURLURL shows the Uniform Resource Locator for the page being accessed by the virtual user.

ErrorErrorErrorError shows any error encountered on the page by the virtual user.

TimeTimeTimeTime shows the time of day the page was accessed by the virtual user.



Content TypeContent TypeContent TypeContent Type shows the content type specification of the page being accessed by the virtual user.

SizeSizeSizeSize shows the file size of the page being accessed by the virtual user.

DataDataDataData shows Data Bank record information if the Visual Script run by the virtual user uses Data Banks.

Overview of the Status Bar

The status bar shows information about the items in viewer history.

The left panel of the status bar of the Virtual User Display window shows the following information:

# items# items# items# items indicates the total number of items in the viewer history. Items can include HTML page downloads (e-Load, e-Monitor, and e-Manager), image downloads (e-Load only), and request header and refresh header downloads (e-Load only).

# dropped# dropped# dropped# dropped indicates the number of items that have been dropped from the history list. The Virtual User Display drops items from the history list when the number of items or number of bytes exceeds the viewers maximum number of items or maximum number of bytes limits. Items are dropped based upon First In-First Out except for items with errors. Items with errors are retained in the history unless the number of items with errors exceeds the maximum number of items or maximum number of bytes limits.

# bytes# bytes# bytes# bytes indicates the total number of bytes for all items in the viewer.

The right panel of the status bar shows the number of Virtual Users. The number of Virtual Users is used with e-Load only. When using the Virtual User Display with e-Manager and e-Monitor, the right panel value is always 0.

Setting Virtual User Display Limits


Setting Virtual User Display Limits

You can use the MaxBytes and MaxItems settings in the RSW.INI file to limit the amount of data sent to the Virtual User Display. To use the MaxBytes and MaxItems settings, you must edit the RSW.INI file and add the settings under the [HTMLViewer] section of the file, as follows: 1. Close all e-TEST suite applications.

2. Open the RSW.INI file in any ASCII text editor, such as Notepad. The RSW.INI file is located in the WINNT directory for Windows NT/2000.

3. Add the MaxBytes and/or MaxItems settings, using the following syntax: [HTMLViewer] MaxBytes=Number (defaults to 2048000) MaxItems=Number (defaults to 200)

4. Save the RSW.INI file and restart e-Manager.


1.1.1.1. Run a job and send the results to the Virtual User Display by selecting Results Results Results Results View HTML View HTML View HTML View HTML before the job is run.

2.2.2.2. Make the Virtual User Display active by clicking on it.

3.3.3.3. Right click on any line in the history list and select Submit to Submit to Submit to Submit to DTrackerDTrackerDTrackerDTracker or select Options Options Options Options Submit to DTracker Submit to DTracker Submit to DTracker Submit to DTracker.

A browser window is opened with d-Tracker and a bug report is automatically generated for you to complete and submit.

You can also submit bugs to d-Tracker from the Job Report.



Specifying Log File Options

The LogLogLogLog option on the OptionsOptionsOptionsOptions menu lets you specify the name of the log file and whether to append to the log or overwrite the log. The log file is not automatically saved to disk. You must specifically save the log file using File File File File Save Log Save Log Save Log Save Log after a virtual user run.

Selecting the LogLogLogLog menu option opens the following dialog box:

Log File NameLog File NameLog File NameLog File Name enter any name with a .VLG extension. This is the default name of the file that will be used to store the playback history if the Prompt for log filenamePrompt for log filenamePrompt for log filenamePrompt for log filename check box is not selected.

Prompt for log filenamePrompt for log filenamePrompt for log filenamePrompt for log filename when checked, the virtual user display prompts for a log filename when you select File File File File Save Save Save Save. When cleared, the virtual user display saves the log information to the file name specified by Log Log Log Log File NameFile NameFile NameFile Name when you select File File File File Save Save Save Save.

Append to log fileAppend to log fileAppend to log fileAppend to log file when selected, the virtual user display appends the current playback history to the specified log file.

Overwrite log fileOverwrite log fileOverwrite log fileOverwrite log file when selected, the virtual user display overwrites any existing log file with the current playback history.

Errors OnlyErrors OnlyErrors OnlyErrors Only when selected, only pages with errors are logged.

All DetailsAll DetailsAll DetailsAll Details when selected, all pages and page details are logged.

45454545

A p p e n d i x A p p e n d i x A p p e n d i x A p p e n d i x AAAA Command Reference

e-Manager includes several objects, events, methods, and properties that you can use to add custom programming code to e-Manager jobs and access various Visual Script playback information. They are described in the following sections.

Notification Variables

The following variables can be used for e-Manager error notification messages.

%Time - returns the time the error occurred.

%curWorkspace - returns the name of the workspace in which the script is located.

%curScript - returns the name of the current Visual Script.

%curPage - returns the index of the current page of the Visual Script.

%curRecord - returns the number of the current Data Bank record being used for playback of the Visual Script.

%errNumber - returns the number of the error that occurred during playback of the Visual Script.

%errDescription - returns a description of the error that occurred during playback of the Visual Script.

%job - returns the name of the e-Manager job.

Script Execution and Event Triggering


Script Execution and Event Triggering

Script Queue Scripts are placed in a queue in the order in which they are to be executed. When adding scripts to the queue using the runNext and runNextScript methods, the script is added after the current script and executed when the current script is finished. If you add multiple scripts, the last script added is executed first. For example, if you have the scripts A, B, and C in the queue, and you use insert script X while playing back script A, the queue order will be A, X, B, C. If you then insert script Y, again while playing back script A, the queue order will be A, Y, X, B, C. This means that if you then use skipNextScript from script A, script Y will be removed from the queue and the order will be A, X, B, C.

Event Hierarchy The VisualScript and ThisJob objects share some of the same events. In these cases, the events in ThisJob are fired before the events in VisualScript. For example, if you modify the Result object in ThisJob, it can still be modified by VisualScript.

Script File Names

Occasionally, VBA may display a file name error. VBA cannot handle Visual Script file names longer than 31 characters and that contain certain special characters. If you experience a file name error, open the Visual Script in e-Tester and save it to a new file name. Note that using Windows Explorer to change the file name may not fix the problem.

Variables and Error Handling

Variables and error handling follow the Visual Basic conventions. The following sections provide a brief overview of how to use variables and error handling. See the Microsoft Visual Basic online help topics in the VBA IDE for additional information.

Variables and Error Handling

Appendix A: Command Reference 47474747

Variables Variables are typed and must be declared. Variables can be procedure-level, module-level, or global declarations.

Declare procedure-level variables using the Dim statement in the procedure, as follows: Private Sub ThisJob_Failure() Dim myProcedureVar as String 'Other procedure code End Sub Declare module-level variables using the Dim statement in the (Declarations) procedure of the (General) object of the ThisJob, or VisualScriptName module, as follows: Dim myModuleVar as String Private Sub ThisJob_Failure() 'Other procedure code End Sub Variables can also be shared between Visual Scripts. Declare the variable using the Public statement in the (Declarations) procedure of the (General) object of your own module that you add to the project, as follows: Public myGlobalVar As String Public Function MySharedFunc (ret As String) 'Procedure code End Function

Error Handling When creating Custom VBA code, you can add custom error handling to procedures using the On Error statement, Visual Basic Err object, and e-Monitor errDescription and errNumber properties, as follows: Private Sub ThisJob_Failure() On Error GoTo ERRLBL 'Code for Sub procedure ERRLBL: 'Some Error Handling Code 'log the description Notifier.Log currentresult.errDescription End Sub

Working With Visual Scripts and VBA in e-Manager Jobs


By default, run-time errors that occur during playback of a Manager Job will invoke the Visual Script or Job Failure Events in Visual Basic.

You can use the currentResult.errDescription property to determine the type of failed tests on a Visual Script page. The errDescription property returns a String identifying the type of failure(s). The following text strings can be returned for page failures.

Failed Text Matching Test: caseName

Failed Server Response Test: caseName(min,max,timerValue)

Page pageNumber does not exist

Window not found: IE dIsplayName

No window for playback

Programmatic failure

Navigation failed

Multiple failures on a single page are concatenated into a single errDescription string separated by commas and semicolons. For example:

Failed Text Matching Test: caseName1, caseName2,caseName_n

Failed Server Response Test: caseName(min,max,timerValue); Failed Text Matching Test: caseName1, caseName2,caseName_n

Working With Visual Scripts and VBA in e-Manager Jobs

In the VBA IDE, each e-Manager job project has a job object and one or more Visual Script objects(s). The e-Monitor job can also have user-defined VBA, such as custom modules added to the project.

When you add VBA code to a job, the code is stored with the object or module in which the code was added. For example, if you add custom code to the ThisJob object, the code is associated with the overall job. If you add custom code to a Visual Script object, the code is associated with that Visual Script.

Application Object


CAUTIONCAUTIONCAUTIONCAUTION: Removing a Visual Script from a Job in the e-Manager Wizard also removes any custom VBA code associated with that Visual Script object in the VBA IDE. Save the job to a new file or export your custom VBA code before removing Visual Scripts from a job.

If you use custom VBA with e-Manager jobs and want to be able to swap Visual Scripts in the job, insert your custom VBA code in the ThisJob object or in your own module.

Application Object

Provides access to the properties and methods of the application. The following table lists the methods and properties of the Application object.

MMMMethod or Propertyethod or Propertyethod or Propertyethod or Property DescriptionDescriptionDescriptionDescription

AppendLog Appends the current results log information to the specified file.

CurrentResult Returns the properties of the result object.

DoRV Runs the Resource Validation test and returns the results.

ErrNumber Returns and sets the error number for the application object.

Notifier Allows access to the notifier methods. RunJob Runs the specified job. RunScriptNext Places the specified script next in the

queue after the current script.

SaveLog Save the results log to the current file or a new file.

SkipNextScript Skips the indicated number of scripts. StopJob Stops playback and halts the job.

Result Object


MMMMethod or Propertyethod or Propertyethod or Propertyethod or Property DescriptionDescriptionDescriptionDescription

StopSchedule Stops the currently active schedule. StopScript Stops playback of the current script

and starts the next script.

The syntax and usage for these properties and methods are in the following sections.

The application object does not have to be specified. Example

Private Sub VisualScript_ScriptEnd() 'If script fails, stop the script If currentResult.status = ZFAIL Then stopScript End If End Sub

Result Object

Provides access to the result properties for a page. The following table lists the properties and methods of the Result object. PropertyPropertyPropertyProperty DescriptionDescriptionDescriptionDescription

CurrentScriptName Returns the name of the script that is currently running.

DatabankIndex Gets the current record index of the Data Bank file.

DatabankValue Gets the current value of the specified Data Bank variable.

errDescription Sets the error description for an individual page.

JobName Returns the name of the job including the path.

LastDuration Returns the length of time the last script ran.

ThisJob Object


PropertyPropertyPropertyProperty DescriptionDescriptionDescriptionDescription

PageTitle Gets and sets the current page title. PageURL Gets and sets the current page URL. PlayIndex Returns the page number of the page

being played back.

ScriptName Gets and sets the current Script name. Status Returns the status of the current page. Workspace Returns the name of the workspace. The syntax and usage for these properties and methods are

Date post:	17-Sep-2015
Category:	Documents
Upload:	enver
View:	216 times
Download:	2 times

e ManagerUserGuide

Documents