PMTESTER 3.00 Demo
-------------------

An Automated PM Application Testing Tool
----------------------------------------


Description
-----------

PMTESTER is an OS/2 PM application testing tool.
PMTESTER records all mouse and keyboard input while you perform
a test and allows you to replay the test when desired. And
because each test can be associated with one or more groups,
you can create a complete regression test suite in which all or
selected tests can be replayed at will to ensure your application
remains error-free after modifications. Since this is a demo,
saving of test groups and test cases will not occur.
Although not designed for creating demos, this tool can very
well be used to automate demos. The demo is documented via the
online "Help" built-in the product.

Features
--------

NEW! 1. Time Delayed Test Case Recording and Recording File Editing !

NEW! 2. Built-in Screen Capture and Comparison - Color and Monochrome !

3. Associate Multiple Test Cases with Test Groups

4. Associate Multiple Test Groups with a Product-Level

5. Multiple Product-Level Creation and Deletion

6. Automatic Execution of Selected Test Cases within a Test Group

7. Automatic Execution of Selected Test Groups within a Product-Level

8. Automatic Execution and Logging of Test Case Confirmation
Programs or DLL Routines

NEW! 9. Batch Execution of Test Cases !

NEW! 10. Import/Export Test Groups and Test Cases !

11. Enable/Disable Logging of Test Case Execution abd Confirmation
Routine Outcomes

12. Built-in File Comparison Confirmation Method

13. Modifiable Test Group and Test Case Description

PMTESTER A Regression Testing Tool Page 1
(C) Copyright 1989-1991 Princeton Windowing Systems

14. Internal Clipboard Functions for Test Case and Test Group
Manipulations (Cut, Copy and Paste)

15. One Touch Window Reorganization Key

16. Adjustable Audio Indication of Test Case Execution and Recording

17. User Configurable Test Case Execution Abort and Record Termination
Hotkeys

18. Adjustable Test Case Execution Speed

19. Complete On-line Help

NEW! 20. Display Log Function with Start and End Date and Time, Test Group
and Test Case Names !


Copyright
---------

PMTESTER is (C) Copyright 1989-1991 Princeton Windowing
Systems. All rights are reserved by the copyright owner. This
documentation is (C) Copyright 1989-1991 Princeton Windowing
Systems. All rights are reserved on this documentation by the
copyright owner.

No part of PMTESTER or this documentation may be reproduced,
stored in a retrieval system, or transmitted in any form or by

any means, electronic mechanical, photographic, magnetic, or
otherwise except in accordance with the Licensing Agreement
contained in this document, or without the express written
consent of Princeton Windowing Systems.


Licensing Agreement
-------------------

Permission is granted for the transfer of the PMTESTER
program and this documentation by any means under the condition
that the program and this document are together on the transfer
medium.

The PMTESTER program is provided for demonstration purposes.

