Académique Documents
Professionnel Documents
Culture Documents
Corporation. All other names are used for identification purposes only
and may be trademarks of their respective owners.
Empirix, Inc.
Contents
Contents
Preface
About This Guide ...........................................................................................ix
Related Documentation....................................................................................x
e-TEST Suite Printed Manuals ...............................................................x
Other Printed Manuals ...........................................................................xi
Electronic Documentation.......................................................................xi
Conventions...................................................................................................xiii
Using Help ...................................................................................................xiii
Obtaining Technical Support .......................................................................xiv
Chapter 1
Introduction
Feature Highlights...........................................................................................2
Sophisticated Error Reporting.........................................................................2
System Requirements .......................................................................................3
Chapter 2
e-Monitor Basics
Installing and Starting e-Monitor....................................................................6
e-Test Console..................................................................................................7
e-Monitor Windows ........................................................................................7
Job Editor Window Features ...................................................................8
Toolbar...............................................................................................9
Results Pane .......................................................................................9
Current Schedule Window Features ......................................................10
Job Summary Pane Features ...........................................................12
Current Job Window Features ...............................................................13
Status Bar .........................................................................................15
Contents
iii
Contents
Chapter 4
iv
Contents
Appendix A
Command Reference
Notification Variables.....................................................................................43
Script Execution and Event Triggering ........................................................44
Script Queue ....................................................................................44
Event Hierarchy...............................................................................44
Script File Names...........................................................................................44
Variables and Error Handling .......................................................................44
Variables ...........................................................................................45
Error Handling................................................................................45
Working With Visual Scripts and VBA in e-Monitor Jobs..........................46
Application Object .........................................................................................47
Result Object..................................................................................................48
ThisJob Object ...............................................................................................49
VisualScript Object ........................................................................................51
AppendLog Method......................................................................................52
ClearLog Method ..........................................................................................52
CurrentResult Property..................................................................................53
CurrentScriptName Property ........................................................................53
DatabankIndex Property................................................................................54
DatabankValue Method.................................................................................54
DoRV Method ...............................................................................................55
Email Method ................................................................................................57
ErrDescription Property ................................................................................58
ErrNumber Property .....................................................................................58
EventLog Method .........................................................................................59
Failure Event..................................................................................................59
FmtStr Function ............................................................................................60
GetValue Method...........................................................................................60
IterationsBegin Event ....................................................................................61
IterationsEnd Event.......................................................................................62
JobBegin Event ..............................................................................................62
JobEnd Event.................................................................................................63
JobName Property .........................................................................................63
LastDuration Property...................................................................................64
Log Method ...................................................................................................64
MsgBox Method ...........................................................................................65
Contents
Contents
vi
Contents
Appendix C
Contents
vii
Contents
viii
Preface
Welcome to the e-Monitor User Guide. This guide explains how to get
started using the features and options of e-Monitor for monitoring Web
sites or applications.
This guide is intended for Web test engineers who will be monitoring site
availability and reliability. The guide does require an understanding of
software or Web application testing concepts. Test engineers using
e-Monitor should be familiar with the concepts of regression testing, load
testing, scalability testing, and operational monitoring.
The monitoring paradigm of e-Monitor does not require any
programming experience to develop Visual Scripts, jobs, or schedules.
However, the advanced programmability features available in e-Monitor
do require experience with programming languages such as VBScript and
Visual Basic. The programming sections of this manual assume that you
understand programming concepts in VBScript and Visual Basic.
e-Monitor.
Chapter 2 ee-Monitor Basics: provides descriptions of the e-Monitor
main window features and menu options.
Chapter 3 Creating and Running Jobs: provides instructions and
instructions on creating
ix
Preface
Appendix B
Related Documentation
The e-TEST suite includes a complete set of printed manuals, electronic
manuals, and online help.
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.
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 Start menu. The e-Spider Tutorial PDF file is copied to the
e-TEST suite installation directory (C:\RSW is the default).
xi
Preface
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 Notes option
on the e-TEST suite Start 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 job and schedules.
The full e-TEST suite documentation set is provided on the product CDROM 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:
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.
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 webtest_support@empirix.com. 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.
xii
Conventions
This guide uses the following typographical conventions to identify
specific items:
Convention
Description
Sans Serif
Fixed-Pitch type
Program code.
Using Help
e-Monitor 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 Contents to open the on-line help contents
and index.
xiii
Preface
Fax.
Key Requests: To request a software license key, please call (781) 9938500 or send your request via email to keys@empirix.com.
xiv
Chapter 1
Introduction
Your Web site is online and available to your customers twenty four hours
a day, seven days a week. The Web is an electronic door to your business
and is rapidly becoming a focal point for your customers to gain access to
your products and services.
Web sites can be comprised of a mix of software technologies and back-end
database systems, including HTML, Active-X, Java, and ASP. Any
combination of hardware or software problems can cause a Web site to fail.
e-Monitor is designed to provide continuous, comprehensive testing for
Web sites while they are in use. e-Monitor acts like a quality assurance
engineer, constantly testing and reporting failures in real time. e-Monitor
is capable of executing any sequence of Visual Scripts on a scheduled
basis, providing comprehensive regression testing, around the clock
while leveraging your investment in Visual Scripts.
e-Monitor is a companion product to e-Tester. It runs from the e-TEST
Console and allows you to automate play back of e-Tester Visual Scripts.
Feature Highlights
Feature Highlights
e-Monitor offers the following advantages for Web-based application
testing:
System Requirements
System Requirements
The e-Test suite has the following system requirements:
Chapter 1: Introduction
System Requirements
Chapter 2
e-Monitor Basics
This chapter explains how to use e-Monitor to schedule and automate
play back of e-Tester Visual Scripts. It explains how to install and start the
program and the features of the main window.
e-Monitor is tightly integrated with e-Tester. e-Monitor allows you to
group Visual Scripts together into jobs, then schedule when and how
often to run one or more jobs.
e-Monitor allows you to do the following:
Use the scheduling capabilities to specify when and how often a Jobs
should run.
1.
2.
3.
Download the product (ets##.exe) from the Web site and save it
to a temporary directory on your hard disk.
In Windows, click Start Run and browse to the drive letter that
corresponds to the CD-ROM drive.
e-Test Console
e-Test Console
e-Monitor runs from the e-TEST Console, along with e-Load,
ServerStats, and e-Reporter.
The toolbars that are displayed in the Console window are based on the
application with which you are working and can be selected by clicking
the right mouse button and choosing the toolbar you want.
This chapter explains the e-Monitor menus and interface. Refer to the
appropriate manuals for the other menus and features.
e-Monitor Windows
The e-TEST Console main window is where you work with e-Monitor to
create jobs and schedules, activate and deactivate jobs, and view results of
jobs that have run. Following is a picture of the e-TEST Console with
only the toolbar buttons for e-Monitor displayed, and no open jobs or
schedules.
e-Monitor Windows
comprise the job, error notifications, and severity mapping. You can also
manually run the job from this window.
Current Schedule Window lets you create and edit a schedule for
running jobs. It includes the Job Summary pane for displaying the results
of jobs that have been run.
Current Job Window lets you view the Visual Scripts and summary play
back information for the scripts in the current e-Monitor job. You can use
this window to view the progress of results of Visual Scripts being run by
the current jobs in a schedule.
e-Monitor Windows
Toolbar
The Job Editor toolbar includes the following buttons:
Pulldown Menu displays the Job Editor options for saving and editing
jobs.
Save Job saves the job using the same name.
Test Job starts immediate play back of the Visual Scripts in the job.
Stop Job stops play back of the Visual Scripts in the job.
Clear Log clears the contents of the Results pane and the log file.
View Job Summary displays the latest e-Monitor Job Report in a
browser window.
View HTML displays the Virtual User Display for viewing Visual Script
Edit Schedule makes the Current Schedule window active and displays
Results Pane
The Results pane shows any log messages generated during playback of
Visual Scripts.
e-Monitor Windows
10
e-Monitor Windows
The following shows a sample day view. Use the scroll bar to view the
schedule for the next or previous day.
The Job Tree lists the available Workspaces and e-Monitor jobs. You can
expand or collapse workspace nodes to show or hide the jobs in the
Workspace.
To schedule a job, click on the job in the left pane and drag it onto the
schedule. The default is to schedule the job to run continuously all day on
the scheduled day. To adjust the schedule, double click on the job or right
click on the job and select Edit.
To view the time at which the job is scheduled to run, place the cursor
over the job.
To display the Job Editor window for a job, right-click on the job in the
job tree pane and select View Job.
11
e-Monitor Windows
The Job Summary pane in the Current Schedule window has the
following options:
Job Name displays the name of the job. Double-click on the name to
being played back. Displays the last date and time when the job finishes.
Last Error indicates the last error encountered during job playback.
First Error indicates the first error encountered during job playback.
Show Job Details displays the Current Job window.
Clear Job Results clears the Last Error and Worst Error columns for the
selected job.
Show Job Log displays the job log in Notepad.
Show Job Report displays the e-Monitor job report in a browser
window.
Show Job HTML displays the Virtual User Display.
12
e-Monitor Windows
The Job Summary pane also has the following right-click menu options:
Job Details displays the Current Job window.
Clear Job Results clears the Last Error and Worst Error columns for the
selected job.
Show Log displays the job log.
Show Job HTML displays the Virtual User Display.
Show Job Report displays the e-Monitor job report in a browser
window.
Remove Unscheduled Jobs removes jobs that are not scheduled from the
job list.
The e-TEST Console also writes the playback results for each iteration of
each job to a jobname.slg file. The log file is stored in the same Workspace
as the e-Monitor job file (.mjb).
13
e-Monitor Windows
clears the contents of the e-Monitor log pane and log file.
window.
View HTML displays the Virtual User Display for viewing Visual Script
Visual Script.
Summary displays a summary of the Visual Script playback results.
The log shows the playback results for the Visual Scripts in the job list.
Double-click on the top line of the results for a script to expand and
collapse the details.
14
e-Monitor Windows
Status Bar
The status bar shows the current status of jobs and Visual Scripts in
e-Monitor. The status bar panes from left to right are as follows:
Job shows the current e-Monitor job status: Idle, Running, or
Stopping.
Visual Script shows the name and page number of the currently running
Visual Script.
The e-Monitor menu on the e-TEST Console menu bar lets you work
with schedules and jobs.
e-Monitor Menu
These menu options let you work with jobs and schedules. The following
options are available:
New lets you create a new schedule or job.
New Schedule displays the Current Schedule window for creating a
new schedule.
New Job starts the e-Monitor wizard for creating a new job.
Open lets you open a schedule or job.
Open Schedule lets you open a previously created schedule.
Open Job lets you open a previously created job.
Save lets you save a schedule or job.
Save Schedule
Schedule saves the schedule using the current name.
Save Schedule As saves the schedule using a different name.
Save Job saves the job using the current name.
Save Job As saves the job using a different name.
15
e-Monitor Windows
Configuration dialog box for setting up the mail server. This must be
configured to send email notifications.
Import Shell Script lets you import a Shell Script to create a job.
window for selecting the type of error notification you want to change.
Edit 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 VBA opens the Microsoft
16
Chapter 3
17
Script Selection
Click the Next button to continue to the Job Notifications screen of the
e-Monitor Wizard.
18
Log the Error writes an error message to the e-Monitor results log pane.
19
20
Log Message Format any text entered into this edit box will appear in
the log message. You can insert variables to pass details from the script
playback to the log message. See the Command Reference for more
information about using variables.
Click the Next button to continue to the next Error Handling screen of
the e-Monitor Wizard as determined by your error notification selections,
or click Finish.
Windows NT Eventlog Message Format any text entered into this edit
box will appear in the log message. You can insert variables to pass details
from the script playback to the log message. See the Command Reference
for more information about using variables.
Chapter 3: Creating and Running Jobs
21
Click the Next button to continue to the next Error Handling screen of
the e-Monitor Wizard as determined by your error notification selections,
or click Finish.
message.
Message specifies the body of the email message. e-Monitor
22
Click the Next button to continue to the next Error Handling screen of
the e-Monitor Wizard as determined by your error notification selections,
or click Finish.
launching the specified file. You can enter fixed arguments or pass
arguments from the script variables.
Click the Next button to continue to the next Error Handling screen of
the e-Monitor Wizard as determined by your error notification selections,
or click Finish.
Chapter 3: Creating and Running Jobs
23
SNMP Message Format any text entered into this edit box will appear in
the message. You can insert variables to pass details from the script
playback to the message. See the Command Reference for more
information about using variables.
Click the Next button to continue to the next Error Handling screen of
the e-Monitor Wizard as determined by your error notification selections,
or click Finish.
24
Editing Jobs
Enter a name for the job and click Save. You will be prompted to
schedule the job.
2.
Click Yes. The Scheduling Job dialog box is displayed to add the job
to the Current Schedule, defaulting to the current time.
3.
You can now edit the job, run the job manually, or activate the schedule.
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-Monitor wizard. It also
allows you to change the severity mappings and test the job.
To edit a job, select e-Monitor Open Open Job to select a job and
open the Job Editor window, or right-click on the job in the job tree of the
Current Schedule window and select View Job.
By default, the job details are displayed in the right pane. Click on the
node in the Job Tree to display the options you want to change:
Chapter 3: Creating and Running Jobs
25
Editing Jobs
To save the changes select Save Job from the Job Editor menu.
26
Editing Jobs
2.
failures. You can set the number of times failure or success must
occur before notification is sent for failures and resolutions.
On failure lets you select the information to send when an error occurs
during playback. On failure has the following options:
Send job summary
summary sends the job summary report.
Send failure details sends details about the failure. You can select
whether to report each failure, the first page failure, or all failures
at job end.
3.
Select the type of job failures for which you want to send email.
4.
5.
Save the changes by selecting Save Job from the Job Editor menu.
27
Editing Jobs
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.
28
Editing Jobs
Click Severity Mapping in the left pane or click the toolbar button.
2.
Click the drop down in the Severity 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 ttoo selected rows.
Note: To restore the default severity mapping, right click to display
the menu and click Reset to Default Settings.
Select e-Monitor
Monitor Import Shell Script.
Script
2.
Select the script you want to import and click the Open button. The
Workspace and Scripts screen of the e-Monitor wizard is displayed.
3.
Edit the list of scripts to be included in the job, if necessary and click
Next.
29
Running Jobs
4.
5.
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.
Open Job.
2.
If you want to view the pages as they are run in the Virtual User
Display, click the View Error HTML button.
3.
e-Monitor plays back the Visual Scripts in the order listed, displaying the
details in the Results pane.
4.
30
Double click on the job name in the results pane to show and hide the
job details.
2.
3.
In the Job Editor window, select the View Job Report button.
e-Monitor creates an HTML report for each iteration of a job. They are
saved to an HTML file in the format jobname_yyyymmddhhmmss.html
(year, month, day, hour, minutes, seconds). The HTML job report files are
stored in the workspace with the e-Monitor job file (.mjb).
Failed scripts are displayed first followed by scripts that passed. The
report contains the following columns:
Script the name of the script.
Page Number the number of the page.
Error Description the reason why the script failed.
Time the date and time that the script was run.
d-Tracker a link to d-Tracker that allows you to submit a bug. Some
31
Duration the length of time the script, page, or job ran, in seconds.
Result the result, failed, passed, or warning.
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.
You can also submit bugs to d-Tracker from the Virtual User Display.
32
Chapter 4
33
Day view shows each day separately. Use the scroll bar to move forward
and back through the week. The following is a sample of the Current
Schedule window in day view.
You can display the Job Editor window for a job by selecting a job in the
job tree, and selecting View Job from the right-click menu.
34
Creating Schedules
Creating Schedules
To create a schedule:
1.
2.
Click on the job name and drag it onto the schedule. By default, the
job is scheduled to run continuously for the entire day.
3.
35
Creating Schedules
4.
Select the days and frequency at which you want to run the job or
click Advanced for more options.
5.
Select the frequency with which you want to run the job.
6.
Click Ok.
7.
36
Editing Schedules
Editing Schedules
To edit a schedule:
1.
Make the Current Schedule window active to edit the schedule that is
currently open or select e-Monitor Open Schedule to edit another
schedule.
Note: Only one schedule can be open at any one time.
2.
37
Schedule Menus
3.
Select the days and frequency at which you want to run the job or
click Advanced for more options.
4.
Select the frequency with which you want to run the job.
5.
Click OK.
6.
To add a new job, click on the job name and drag it onto the
schedule. By default, the Current Schedule window schedules the job
to run continuously for the entire day. Edit the frequency by doubleclicking on the job or right clicking on the job and selecting Edit.
6.
7.
Schedule Menus
The Current Schedule window has several right click menus. The menus
differ based on whether you click on a scheduled job or in any
unscheduled area. Following is a description of the menus:
38
Week View displays all jobs scheduled for the week. This option is only
only available when the schedule has been changed and not saved.
only available when the schedule has been changed and not saved.
2.
3.
If you want to view the pages as they are run in the Virtual User
Display, make the Job Editor window active and click on the toolbar
button or click the Show Error HTML button.
39
4.
To view the progress of the current job as it is playing back, doubleclick on the name of the job in the Job Results pane to open the
Current Job window for the job.
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:
The Job Summary pane in the Current Schedule window has the
following options:
Job Name displays the name of the job.
Iter displays the iteration being run.
Fail
Fail displays the number of failures.
Warn displays the number of warnings.
Status displays the last date on which the job was run.
Last Error indicates the last error encountered during job playback.
First Error indicates the first error encountered during job playback.
Show Job Details displays the Current Job window.
Clear Job Results clears the Last Error and Worst Error columns for the
selected job.
Show Job Log displays the job log.
Show Job Report displays the e-Monitor job report in a browser
window.
Show Job HTML displays the Virtual User Display.
40
The Job Summary pane also has the following right-click menu options:
Job Details displays the Current Job window.
Clear Job Results clears the Last Error and Worst Error columns for the
selected job.
Show Log displays the job log.
Show Error HTML displays the Virtual User Display.
Show Job Report displays the e-Monitor job report in a browser
window.
Remove Unscheduled Jobs removes jobs that are not scheduled from the
job list.
While a script is running, you can display the Job Editor window by
right-clicking on the job in the job tree and selecting View Job.
To stop playing back jobs, select e-Monitor Deactivate
Deactivate Schedule.
41
42
Appendix A
Command Reference
e-Monitor includes several objects, events, methods, and properties that
you can use to add custom programming code to e-Monitor 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-Monitor error notification
messages.
%Time - returns the time the error occurred.
%curWorkspace - returns the name of the workspace in which the
script is located.
%job
43
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.
44
Variables
Variables are typed and must be declared. Variables can be procedurelevel, 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
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
45
46
Application Object
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-Monitor 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.
Method
Method or Property
Description
AppendLog
CurrentResult
DoRV
ErrNumber
Notifier
RunJob
RunScriptNext
SaveLog
SkipNextScript
StopJob
47
Result Object
Method
Method or Property
Description
StopSchedule
StopScript
The syntax and usage for these properties and methods are in the
following sections.
The application object does not have to be specified.
Examples
Private Sub VisualScript_ScriptEnd()
'If script fails, stop the script
If currentResult.status = ZFAIL Then
Application.stopScript
End If
End Sub
Private Sub VisualScript_ScriptEnd()
'Write to the results log
Notifier.Log currentresult.PageTitle
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.
48
Property
Description
CurrentScriptName
DatabankIndex
DatabankValue
ErrDescription
ThisJob Object
Property
Description
JobName
LastDuration
PageTitle
PageURL
PlayIndex
ScriptName
Status
Workspace
The syntax and usage for these properties and methods are in the
following sections.
Represents the result of a page playback. Use currentResult to access
the properties for a page.
Example
Private Sub VisualScript_ScriptEnd()
'If script fails, stop the script
If currentResult.status = ZFAIL Then
stopScript
End If
End Sub
ThisJob Object
Globally provides access to events for all scripts in the job. The following
table lists the methods and events of the ThisJob object.
Event
Description
Failure
GetValue
49
ThisJob Object
Event
Description
IterationsBegin
IterationsEnd
JobBegin
JobEnd
PageBegin
PageEnd
RemoveValue
ScriptBegin
ScriptEnd
SetValue
The syntax and usage for these properties and methods are in the
following sections.
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.
Example
Private Sub ThisJob_Failure()
'Send email message and stop job
Notifier.SNMPTrap "This job failed and was
stopped."
stopJob
End Sub
50
VisualScript Object
VisualScript Object
Provides access to VisualScript events and methods. The following
table lists the methods and events of the VisualScript object.
Method or Event
Description
Failure
IterationsBegin
IterationsEnd
PageBegin
PageEnd
RunNext
ScriptBegin
ScriptEnd
SetNextRunDatabank
Index
The syntax and usage for these properties and methods are in the
following sections.
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.
51
AppendLog Method
Example
Private Sub VisualScript_ScriptEnd()
'If script fails, stop the script
If currentResult.status = ZFAIL Then
stopScript
End If
End Sub
AppendLog Method
Purpose
Syntax
[Application.]AppendLog filename$
Parameter
filename
Description
Remarks
Example
See Also
Application Object
ClearLog Method
Purpose
Clears the results log pane and the corresponding job log file.
Syntax
[Application.]ClearLog
Remarks
The Job log file has a .slg extension and is located in the same
workspace as the Monitor Job file.
Example
52
CurrentResult Property
See Also
Application Object
CurrentResult Property
Purpose
Returns the properties of the result object for the current page.
Syntax
[Application.]currentResult.property
Parameter
property
Description
Remarks
Example
See Also
CurrentScriptName Property
Purpose
Syntax
[Application.]currentResult.currentScriptName
Example
See Also
53
DatabankIndex Property
DatabankIndex Property
Purpose
Syntax
[Application.]currentResult.databankIndex
Remarks
The record index is 1 based. If the Job plays back the Visual Script
with Data Banks/All records, the index increments for each iteration
of the Visual Script through the Data bank file. If the Job plays back
the Visual Script with Data Banks/Single record, the index increments
for each iteration of the entire job. If the Job plays back the Visual
Script without Data Banks, the index is the value specified as the
Current Record Number in the e-Tester Iterations parameters for the
Visual Script.
Example
See Also
Result Object
DatabankValue Method
Purpose
Syntax
[Application.]currentResult.databankValue(var_name$)
Parameter
var_name
Remarks
54
Description
DoRV Method
Example
See Also
Result Object
DoRV Method
Purpose
Syntax
[Application.]DoRV results
Parameter
results
Remarks
Description
Example
55
DoRV Method
'rows
Dim x As Integer
'For each Resource Validation Row
'Get the value of each Resource Validation
For x = LBound(rvArray) To UBound(rvArray)
Dim rvRow
Dim rvCol As Integer
Dim rvResult As String
'Set up a variable to parse the Resource
'Validation columns
rvRow = rvArray(x)
'For each column in the row
'Get the value of each column parameter
For rvCol = 0 To 7
If rvCol = 0 Then
rvHost = rvRow(rvCol)
ElseIf rvCol = 1 Then
rvResPath = rvRow(rvCol)
ElseIf rvCol = 2 Then
rvCurStatus = rvRow(rvCol)
ElseIf rvCol = 3 Then
rvErrDesc = rvRow(rvCol)
ElseIf rvCol = 4 Then
rvResHandle = rvRow(rvCol)
ElseIf rvCol = 5 Then
rvIntStatCode = rvRow(rvCol)
ElseIf rvCol = 6 Then
rvStats = rvRow(rvCol)
ElseIf rvCol = 7 Then
rvWininetErrCode = rvRow(rvCol)
End If
Next rvCol
'Do Resource error checking for the current
'results
'Label the current row of Resource Validation
'results
rvResult = "*****Resource Validation
Results*****" & vbCrLf & _
"Number: " & x & vbCrLf & _
"Host: " & rvHost & vbCrLf & _
"Path: " & rvResPath & vbCrLf & _
"Current Status: " & rvCurStatus & _
vbCrLf & _
"Error Description: " & rvErrDesc & _
vbCrLf & _
"Resource Handle: " & rvResHandle & _
vbCrLf & _
"Internet Status Code: " & _
rvIntStatCode & vbCrLf & _
56
Email Method
See Also
Application Object
Email Method
Purpose
Syntax
[Application.]Notifier.Email(recipient$, subject$,
message$, [sender$])
Parameter
recipient$
Description
message$
sender$
subject$
Remarks
Example
See Also
57
ErrDescription Property
ErrDescription Property
Purpose
Returns and sets the error description for the individual page.
Syntax
[Application.]currentResult.errDescription
Example
Dim errorDesc
errorDesc = currentResult.errDescription
See Also
ErrNumber Property
Purpose
Returns and sets the error number for the application object.
Syntax
[Application.]errNumber
Example
See Also
58
Application Object
EventLog Method
EventLog Method
Purpose
Syntax
[Application.]Notifier.EventLog(message$)
Parameter
message
Remarks
Description
Example
See Also
Failure Event
Purpose
Syntax
object_Failure()
Parameter
object
Remarks
Example 1
Example 2
See Also
Description
59
FmtStr Function
FmtStr Function
Purpose
Syntax
[Application.]Notifier.FmtStr(InString$)
Parameter
InString$
Remarks
Description
Example
See Also
GetValue Method
Purpose
Syntax
ThisJob.GetValue(var_name$)
Parameter
var_name
Description
Remarks
Example
60
IterationsBegin Event
See Also
ThisJob Object
IterationsBegin Event
Purpose
Syntax
object_IterationsBegin()
Parameter
object
Description
IterationsEnd Event
Remarks
Example
See Also
IterationsEnd Event
Purpose
Syntax
object_IterationsEnd()
Parameter
object
Remarks
Description
Example
See Also
JobBegin Event
Purpose
Syntax
ThisJob_JobBegin()
Remarks
Example
See Also
62
JobEnd Event
JobEnd Event
Purpose
Syntax
Description
Remarks
Example
See Also
JobName Property
Purpose
Syntax
[Application.]currentResult.jobName
Example
See Also
63
LastDuration Property
LastDuration Property
Purpose
Returns the length of time, in seconds, that the page took to play back.
Syntax
[Application.]currentResult.lastDuration
Example
Dim length
length = currentResult.lastDuration
See Also
Log Method
Purpose
Syntax
[Application.]Notifier.Log(message$)
Parameter
message$
Description
Remarks
Example
See Also
64
MsgBox Method
MsgBox Method
Purpose
Syntax
[Application.]Notifier.MsgBox(Message$)
Parameter
Message
Description
Remarks
Example
See Also
Notifier Property
Purpose
Syntax
[Application.]Notifier.method
Example
See Also
65
PageBegin Event
PageBegin Event
Purpose
Syntax
Description
playIndex
currentScriptName
Remarks
Example
See Also
66
PageEnd Event
PageEnd Event
Purpose
Syntax
object_PageEnd()
Parameter
object
Remarks
Description
Example
See Also
PageTitle Property
Purpose
Syntax
[Application.]currentResult.pageTitle
Example
See Also
Result Object
67
PageURL Property
PageURL Property
Purpose
Syntax
[Application.]currentResult.PageURL
Example
See Also
Result Object
PlayIndex Property
Purpose
Syntax
[Application.]currentResult.playIndex
Example
Dim pagenum
pagenum = currentResult.playIndex
See Also
RemoveValue Method
Purpose
Syntax
ThisJob.RemoveValue(var_name$)
Parameter
var_name
Description
Remarks
Example
68
RemoveValue Method
See Also
ThisJob Object
69
RunJob Method
RunJob Method
Purpose
Syntax
[Application.]RunJob (filename$)
Parameter
filename
Description
Example
application.RunJob
"c:\Empirix\eTEST\default!\myjob.mjb"
See Also
Application Object
RunNext Method
Purpose
Places the specified script next in the queue after the current script.
Syntax
object.runNext()
Parameter
object
Remarks
Description
Example
See Also
70
RunScriptNext Method
RunScriptNext Method
Purpose
Places the specified script next in the queue after the current script.
Syntax
[Application.]runScriptNext(scriptName$, workspace$,
iterate)
Parameter
scriptName
Remarks
Description
Example
See Also
71
SaveLog Method
SaveLog Method
Purpose
Syntax
Description
Example
False.
application.SaveLog "mylog.log",False
See Also
Application Object
ScriptBegin Event
Purpose
Syntax
object_PageBegin()
Parameter
object
Remarks
Description
Example
See Also
72
ScriptEnd Event
ScriptEnd Event
Purpose
Syntax
object_ScriptEnd()
Parameter
object
Remarks
Description
Example
See Also
ScriptName Property
Purpose
Syntax
[Application.]currentResult.ScriptName
Example
See Also
Result Object
73
SetNextRunDatabankIndex Method
SetNextRunDatabankIndex Method
Purpose
Sets the Data Bank record index for the next run of the job.
Syntax
object.SetNextRunDatabankIndex()
Parameter
object
Remarks
Description
See Also
VisualScript Object
SetValue Method
Purpose
Syntax
ThisJob.SetValue(var_name$, value)
Parameter
var_name
Description
Remarks
Example
value
SkipNextScript Method
See Also
ThisJob Object
SkipNextScript Method
Purpose
Syntax
[Application.]skipNextScript([numberOfScripts&])
Parameter
numberofScripts&
Description
SNMPTrap Method
Remarks
Used to remove scripts from the playback queue starting with the
script that is next after the current script. Refer to the Script
Execution and Event Triggering section for an explanation of how
the queue works.
Example
See Also
SNMPTrap Method
Purpose
Syntax
[Application.]Notifier.SNMPTrap(message$)
Parameter
message
Description
Remarks
Used to set an SNMP trap message during script playback. The eMonitor system must be configured as SNMP management system to
receive SNMP trap messages.
Example
See Also
76
Status Property
Status Property
Purpose
Syntax
[Application.]currentResult.status
Constant
Value
Description
ZPASS
ZWARNING
ZFAIL
ZERROR
Example
See Also
StopJob Method
Purpose
Syntax
[Application.]stopJob()
Remarks
Example
See Also
77
StopSchedule Method
StopSchedule Method
Purpose
Syntax
[Application.]StopSchedule
Example
application.StopSchedule
See Also
Application Object
StopScript Method
Purpose
Stops playback of the current script and moves to the next script in the
job.
Syntax
[Application.]stopScript()
Remarks
Example
See Also
Workspace Property
Purpose
Syntax
[Application.]currentResult.workspace
Example
Dim location
location = currentResult.workspace
See Also
Result, CurrentScriptName
78
Appendix B
Information Codes
100
Continue
101
Switching Protocols
Success Codes
200
OK
201
Created
202
Accepted
203
NonNon-Authoritative Information
79
204
205
206
No Content
The server has fulfilled the request but does not need to return
new information.
Reset Content
The server has fulfilled the request and the client should reset
the document view, which caused the request to be sent to allow
the user to initiate another input action.
Partial Content
The server has fulfilled the partial GET request for the
resource.
Redirection Codes
300
Multiple
Multiple Choices
301
Moved Permanently
302
303
304
Not Modified
305
Use Proxy
306
80
Not Used
307
Temporary Redirect
Failure Codes
400
Bad Request
Unauthorized
402
Payment Required
403
Forbidden
404
Not Found
405
406
407
408
Request TimeTime-out
409
Conflict
410
Gone
81
411
412
Length Required
Precondition Failed
413
414
415
416
Expectation Failed
501
82
Not Implemented
Implemented
Internet Codes
502
503
Bad Gateway
Service Unavailable
504
Gateway TimeTime-out
505
Internet Codes
Internet Error Codes
12001
Out of Handles
12002
Timeout
12003
Extended Error
12004
Internal Error
12005
Invalid URL
12006
Unrecognized Scheme
83
Internet Codes
12007
12008
12009
Invalid Option
A request to InternetQueryOption or InternetSetOption specified
12011
12012
Shutdown
12013
12014
12015
84
Incorrect Password
12016
Invalid Operation
12017
Operation Canceled
12018
12019
Internet Codes
12020
Not P
Proxy
roxy Request
12021
12022
12023
No Direct Access
12024
No Context
12025
No Callback
12026
Request Pending
12027
Incorrect Format
12028
12029
Cannot Connect
12030
Connection Aborted
12031
Connection Reset
12032
Force Retry
12033
85
Internet Codes
12034
Need UI
12035
Not Defined
This error code is not defined in WININET.
12036
Handle Exists
12037
12039
12040
12041
Mixed Security
12042
86
12043
12044
12045
Invalid CA
12046
Internet Codes
12047
12048
12049
Dialog Pending
12050
Retry Dialog
12051
Not Defined
This error code is not defined in WININET.
12052
12053
12111
12112
Transfer in Progress
The FTP operation was not completed because the session was
aborted.
No Passive Mode
Protocol Error
87
Internet Codes
12131
Not File
12132
Data Error
12133
End of Data
12134
Invalid Locator
12135
12136
12137
12138
Unknown Locator
88
12150
12151
Downlevel Server
12152
12153
Invalid Header
12154
12155
Internet Codes
12156
Redirect Failed
12157
12158
12159
12160
Not Redirected
12161
12162
Cookie Declined
12163
Disconnected
12164
Server Unreachable
12165
12166
12167
12168
12169
89
Internet Codes
12170
Sec Cert
Cert Revoked
12171
Additional Information
For additional information about HTTP Status Codes and the Win32
Internet API Constants, see the following Web resources:
Section 10 of the Hypertext Transfer Protocol HTTP/1.1
Request for Comments: 2616:
http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html
90
Appendix C
Overview
Overview
The redesign of e-Monitor provides a more comprehensive and versatile
application for Web site or application monitoring. e-Monitor 5.1
provides the ability to schedule multiple jobs, with each job running
multiple Visual Scripts. The new version also provides more advanced
Reporting capabilities.
In e-Monitor 5.0*, scheduling, Visual Script execution, and error
handling and notification were all included within the Shell Scripts. In
e-Monitor 5.1, scheduling has been separated from Visual Script
execution and error handing/notifications. e-Monitor 5.1 also includes the
VBA IDE for advanced programming and error handling options.
While the e-Monitor changes provide more flexibility in scheduling
multiple e-Monitor jobs and custom error handling, there is a one-time
conversion process that e-Monitor 5.0 users need to complete to bring
existing Shell Script functionality into e-Monitor 5.1. If you have
e-Monitor 5.0 Shell Scripts that you want to use with e-Monitor 5.1,
you'll have to convert the Shell Script functionality to e-Monitor 5.1 Jobs
and Schedules.
e-Monitor 5.1 includes a utility for importing existing Shell Scripts
created by the e-Monitor 5.0 Wizard. However, because of the variety of
capabilities that users could program into Shell Scripts, the import utility
will only read Shell Script code generated by the e-Monitor 5.0 Wizard.
If you have customized e-Monitor 5.0 Wizard-generated Shell Scripts,
you will also have to convert your customized code for use in the VBA
environment.
The import utility does not alter existing Shell Script files. See the
Importing Shell Scripts topics for information about which Shell Script
functionality will be imported into e-Monitor 5.1 jobs.
See the Converting Custom code topic for information about a conversion
reference between 5.0 Shell Script commands and 5.1 VBA events,
methods, and properties.
92
1.
2.
Select the script you want to import and click the Open button. The
Workspace and Scripts screen of the e-Monitor wizard is displayed.
3.
Edit the list of scripts to be included in the job, if necessary and click
Next.
4.
5.
6.
Specify a file name for the new job and click Save.
7.
Click Yes to add the Job to a new schedule or click No to open the job
in the Job Editor window.
8.
9.
Click OK.
10.
93
What is Imported
The following information will be imported into e-Monitor 5.1 jobs from
e-Monitor 5.0* Shell Scripts:
Scriptnames and Workspaces the import utility recognizes the Visual
Scripts names referenced within the Shell Script by the Play statement.
Visual Scripts names referenced within the Shell Script by the Iterate
statement are currently not recognized. This is a known limitation. As a
temporary workaround, you can edit your Shell Scripts to change
Iterate statement to Play statement before importing. You can specify
databank iteration options in the e-Monitor 5.1 Wizard after importing
the Shell Script.
Error Notification Methods the import utility recognizes all e-Monitor
94
5.1 built-in error handling and custom code in the VBA environment. The
VBA project for each Job contains an object for the overall job level and an
object for each Visual Script in the job. Each VBA project has a Failure
event for the Job object level and each Visual Script object level. Custom
On Error code can be added to these VBA event handlers.
Custom Message Names the import utility does not recognize
notifications to more than one address, only the last one in the Shell Script
will appear in the e-Monitor 5.1 Wizard. You can add multiple addresses
in the Wizard if you want all recipients to receive the same Email
message. If you want Email recipients to receive different messages based
upon various conditions, you can specify the condition in the VBA
environment and use the Email method to send multiple messages.
Custom Shell Scripting the import utility does not recognize custom code
in Shell Scripts. The import utility only converts e-Monitor 5.0* Wizardgenerated code. The import utility does not alter existing Shell Script files.
If you have custom code, you can convert the code to the VBA
environment to include any custom scripting such as error handling as
part of e-Monitor 5.1 jobs and schedules.
95
Failure Event
Failure Event
IterationsBegin Event
PageBegin Event
IterationsEnd Event
PageEnd Event
JobBegin Event
ScriptBegin Event
JobEnd Event
ScriptEnd Event
PageBegin Event
PageEnd Event
ScriptBegin Event
ScriptEnd Event
Custom code can be added to theses VBA event handlers. The e-Monitor
e-PI includes the application object that you can use to access the
available methods and properties.
You can also add your own modules to the Visual Basic project. Custom
code added to ThisJob or VisualScript objects in the VBA project
becomes associated with that object.
96
Save the job to a new file or export your custom VBA code before
removing Visual Scripts from a job.
If you have VBA code that you want to able to use across Jobs and Visual
Scripts, you can create a template e-Monitor Job with VBA code only in
the ThisJob object or your own module. You can then add and remove
Visual Scripts to the template Job and save the job as a new name. Note
however, that Visual Script names define object names in the VBA project.
Your code will need to handle the references to Visual Script object
names.
Cdate Function
ClearLog Statement
ClearLog Method
Close Statement
N/A
CloseWorkspace Statement
N/A
Cstr Function
CurDatabank Function
CurPage Function
PlayIndex Property
CurPageTitle Function
PageTitle Property
CurPageURL Function
PageURL Property
CurRecord Function
DatabankIndex Property
CurScript Function
CurrentScriptName Property
ScriptName Property
97
e-Monitor
Monitor 5.0 and Earlier
CurWorkspace Function
Workspace Property
Date Function
Day Function
DBVarValueOf Function
DatabankValue Method
ElementValueOf Function
N/A
Email Statement
Email Method
Err.Description Function
ErrDescription Property
Err.Number Function
ErrNumber Property
ErrorPageDuration Function
Failure Event
LastDuration Property
Custom VBA Code
EventLog Function
EventLog Method
Exec Statement
Exec Method
Exit Statement
N/A
FmtStr Function
FmtStr Function
98
GetHtml Function
N/A
Goto Statement
Hour Function
IfThenElse Statement
IsSuspended Function
N/A
Iterate Statement
e-Monitor Scheduler
IterationCount Function
IterationsBegin Event
DatabankIndex Property
JobBegin Event
GetValue Method
RemoveValue Method
SetValue Method
Label
Log Statement
Log Method
Minute Function
Month Function
MsgBox Statement
MsgBox Method
Now Function
On Error Statement
Open Statement
N/A
Play Statement
e-Monitor Scheduler
e-Monitor Job Editor
Quit Statement
N/A
Reset Statement
N/A
Restart Statement
N/A
Resume Statement
N/A
RSWLastError Function
Failure Event
ErrDescription Property
ErrNumber Property
RSWPageError_FE
Failure Event
ErrDescription Property
ErrNumber Property
99
100
RSWPageError_TM
Failure Event
ErrDescription Property
ErrNumber Property
RSWStat.Clear Function
RemoveValue Method
RSWStat.ErrorDescription
Function
ErrDescription Property
RSWStat.PageErrCount
Function
Failure Event
GetValue Method
RemoveValue Method
SetValue Method
RSWStat.ScriptErrCount
Function
Failure Event
GetValue Method
RemoveValue Method
SetValue Method
Save Statement
N/A
SaveAs Statement
N/A
SaveLog Statement
AppendLog Method
SaveLog Method
SetOptions Statement
N/A
SMTPMail Statement
Email Method
Stop Statement
StopJob Method
StopScript Method
StopSchedule Method
Suspend Statement
N/A
Time Function
TimeOf Function
UCase Function
WaitFor Statement
e-Monitor Scheduler
e-Monitor User Guide
WaitTill Statement
e-Monitor Scheduler
WeekDay Function
Workspace Statement
Year Function
101
102
Index
Activate Schedule menu option, 16
Activating Schedules, 39
Address of email, 22
AppendLog Method, 52
Application Object, 47
Changing Script Execution Order, 18
ClearLog Method, 52
Command, 43
Command Reference
AppendLog, 52
Application Object, 47
ClearLog, 52
CurrentResult Property, 53
CurrentScriptName Property, 53
DatabankIndex Property, 54
DatabankValue, 54
DoRV, 55
Email Method, 57
ErrDescription Property, 58
ErrNumber Property, 58
EventLog Method, 59
Failure Event, 59
FmtStr Function, 60
GetValue, 60, 74
IterationsBegin Event, 61
IterationsEnd Event, 62
JobBegin Event, 62
JobEnd Event, 63
JobName Property, 63
LastDuration Property, 64
Log Method, 64
MsgBox Method, 65
Notifier Property, 65
PageBegin Event, 66
PageEnd Event, 67
PageTitle Property, 67
PageURL Property, 68
PlayIndex Property, 68
RemoveValue, 68
Result Object, 48
RunJob, 70
RunNext Method, 70
RunScriptNext Method, 71
SaveLog, 72
ScriptBegin Event, 72
ScriptEnd Event, 73
ScriptName Property, 73
SetNextRunDatabankIndex, 74
SkipNextScriptMethod, 75
SNMPTrap Method, 76
Status Property, 77
StopJob Method, 77
StopSchedule, 78
StopScript Method, 78
ThisJob Object, 49
VisualScript Object, 51
Workspace Property, 78
Configure Mail Server menu option, 16
Create menu option, 38
Current Job Window
e-Monitor, 13
Current Schedule, 33
Current Schedule Window window
e-Monitor, 10
CurrentResult Property, 53
CurrentScriptName Property, 53
DatabankIndex Property, 54
DatabankValue Method, 54
Deactivate Schedule menu option, 16
Deactivating Schedules, 41
Delete menu option, 39
DoRV Method, 55
d-Tracker
Submitting Bugs, 32
Edit menu option, 39
Edit Notifications menu option, 16
Edit Severity Mapping menu option,
16
103
Index
IterationsEnd, 62
JobBegin, 62
JobEnd, 63
PageBegin, 66
PageEnd, 67
ScriptBegin, 72
scriptEnd, 73
Executable file details, 23
Exit menu option, 16
Failure Codes, 81
Failure Event, 59
File Names, 44
File to execute on error, 23
FmtStr Function, 60
FTP API Error Codes, 87
Functions
FmtStr, 60
GetValue Method, 60, 68
Gopher API Error Codes, 87
HTTP API Error Codes, 88
Import Shell Script menu option, 16
Importing e-Monitor Scripts, 29
Information Codes, 79
Internet Error Codes, 83
Introduction, 1
IterationsBegin Event, 61
IterationsEnd Event, 62
Job Editor menu, 16
Job Editor Window
Status Bar, 15
Job Editor Window window
e-Monitor, 8
Job Notification Options
e-Monitor, 19
Job Report, 31
Job Summary Window, 40
e-Monitor, 12
JobBegin Event, 62
JobEnd Event, 63
JobName Property, 63
Jobs
Editing, 25
Running, 30
Selecting Visual Scripts, 18
LastDuration Property, 64
Launch with following arguments, 23
Log Method, 64
e-Monitor User Guide
Index
Menu options, 15
Activate Schedule, 16
Configure Mail Server, 16
Create, 38
Deactivate Schedule, 16
Delete, 39
Edit, 39
Edit Notifications, 16
Edit Severity Mapping, 16
Edit VBA, 16
e-Monitor, 15
Exit, 16
File, 15
Import Shell Script, 16
Job Editor menu, 16
New, 15
New Job, 15
New Schedule, 15
Open Job, 15
Open Schedule, 15
Overview, 15
Save, 15
Save Job, 16
Save Job, 15
Save Job As, 15, 16
Save Schedule, 15
Save Schedule, 39
Save Schedule As, 15
Scripts, 16
Week View, 39
Message body of email, 22
Methods
AppendLog, 52
ClearLog, 52
DatabankValue, 54
DoRV, 55
Email, 57
EventLog, 59
GetValue, 60
Log, 64
MsgBox, 65
RemoveValue, 68
RunJob, 70
RunNext, 70
RunScriptNext, 71
SaveLog, 72
SetNextRunDatabankIndex, 74
Index
SetValue, 74
SkipNextScript, 75
SNMPTrap, 76
StopJob, 77
StopSchedule, 78
StopScript, 78
Monitor menu, 15
MsgBox Method, 65
New Job menu option, 15
New menu option, 15
New Schedule menu option, 15
Notification Variables, 43
Notifier Property, 65
Objects
Application, 47
Result, 48
ThisJob, 49
VisualScript, 51
Open Job menu option, 15
Open Schedule menu option, 15
Order Scripts, 18
PageBegin Event, 66
PageEnd Event, 67
PageTitle Property, 67
PageURL Property, 68
PlayIndex Property, 68
Properties
CurrentResult, 53
CurrentScriptName, 53
DatabankIndex, 54
ErrDescription, 58
ErrNumber, 58
JobName, 63
LastDuration, 64
Notifier, 65
PageTitle, 67
PageURL, 68
PlayIndex, 68
ScriptName, 73
Status, 77
Workspace, 78
Redirection Codes, 80
Result Object, 48
Results Pane, 9
RunJob Method, 70
RunNext Method, 70
RunScriptNext Method, 71
105
Index
106
SetValue Method, 74
SkipNextScript Method, 75
SNMPTrap Method, 76
Sophisticated Error Reporting, 2
Starting e-Monitor Wizard, 17
Status Bar, 15
Status Property, 77
StopJob Method, 77
StopSchedule Method, 78
StopScript Method, 78
Subject of email, 22
Submitting Bugs, 32
Success Codes, 79
System Requirements, 3
ThisJob Object, 49
Toolbar, 9
Variables, 44
Visual Scripts
e-Monitor Wizard, 17
Executable details, 23
Selecting Workspace, 18
VisualScript Object, 51
Week View menu option, 39
Windows NT Event Log Message
e-Monitor Wizard, 21
Wizard
Email details, 24
Select Visual Script, 18
Select Workspace, 18
Workspace and scripts, 17
Workspace Property, 78
Workspaces
e-Monitor Wizard, 17