1 – About frame
© Copyright 2015 Hewlett-Packard Development Company,
L.P.
Confidential computer software. Valid license from HP
required for possession, use or copying. Consistent
with FAR 12.211 and 12.212, Commercial Computer
Software, Computer Software Documentation, and
Technical Data for Commercial Items are licensed to the
U.S. Government under vendor's standard commercial
license.
Software Version: Digital Test Manager for OpenVMS:
Screen Editor Version V4.5
2 – Overview frame
The Screen Editor is a component of the DTM software
development tool that automates the process of
regression testing. More specifically, the Screen
Editor provides support for testing of X windows
applications.
The Screen Editor allows you to:
o Review screen captures (benchmark and result files)
o Specify areas of screens to be excluded when
benchmark and result images are compared (masks)
o Create and/or update mask files
o Compare screen captures (benchmark and result
images)
For more information about using the Screen Editor,
managing windows, or using the mouse, double click on
an item from the list of additional topics below.
For information about using help, choose On Window from
the Using Help menu above.
3 – DECbasics frame
Information about using DECwindows, such as how to use
windows, dialog boxes, and scroll bars, is available
from Session Manager help. A glossary of DECwindows
terms is also available. To get Session Manager help:
1. Move the pointer to the Session Manager icon (the
icon with your user name and the name of your
system) in the Icon Box.
2. Press mouse button 1 (MB1) twice quickly to display
the Session Manager window.
3. Move the pointer to the Help menu; press and hold
MB1 to pull down this menu.
4. Move the pointer to the Overview menu item and
release MB1 to display information about using
DECwindows.
4 – Glossary frame
Benchmark file
A file containing the expected result screen images
for a test execution.
Mask
A specified area of a screen image to be ignored or
excluded when Result and Benchmark images are
compared.
Mask file
A file used to hide (mask) specified areas of a
screen image during a comparison between a Result and
Benchmark file.
Masking
A method used to specify areas in a benchmark file
that are to be hidden during test analysis.
Result file
A file containing the result screen images from a
test execution.
X Testing
Testing of software applications employing an X
Windows interface.
5 – OnLineDoc frame
For the latest information concerning the Screen Editor, see the Release Notes for DTM.
6 – ScrEd MnWind
The Screen Editor Main Window is comprised of an Image/Mask Display and Edit Area, a Message Display Area, and a Controls Area. The Image/Mask Display and Edit Area displays Benchmark and Results images and is used to define Masks. The Controls Area is used to modify the contents of the Image/Mask Display and Edit Area. For more information, on the Screen Editor's Display, Message, and Controls, double click on an item from the list of additional topics below.
6.1 – scred HelpBox
For more information on the Screen Editor, Click on one of the additional topics from the list below.
6.2 – s menu MenuBar
The Screen Editor contains the following pull-down
menus:
File
Edit
Options
Help
In addition, the Screen Editor window includes a
variety of push-buttons and controls which allow you to
display Benchmark and Result images in many ways.
Using the push-buttons, you may compare and show
differences between Benchmark and Result images.
For more information about the Screen Editor's menus
and controls, double click on an item from the list of
additional topics below.
6.2.1 – s file Cascade
Use the File menu to open, include, and save a file.
Also use the File menu to exit the Screen Editor.
The File menu contains the following menu items:
Open Benchmark...
Open Result...
Open Mask...
Save Mask
Save Mask As...
Quit
Exit
For information about using a File menu item, double
click on an item from the list of additional topics
below.
6.2.1.1 – s OpenBmk Btn
To open an existing Benchmark file, choose Open
Benchmark... from the File menu.
The "DTM : Open Benchmark File" dialog box appears,
which displays a list of available Benchmark files.
To open an existing Benchmark file:
1. In the Directories list box, double click on the
directory where your Benchmark file is located.
2. Click on the Filter push button to list available
Benchmark files.
3. In the Files list box, double click on the
Benchmark file you want to open.
6.2.1.2 – s OpenRes Btn
To open an existing Result file, choose Open Result...
from the File menu.
The "DTM : Open Result File" dialog box appears, which
displays a list of available Result files.
To open an existing Result file:
1. In the Directories list box, double click on the
directory where your Result file is located.
2. Click on the Filter push button to list available
Result files.
3. In the Files list box, double click on the Result
file you want to open.
6.2.1.3 – s OpenMsk Btn
To open an existing or new Mask file, choose Open
Mask... from the File menu.
The "DTM : Open Mask File" dialog box appears, which
displays a list of available Mask files.
To open an existing Mask file:
1. In the Directories list box, double click on the
directory where your Mask file is located.
2. Click on the Filter push button to list available
Mask files.
3. In the Files list box, double click on the Mask
file you want to open.
To open a new Mask file:
1. In the Directories list box, double click on the
directory where you want the Mask file to reside.
2. Click on the Selection entry box. Enter the new
file name with an MXK file type. For example,
TESTMASKS.MXK.
3. Click on OK.
6.2.1.4 – s Save Btn
To save Masks into the currently opened Mask File, choose the Save Mask from the File menu.
6.2.1.5 – s SaveMsk Btn
To save Masks into a new Mask File, choose the Save
Mask As... from the File menu.
The "DTM : Save Mask File" dialog box appears, which
displays a list of current Mask file names.
To replace an existing Mask file:
1. In the Directories list box, double click on the
directory where your Mask file is located.
2. Click on the Filter push button to list available
Mask files.
3. In the Files list box, double click on the Mask
file you want to save to.
To save a new Mask file:
1. In the Directories list box, double click on the
directory where you want the Mask file to reside.
2. Click on the Selection entry box. Enter the new
file name with an MXK file type. For example,
TESTMASKS.MXK.
3. Click on OK.
6.2.1.6 – s Quit Btn
To quit the Screen Editor, choose Quit from the File menu. If you have made changes to Masks, the Screen Editor will ask you to verify that you wish to quit before exiting. To state your choice, click on OK or Cancel.
6.2.1.7 – s Exit Btn
To exit the Screen Editor, choose Exit from the File menu. Changes to Masks will be saved in the currently opened Mask file.
6.2.2 – s Edit Cascade
Use the Edit menu to edit Masks in the Image/Mask
Display and Edit Area.
The Edit menu contains the following menu items:
Copy
Paste
Reset
Select All
Clear All
For information about using a Edit menu item, double
click on an item from the list of additional topics
below.
6.2.2.1 – s Copy Btn
The Copy menu item allows you to copy all Masks from the Image/Mask Display and Edit Area. Copied Masks may be pasted to another screen using the Paste button from the Edit menu. For more information on Copy and Paste of Masks, double click on an item from the list of additional topics below.
6.2.2.2 – s Paste Btn
The Paste menu item allows you to paste copied Masks into the Image/Masks Display and Edit Area. Masks may be copied using the Copy button from the Edit menu. For more information on Copy and Paste of Masks, double click on an item from the list of additional topics below.
6.2.2.3 – s Reset Btn
The Reset menu item allows you to reset the displayed Masks, displaying only those Masks defined in the currently opened Mask file.
6.2.2.4 – s SelectAll Btn
The Select All menu item is not implemented in this release of the Screen Editor.
6.2.2.5 – s Clear Btn
The Clear All menu item clears all Mask definitions, removing them from the display.
6.2.3 – s Options Cascade
The Options Menu is not implemented in this release of the Screen Editor.
6.2.3.1 – s RestS Btn
Settings menu item is not implemented in this release of the Screen Editor.
6.2.3.2 – s RestSys Btn
The Use System Defaults menu item is not implemented in this release of the Screen Editor.
6.2.3.3 – s RestAs Btn
The Use Saved Settings From... menu item is not implemented in this release of the Screen Editor.
6.2.3.4 – s SaveS Btn
The Save Current Settings menu item is not implemented in this release of the Screen Editor.
6.2.3.5 – s SaveAs Btn
The Save Current Settings As... menu item is not implemented in this release of the Screen Editor.
6.2.4 – s Help Cascade
The Help menu contains the following menu items that
let you display help for each window:
On Context
On Window
On Terms
On Version
For more information about using a Help menu item,
double click on an item from the list of additional
topics below.
6.2.4.1 – s OnContext Btn
Context-sensitive help is information about an object in a window or a dialog box. To display context-sensitive help, choose On Context from the Help menu. The pointer changes to a question mark. Move the question mark to a menu, a button, or another object and click MB1. Help for that object appears.
6.2.4.2 – s OnWindow Btn
To display an overview of the DTM : Screen Editor, along with help on how to perform various functions in the Screen Editor, choose On Window from the Help menu.
6.2.4.3 – s OnTerms Btn
To display a Glossary of terms used in DTM : Screen Editor, choose On Terms from the Help menu.
6.2.4.4 – s OnVersion Btn
To display information on the software version of DTM Screen Editor, choose On Version from the Help menu.
6.3 – s work Form
The Image/Mask Display and Edit Area is the main display and work area of the Screen Editor. Benchmark and Result images, and differences between Benchmark and Results are displayed in the Image/Mask Display and Edit Area of the Screen Editor. The Image/Mask Display and Edit Area is also used to display and define Masks.
6.3.1 – s work Gobe
The Image/Mask Display and Edit Area is the main display and work area of the Screen Editor. Benchmark and Result images, and differences between Benchmark and Results are displayed in the Image/Mask Display and Edit Area of the Screen Editor. The Image/Mask Display and Edit Area is also used to display and define Masks. For more information about using the Image/Mask Display and Edit Area double click on an item from the list of additional topics below.
6.3.1.1 – s Bmk Display
To display images of Benchmark screens, you must open an existing Benchmark file. To open an existing Benchmark file, choose Open Benchmark... from the file menu.
6.3.1.2 – s Res Display
To display images of Result screens, you must open an existing Result file. To open an existing Result file, choose Open Result... from the file menu.
6.3.1.3 – s Mask define
A Benchmark image must be displayed and the Screen or
Global Mask must be activated if you wish to create a
Mask.
To create a Mask:
1. In the Image/Mask Display and Edit Area, position
the cursor in one corner of the area you want to
mask and hold down.
2. Drag the mouse cursor over the area that is to be
masked.
3. Release when you have covered the area to be
masked.
6.3.1.4 – s Mask delete
To delete a Mask, position the cursor over the Mask you wish to delete and double click.
6.3.2 – s controls Form
The Controls Box of the Screen Editor window includes a variety of push-buttons and controls which allow you to display Benchmark and Result images in many ways. Using the push-buttons, you may compare and show differences between Benchmark and Result images.
6.3.3 – s WhatScr Lab
Display File Radio Buttons allow the user to select display of Benchmark, Result, Both and Difference images.
6.3.4 – s WhatScr Radio
Display File Radio Buttons allow the user to select display of Benchmark, Result, Both and Difference images.
6.3.4.1 – s Bmk Tgl
Click on the Benchmark Radio Button to display an image from the Benchmark file. The Benchmark Radio Button is one of the image display buttons in the set of Display File Radio Buttons.
6.3.4.2 – s Res Tgl
Click on the Result Radio Button to display an image from the Results file. The Results Radio Button is one of the image display buttons in the set of Display File Radio Buttons.
6.3.4.3 – s Bth Tgl
Click on the Both Radio Button to display a combined image of the Benchmark and Results file. The combined image helps you to locate differences between the Benchmark and Result images. The image will be set where either or both of the Benchmark and Result files are set and clear where both files are clear. The Both Radio Button is one of the image display buttons in the set of Display File Radio Buttons.
6.3.4.4 – s Dif Tgl
Click on the Differences Radio Button to display a combined image of the Benchmark and Results file. The combined image helps you to locate differences between the Benchmark and Result images. The image will be clear where the Benchmark and Result files are the same, and set where they are different. The Differences Radio Button is one of the image display buttons in the set of Display File Radio Buttons.
6.3.5 – s MaskOverlay Lab
The Mask Overlay Buttons allow you to control the display of Masks and to select the Masks for editing.
6.3.6 – s MaskOverlay Radio
The Mask Overlay Buttons allow you to control the display of Masks and to select the Masks for editing.
6.3.6.1 – s MaskScr Tgl
Click on the Mask Screen Button to display or edit Masks associated with the current screen.
6.3.6.2 – s MaskGbl Tgl
Click on the Mask Global Button to display or edit the global mask associated with all screens. Note that the global mask is not saved in the mask file and is not used when tests are compared. The purpose of the global mask is to eliminate differences which affect several screens when checking results of a unsuccessful test. After updating the global mask click the Compare All button to determine if any screens have further differences.
6.3.6.3 – s MaskNon Tgl
Click on the Mask None Button to hide all masks and disable mask editing.
6.3.7 – s Compare Lab
Click on a Compare Push Button to compare the Benchmark and Results images for the currently selected screen or all screens. The screen and global masks will be applied before comparing the images. The result of comparison will be displayed in the Screen List.
6.3.8 – s Compare Btn
Click on the Compare Screen Button to compare the Benchmark and Results images for the currently selected screen.
6.3.9 – s CompareAll Btn
Click on the Compare All Button to compare the Benchmark and Results images for all screens.
6.3.10 – s SList Lab
The Screen List displays the comparison status of each screen. A new screen can be selected by clicking on the screen number. If the comparison status of the selected screen is unknown, the screen is compared and the display is updated. If only one of the Benchmark or Result files are open, the Screen List is simply a numbered list of screens.
6.3.11 – s SList ScrLst
The Screen List displays the comparison status of each
screen as follows:
Unknown - No comparison yet performed or mask
updated since last comparison.
Successful - Benchmark and Result images are the
same.
Unsuccessful - Benchmark and Result images are
different.
No Result - The is no Result image for the screen.
No benchmark - The is no Benchmark image for the
screen.
A new screen can be selected by clicking on the screen
number. If the comparison status of the selected
screen is unknown, the screen is compared and the
display is updated.
If only one of the Benchmark or Result files are open,
the Screen List is simply a numbered list of screens.
6.3.12 – s msgtext Lab
The Messages area of the Screen Editor displays informational and error messages related to the use of the Screen Editor.
6.3.13 – s messagetext ScrTxt
The Messages area of the Screen Editor displays informational and error messages related to the use of the Screen Editor.
7 – s OpenBmkDB FileSel
To open an existing Benchmark file:
1. In the Directories list box, double click on the
directory where your Benchmark file is located.
2. Click on the Filter push button to list available
Benchmark files.
3. In the Files list box, double click on the
Benchmark file you want to open.
8 – s OpenResDB FileSel
To open an existing Result file:
1. In the Directories list box, double click on the
directory where your Result file is located.
2. Click on the Filter push button to list available
Result files.
3. In the Files list box, double click on the Result
file you want to open.
9 – s OpenMskDB FileSel
To open an existing Mask file:
1. In the Directories list box, double click on the
directory where your Mask file is located.
2. Click on the Filter push button to list available
Mask files.
3. In the Files list box, double click on the Mask
file you want to open.
To open a new Mask file:
1. In the Directories list box, double click on the
directory where you want the Mask file to reside.
2. Click on the Selection entry box. Enter the new
file name with an MXK file type. For example,
TESTMASKS.MXK.
3. Click on OK.
10 – s SaveMskDB FileSel
To replace an existing Mask file:
1. In the Directories list box, double click on the
directory where your Mask file is located.
2. Click on the Filter push button to list available
Mask files.
3. In the Files list box, double click on the Mask
file you want to save to.
To save a new Mask file:
1. In the Directories list box, double click on the
directory where you want the Mask file to reside.
2. Click on the Selection entry box. Enter the new
file name with an MXK file type. For example,
TESTMASKS.MXK.
3. Click on OK.
11 – s NotSavedDB Warn
If you want to quit the Screen Editor session without saving changes to the Mask file, click on OK. If you do not want to quit the Screen Editor session, click on Cancel.
12 – s UseSetDB FileSel
This feature is not implemented in the current release of the Screen Editor.
13 – s WriteSetDB FileSel
This feature is not implemented in the current release of the Screen Editor.
14 – s nyi Warn
Selected feature is not implemented in this version of the Screen Editor.