You are also granted license to transfer this program as
long as it is accompanied by this document to electronic bulletin
boards (BBS's), or to your friends.

You are not permitted to change this document, or to modify
or reverse compile/assemble the PMTESTER program.



PMTESTER A Regression Testing Tool Page 2
(C) Copyright 1989-1991 Princeton Windowing Systems



Disclaimer
----------

The PMTESTER program and all accompanying documentation are
provided on an "AS IS" basis. This means that Princeton
Windowing Systems does not warrant, guarantee, or make any other
representations regarding the use, or results of use, of the PMTESTER
demo or the documentation in terms of accuracy, reliability,
correctness, currentness, or otherwise. Princeton Windowing Systems
will not be held responsible for any direct, indirect, incidental, or
consequential damages including damages for loss of business
profits, business interruption, loss of business information, or
otherwise arising from the use or inability to use PMTESTER, even
if Princeton Windowing Systems has been advised of the possibility
of such damages. The use of this product is on an "AT YOUR OWN
RISK" basis.



Ordering the Commercial Version of PMTESTER
-------------------------------------------

To order the commercial version(s) of PMTESTER, call or FAX to
(609) 921-6695 to place your order. PMTESTER is available at
$395.00 per copy, plus shipping and handling. You will be placed
on a mailing list for future update announcements upon ordering.



System Requirements
-------------------

The following software and hardware are required to run
PMTESTER:

1. OS/2 Version 1.2 or higher

2. An OS/2 compatible mouse

3. 200K of hard disk space for the Product files and
more as needed for storing Product-Levels and
test case recordings (100K +)

4. 200K of RAM above that needed for existing applications









PMTESTER A Regression Testing Tool Page 3
(C) Copyright 1989-1991 Princeton Windowing Systems


Installation
------------

First create a subdirectory on your hard disk to hold the
PMTESTER files. For example we will call our subdirectory TEST.

e.g. C:\TEST

In order to run PMTESTER, you must change the LIBPATH
statement in the CONFIG.SYS file to include the "*.DLL" files.
If you wish to set up a PATH for the new subdirectory (TEST),
follow steps 1 through 4, otherwise skip step 4.

1. Open the CONFIG.SYS file using any existing editor

2. Set the LIBPATH statement:

a. Place the PMTESTER subdirectory in the LIBPATH
statement. For example,

set: LIBPATH=C:\OS2\DLL;

to

LIBPATH=C:\OS2\DLL;C:\TEST;


OR


b. Copy the "*.DLL" files on the PMTESTER Product Disk
into a directory already in the LIBPATH statement.
For example, assuming the "C:\OS2\DLL" subdirectory
is in the LIBPATH statement,

type: COPY ?:\?\*.DLL C:\OS2\DLL

3. You must set the PMTESTER environment variable. Using
the TEST subdirectory we created above,

set: SET PMTESTER=C:\TEST\

NOTE: The complete Drive\Path\FileName are necessary.











PMTESTER A Regression Testing Tool Page 4
(C) Copyright 1989-1991 Princeton Windowing Systems


4. To set the PATH statement for the C:\TEST subdirectory,

change: PATH=C:\;C:\OS2;C:\OS2\SYSTEM;

to

PATH=C:\;C:\OS2;C:\OS2\SYSTEM;C:\TEST;


5. You must copy all of the PMTESTER Product files to
the directory you created (C:\TEST).

type: COPY ?:\?\*.* C:\TEST

The following files should be copied:

PMTESTER.EXE - PMTESTER application executable
PWSUTILS.DLL - Internal routines
PWSHOOKS.DLL - Internal routines
PASSCASE.EXE - Confirmation routine (Program - Pass)
PASSCASE.C - Confirmation routine (Program source)
FAILCASE.EXE - Confirmation routine (Program - Fail)
FAILCASE.C - Confirmation routine (Program source)
PASSDLL.C - Confirmation routine (DLL Function - Pass)
FAILDLL.C - Confirmation routine (DLL Function - Fail)
PMTESTER.HLP - PMTESTER online help
PMTESTER.DOC - PMTESTER documentation
PMT.EXE - Batch execution program
PMTDRIVE.CMD - Sample batch file
PMTTEST.CMD - Sample batch file



Starting PMTESTER
-----------------

Now you must reboot the system in order for the changes you
made in the CONFIG.SYS file to take effect. If the C:\TEST
subdirectory is in the PATH statement, you will be able to run
PMTESTER from the OS/2 command prompt in the directory specified
by the PMTESTER environment variable by typing "PMTESTER".
Otherwise you can make an entry in the "Group - Main" window
for PMTESTER (e.g., with the Working directory set to C:\TEST)
or you can change directories to C:\TEST and type "PMTESTER"
You can start PMTESTER in Hide Mode by typing "PMTESTER h". Hide
Mode is neccesary to run PMTESTER test cases from a bacth file.
(See *.CMD files).







PMTESTER A Regression Testing Tool Page 5
(C) Copyright 1989-1991 Princeton Windowing Systems


Usage
-----

PMTESTER is an OS/2 PM application testing tool. It enables
an application tester to record the keystroke and mouse events
(in the OS/2 PM session) which exercise a specific path or path
segment in an application and play them back at a later time.
Such a "test case" is associated with a "test group". Each
Product-Level can contain one or more test groups and each
test group can contain one or more test cases. There can also be
one or more test groups.

A selected list of test groups can be run once or continually until
a tester uses a special (modifiable) hotkey to stop the test.
Similarily, test cases can be selected within a test group for execution.
Each test case is run in the order beginning from the top and progressing
downwards.


Operations on a Product Level
-----------------------------

When you first start PMTESTER you have to create a Product Level under
which you can begin creating test groups and test cases. If there are
existing Product Levels, you can open the desired one. The "Operate on
Product Level" form window lets you create, delete & open any product level.

Operations on a product levels are done by selecting the Product Level
menu or by starting PMTESTER.

To create a product level, select the "Create" button in the "Operate
on Product Level" form window. Then type in the product and level names.

To open a product level, double click on the product level name or
select the product level name then choose the "Open" radio button.

To delete a product level, select the product level name then choose
the "Delete" radio button.
















PMTESTER A Regression Testing Tool Page 6
(C) Copyright 1989-1991 Princeton Windowing Systems


Create a Test Group or a Test Case and Case Confirmation Routine
----------------------------------------------------------------

A test group can be created at any time, however, a test case can
only be created in a defined group. Similarly, a case confirmation
routine can only be created within a defined case.

To create,

1. Select the Object menu then choose Create or press F5. A form window
will prompt for your input.
2. Select the object type
3. Enter the object name and description.

For test groups,
4. Select the "Create" button or press

For test cases,
4. Select the "Test Confirmation...", the "Case Confirmation Routine"
form window will appear
5. Enter the program name, DLL and function names, file names and
screen comparison type.
6. You can select the "Ok" button to save these options. Then press
the "Create" button to create the test case.


Record a Test Case
------------------

Only test cases and be recorded and only done one at a time.

To record a test case, select the test case to be recorded then choose
Record in the Object menu or press F7.

To abort any recording, just press the default Stop Record Hotkey -
.


















PMTESTER A Regression Testing Tool Page 7
(C) Copyright 1989-1991 Princeton Windowing Systems



Run One or More Test Groups or Test Cases
-----------------------------------------

There are several ways to run one or more test groups for test cases.
You can choose to run selected or all groups or cases once or forever.
These functions are listed below.

To run test group(s) and test case(s), select a list of the object to
run then choose Run... in the Object menu. Then choose one of the following:
1. Run Once or F8
2. Run Forever
3. Run All Groups
4. Run All Groups Forever
To terminate any of the Run functions, press the default Stop Run
Hotkey - .



Edit
----

The Cut, Copy and Paste functions do not use the PM clipboard. They
use a PMTESTER Internal Clipboard. Test groups can be cut but not pasted
or copied. Test cases can use any of these functions.



- Limitations
-----------

The following are the known limitations of the PMTESTER
program :

1. You cannot use a keyboard monitor for the PM session while
using PMTESTER.

2. Use of the WinGetPhysKeyState and WinQueryQueueStatus in the
application being tested may result in incorrect results
when running a test case.















PMTESTER A Regression Testing Tool Page 8
(C) Copyright 1989-1991 Princeton Windowing Systems