DTMSCREDIT.HLB  —  ScrEdit

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.
Close Help