About Diagnostic Utility
What is Diagnostic Utility?

Diagnostic Utility is a program that is specially designed for Crystal Reports distribution. If a distributed report cannot run properly on a target machine, the Utility is able to help the user to find out the reason.


Diagnostic Utility Help Index

How To Use The Diagnostic Utility

The use of Diagnostic Utility is a two step process.  First, run the Diagnostic Utility on the source machine.  The program will find out the required runtime files to distribute the specific reports created by Crystal Reports and save all the information in a file.  Second, run the program on the target machine, the program will find out if the required files are actually on the target machine.  By comparing two file lists (on source machine and on target machine), the user can easily find out the reason why the distributed reports fail to  run on the target machine.

Important: For 16 bit operating system (For example, Windows 3.1).  Crystal Reports (on source machine) must be closed before running the Utility in order to obtain accurate detection result (It is better to close all the other applications even though they may not affect the detection result).

Commands

Detection menu

Options menu

View menu

Help menu


Show the help topic contents for Diagnostic Utility

Using this command to find the help you need.


Detection menu commands

The Detection menu offers the following commands:

Start	Start detection.
Exit	Exits the Diagnostic Utility.


Options menu commands

The Options menu offers the following commands:

Source Machine	The machine to create Crystal Reports and distribute them  (Must have Crystal Reports installed)
Target Machine	The machine to use the distributed reports (Usually without  Crystal Reports installed).


Target Machine

The machine to use the distributed reports (usually without Crystal Reports installed).


Source Machine

The machine to create and distribute reports (must have Crystal Reports installed).


View menu commands

The View menu offers the following commands:

Toolbar	Shows or hides the toolbar.
Status Bar	Shows or hides the status bar.


Help menu commands

The Help menu offers the following commands, which provide you assistance with this application:

Help Topics	Offers you an index to topics on which you can get help.
About	Displays the version number of this application.


Detection Start Command
Start command (Detection menu)

Use this command to start the detection process in Diagnostic Utility.

Shortcuts

Toolbar:


Save List command
Save List command (Source Machine Detection Results Dialog Box)

Use this command to save the file list to a file.  When you press the Save List button, Diagnostic Utility displays the Save As dialog box so you can name your list file.


File Save As dialog box

The following options allow you to specify the name and location of the file you're about to save:

File Name

Type a new filename to save a list with a different name.

Drives  and Directories

Select the drive and directory in which you want to store the file.


File Exit command
Exit command (Detection menu)

Use this command to end your Diagnostic Utility process.  You can also use the Close command on the application Control menu.

Shortcuts

Mouse:	Double-click the application's Control menu button.

Keys:	ALT+F4


Source Machine (Options menu)

Use this command to make a selection.  If this command is selected, the program will assume the machine you are currently using is source machine

Shortcuts

Toolbar:


Target Machine command (Options menu)

Use this command to make a selection.  If this command is selected, the program will assume the machine you are currently using is target machine.

Shortcuts

Toolbar:


View Toolbar command
Toolbar command (View menu)

Use this command to display and hide the Toolbar, which includes buttons for some of the most common commands in Diagnostic Utility, such as Options-Source Machine.  A check mark appears next to the menu item when the Toolbar is displayed.

See Toolbar for help on using the toolbar.


Toolbar

The toolbar is displayed across the top of the application window, below the menu bar.  The toolbar provides quick mouse access to many tools used in Diagnostic Utility,

To hide or display the Toolbar, choose Toolbar from the View menu (ALT, V, T).

Click	To

Start a detection process.

If this button is pressed, Diagnostic Utility will assume the current machine is source machine

If this button is pressed, Diagnostic Utility will assume the current machine is target machine


View Status Bar Command
Status Bar command (View menu)

Use this command to display and hide the Status Bar, which describes the action to be executed by the selected menu item or depressed toolbar button, and keyboard latch state. A check mark appears next to the menu item when the Status Bar is displayed.

See Status Bar for help on using the status bar.


Status Bar

The status bar is displayed at the bottom of the Diagnostic Utility window.  To display or hide the status bar, use the Status Bar command in the View menu.

The left area of the status bar describes actions of menu items as you use the arrow keys to navigate through menus.  This area similarly shows messages that describe the actions of toolbar buttons as you depress them, before releasing them.  If after viewing the description of the toolbar button command you wish not to execute the command, then release the mouse button while the pointer is off the toolbar button.

