     ===========================================================
                      README for DriverTest v2.0
     ===========================================================

                Copyright (c) Oracle Corporation 2002.
                   All Rights Reserved, Worldwide.
     ===========================================================
     

THE MATERIALS PROVIDED HERE ARE FOR SAMPLE USE AND ARE PROVIDED "AS-IS";
ORACLE DISCLAIMS ALL EXPRESS AND IMPLIED WARRANTIES, INCLUDING, THE IMPLIED
WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR USE. ORACLE SHALL
NOT BE LIABLE FOR ANY DAMAGES, INCLUDING, DIRECT, INDIRECT, INCIDENTAL,
SPECIAL OR CONSEQUENTIAL DAMAGES FOR LOSS OF PROFITS, REVENUE, DATA OR DATA
USE, INCURRED BY YOU OR ANY THIRD PARTY IN CONNECTION WITH THE USE OF THESE
MATERIALS.

Table of Contents 
=================                                    
  - Overview
  - Supported Platforms
  - Package
  - To install and run the DriverTest
  - Running Options
  - Test Results
  - Examples
  - Known Issues
  - Changes in this distribution  

Overview
========
The DriverTest utility checks whether installed printer drivers are compatible
with standard Windows printing Application Programming Interfaces (APIs) used
by Oracle Reports. Oracle Reports supports printing on Windows platforms through
printer vendor and Microsoft supplied printer drivers, which are accessed 
through the corresponding standard Windows printing APIs.

Oracle Reports makes extensive use of the functionality offered through the
Windows APIs, and makes use of printer functionality not typically
used by desktop productivity applications, so it can expose problems not seen
in other applications.  If a specific printer driver does not adhere to the
functionality offered through the standard windows APIs, Oracle Reports cannot
successfully interact with those printer drivers. Oracle considers such issues
to be bugs in the printer driver and not bugs with Oracle Reports.


Supported Platforms
===================
  - Windows 95,98,2000,NT,XP


Package
==========
  - DriverTest.zip

    [ .\DriverTest ]
    1. ReadMe.txt
    2. driverTest.exe : Application to test a printer driver
    3. errLookup.txt  : Error message lookup with cause/action/workarounds  

To install and run DriverTest
=================================

    1.  Go to Control Panel->Printers and set the default printer to the
	printer you want to test. You can skip this step if you are going
        to specify the printer name on the command line.
    2.  Open a DOS window (CMD.exe or COMMAND.exe) to get a C: prompt.
    3.  Either "cd" to the directory where the DriverTest.exe resides or
        have it in your path. 
    4.  Type driverTest

Running Options
================
  Usage: driverTest.exe [PRINTER=printername] [OUTFILE=filename]
         [LOGFILE=filename] [SHOWPROPS=yes/no]
         
  PRINTER
    - Name of the printer whose driver name you want to test.  If the printer
      name has spaces in it, use quotes around the name.
    - Default: Windows Default Printer
       
      Syntax:
      PRINTER=printername
    
  OUTFILE
    - Name of the file to contain comprehensive test results and details 
      of the failures.  Use quotes if the filename has spaces in it.
    - Default: DriverTest.out in current working directory
      
      Syntax:
      OUTFILE=outfile
      
  LOGFILE
    - Name of the file to contain test results.  Use quotes if
      the filename has spaces in it.
    - Default: output directly to command window
        
      Syntax:
      LOGFILE=logfile
 
  SHOWPROPS
    - Controls whether to show Printer Document properties dialog box.  The
      dialog will be displayed twice.  The first time you may make changes
      to the settings before the test begins.  The second time the dialog
      box displays the settings should be identical to what they were when
      you last set them.  NOTE: Do not change any settings when the dialog
      box is displayed the second time, or the program will report errors.
       
      Syntax:
      SHOWPROPS={YES | NO}

Test Results
============
If the test shows a result of "UNSUCCESSFUL", you should check with the printer
vendor and Microsoft to see if a newer version of the printer driver is
available for your operating system for download and installation.

If you have the latest printer driver installed and the test results remain
UNSUCCESSFUL, check errLookup.txt for possible workarounds.  If you remain
unsuccessful, please contact Oracle Support for further assistance.

Examples
========

  DriverTest
    - tests the current windows default printer.

  DriverTest PRINTER="Gizmo 330MarkV"
    - tests the driver for the specified printer.

  DriverTest PRINTER=\\MOUSE\LASERPRINTER320 SHOWPROPS=YES
    - tests the specified network printer driver, displaying the printer
      dialog first.  Note the printer dialog is displayed twice; once to allow
      settings to be changed interactively, the second time to show that the
      settings remain changed after interacting with the driver programatically.

  DriverTest PRINTER="Widget 5iLS" OUTFILE="C:\TEMP\Widget 5iLS TestResults.out"
    - performs testing on the specified printer driver, outputting
      detailed test results in the specified file.


Known Issues
============

1) If you specify SHOWPROPS=YES and then cancel the first properties dialog
   box, the program will crash.

2) If you specify SHOWPROPS=YES and then cancel the second properties 
   dialog box, the program will incorrectly report an error with the 
   printer driver.

3) Some printer drivers will display printer specific dialog boxs, even if
   SHOWPROPS=NO (default setting).

Changes in this Distribution
============================
DriverTest 2.0 is a highly revamped, productized version of the previous
utility.