The right areas of the status bar indicate which of the following keys are latched down:

Indicator	Description

CAP	The Caps Lock key is latched down.

NUM	The Num Lock key is latched down.

SCRL	The Scroll Lock key is latched down.


About command (Help menu)

Use this command to display the copyright notice and version number of your copy of Diagnostic Utility.


Help Using Help Command
Context Help command

Use the Context Help command to obtain help on some portion of Diagnostic Utility.  When you choose the Toolbar's Context Help button, the mouse pointer will change to an arrow and question mark.  Then click somewhere in the Diagnostic Utility window, such as another Toolbar button.  The Help topic will be shown for the item you clicked.

Shortcut

Keys:	SHIFT+F1


Size command (System menu)

Use this command to display a four-headed arrow so you can size the active window with the arrow keys.

Note:  This command is obsolete in most new window application.

Shortcut

Mouse:	Drag the size bars at the corners or edges of the window.


Move command (Control menu)

Use this command to display a four-headed arrow so you can move the active window or dialog box with the arrow keys.

Note:  This command is obsolete in most new Windows application.


System Minimize Command
Minimize command (application Control menu)

Use this command to reduce the Diagnostic Utility window to an icon.

Shortcut

Mouse:	Click the minimize icon [image] on the title bar.

Keys:	ALT+F9


Maximize command (System menu) or Restore command (For maximized window)

Use this command to enlarge the active window to fill the available space.

Shortcut

Mouse:	Click the maximize icon [image] on the title bar; or double-click the title bar.


Close command (Control menus)

Use this command to close the active window or dialog box.

Double-clicking a Control-menu box is the same as choosing the Close command.


Restore command (Control menu)

Use this command to return the active window to its size and position before you chose the Maximize or Minimize command.


Source Machine Information
Source Machine Information Dialog Box

In the Select Reports section, you should select the reports you intend to distribute (or have already distributed).

In the Seagate Software Install Directory section, you should select the directory where crw32.exe (or crw.exe for 16 bit) is located if it is different from the default directory.  If you have more than one version of Crystal Reports installed in your system, the one you used to create the distribution reports should be selected.


Source Machine Detection Results
Source Machine Detection Result Dialog Box

If the Have Export Capability check box is uncheck (default), the list includes only the files which are required for the specific reports to print to window.

If the Crystal Report Components Only check box is unchecked (default), the list includes all the required files; if it is checked, the list includes the files shipped with Crystal Reports meaning that a licensed user of Crystal Reports have royalty-free right to distribute those files  (Assuming crwdll32.txt or crwdll.txt is placed in the same directory as this Utility).

.

Note: The system DLLs, such as user.dll, kernel.dll, etc., are not listed.

The Save List will save the information  in a file with special format for the target machine to use this Utility.

The Print Preview uses the notepad of Windows Application to view the file list.  It is only wysiwyg.  The file list has not been saved even thought you might have already used the notepad to save the file (except that you do not want to use Diagnostic Utility on the target machine)


Target Machine Information
Target Machine Information Dialog Box

In the Distribution List File Edit Box, the list file generated on the source machine should be entered with full path.

In the Directory of Distributed Reports Edit Box, the directory where all the distributed reports are located should be entered (Assuming all the distributed reports are in the same directory).  The Utility will automatically assign the current directory as the default directory to the Edit Box.


Target Machine Detection Results
Target Machine Detection Result Dialog Box

For the non-dll files, the Utility only search the distribution directory, if the expected files are not found in that directory, a Not found entry will be given.

For the dll files, the Utility will search distribution directory, crystal directory, system directory, the directories in the search path and, finally, all the directories in the current drive to see if the required files are in the current drive (Warning: If many files are missing, it will take a long time to search all the directories.  Hopefully, this case dose not happen).  If there are more than one file with the same name are in the current drive, the first-found file will be reported.

If there are differences in version or creation date between the files in source machine and target machine, the color of corresponding files on the target machine list will turn red.


Distribution Directory

Distribution Directory is the directory where the distributed reports are located.


Title Bar

The title bar is located along the top of a window.  It contains the name of the application.

To move the window, drag the title bar.  Note: You can also move dialog boxes by dragging their title bars.

A title bar contain the following elements:

Application Control-menu button

Maximize button

Minimize button

Name of the application

Restore button


No Help Available

No help is available for this area of the window.