














                           WinDump
                         Version 1.1
                         User's Guide




































           Copyright (c) 1991, 1992 John A. Napier
                     All rights reserved













































Microsoft and MS-DOS are registered trademarks, and Windows is
a trademark of Microsoft Corporation.

IBM is a registered trademark of  International Business
Machines.

Documentation produced by A.N.N International.



Copyright (c)1991, 1992 John A. Napier. All rights reserved.


                              2

                   DISCLAIMER AND AGREEMENT

Users of WinDump must accept this disclaimer of warranty. If
you do not accept this disclaimer, do not use WinDump.

"WINDUMP IS SUPPLIED AS IS. THE AUTHOR DISCLAIMS ALL
WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING, WITHOUT
LIMITATION, THE WARRANTIES OF MERCHANTABILITY AND OF FITNESS
FOR ANY PURPOSE. THE AUTHOR ASSUMES NO LIABILITY FOR DAMAGES,
DIRECT OR CONSEQUENTIAL, WHICH MAY RESULT FROM THE USE OF
WINDUMP, EVEN IF THE AUTHOR HAS BEEN ADVISED OF THE
POSSIBILITY OF SUCH DAMAGES."

"THE LICENCE AGREEMENT AND WARRANTY SHALL BE CONSTRUED,
INTERPRETED AND GOVERNED BY THE LAWS OF ENGLAND AND WALES. YOU
MAY HAVE OTHER RIGHTS WHICH VARY FROM ONE STATE TO ANOTHER."

WinDump is a shareware program, and is provided at no charge
to users for evaluation. Feel free to share it with your
friends and colleagues, but please do not give it away altered
or as part of another system. The essence of user-supported
software is to provide computer users with quality software
without high prices, and at the same time to provide incentive
for programmers to continue to develop new products.

If you find WinDump useful, and that you are continuing to use
it after the trial period of 30 days, you must make a
registration payment of UK10 pounds or US$20 to John Napier,
1 Wayside Green, Woodcote, Reading, RG8 0PR, United Kingdom.
The registration fee will license one copy for use on any one
computer at any one time. You will also receive a fully
registered copy of WinDump, a printed copy of the User Guide,
a free upgrade to the next major version when it becomes
available, and 90 days' free support.

Site Licence arrangements may be made by contacting John
Napier.

Any person or organisation wanting to distribute WinDump for
profit must first contact John Napier at the address above for
authorisation.















                              3

                      TABLE OF CONTENTS


1 Introduction                                               6
  What is WinDump?                                           6
  WinDump is shareware                                       6
  How to use this guide                                      7
  Conventions used in this guide                             7

2 Installation                                               9
  Contents of this release                                   9
  Hardware and software environment                          9
  Installing WinDump on your hard disk                       9
  Running WinDump                                            9
  Installing a WinDump upgrade                              10

3 Basic Concepts                                            11
  Files                                                     11
  Offsets                                                   11
  Hexadecimal notation                                      12
  Character sets                                            12

4 How to.... guide                                          13
  How to get on-line Help                                   13
  How to open a file                                        13
  How to display a file's contents                          14
  How to find the right place in the file                   14
  How to compare files                                      15
  How to watch a file in real-time                          15
  How to print a file                                       15

5 Command Reference                                         16
  File Commands                                             16
     Open                                                   16
     Close                                                  16
     Info                                                   16
     Print                                                  17
     Print Status                                           18
     Exit                                                   18
     File History                                           18
  Search Commands                                           19
     Beginning of File                                      19
     End of File                                            19
     Go To                                                  19
     Find                                                   19
     Find Status                                            20
     Find Again                                             20
     Reverse Find Again                                     21
     Differences                                            21
     Differences Status                                     21
     Next Difference                                        22
  Options Commands                                          22
     ANSI System Font                                       22



                              4

     ANSI Courier Font                                      22
     OEM Terminal Font                                      22
     Offsets in Hex                                         22
     Lowercase Hex                                          23
     Multi-Scroll                                           23
     Auto-Refresh                                           23
     Fill Window                                            23
     Preferences                                            24
  Window Commands                                           25
     Cascade                                                25
     Tile                                                   26
     Stay Tiled                                             26
     Arrange Icons                                          26
     Close All                                              26

6 Troubleshooting                                           27
  Common Problems                                           27
  Getting Support                                           29

7 More about Shareware                                      31




































                              5


                          CHAPTER 1
                         INTRODUCTION


What is WinDump?

WinDump is the hexadecimal dump program for Microsoft Windows.
It is for software developers, support staff and advanced
users who have a need to look in detail at the contents of
files. It goes much further than text file programs such as
Notepad because it lets you look at the hexadecimal values of
the constituent bytes, rather than just the graphic characters
they represent.

WinDump is flexible in the way that files are displayed, and
offers a number of useful tools, some of which are outlined
below. The main features of WinDump V1.1 are that it:

* displays any number of files simultaneously, subject only to
  resource limits imposed by Windows

* adjusts the display to fit the window size that you select

* moves rapidly around a file, using scroll bars or a direct
  Go To command

* finds character or byte strings fast

* compares two files and highlights the differences

* can print out all or part of a file

* has a special display option that lets you watch a file's
  contents change in real-time

* contains full on-line Help.


WinDump is shareware

Shareware means 'try before you buy'. You can evaluate a full,
unrestricted copy of WinDump on your own computer, using your
own files, in the comfort of your own home or office, for up
to 30 days. Once you are sure that WinDump will be useful to
you, you must register it. Simply print out the file
WINDUMP.REG, fill in the details, and send it with the
registration fee (UK10 pounds or US$20) to the address shown.
(If you cannot find the file, use the Registration command in
WinDump's Help menu.) In return, you will receive the
following:

* An up-to-date, registered copy of WinDump.




                              6
* A free registered copy of the next major version of WinDump,
  when it becomes available.

* A printed copy of the WinDump User Guide.

* Free support - see Chapter 6, Troubleshooting for details.

Please remember that WinDump is not free. It is copyrighted
software written to professional standards. If you continue to
use it after your evaluation period of 30 days, you must
register it. In doing so, you will be helping to support the
Shareware concept, which aims to supply high quality software
at low prices. Please see Chapter 7, More about Shareware for
more information about Shareware.

If you are interested in a Site Licence for WinDump, please
contact the author directly.


How to use this guide

This manual is organized on a 'task oriented' basis, so that
information is presented in the order in which you will need
it. Here is a summary of what the WinDump User's Guide
contains:

Chapter 1, Introduction gives you some basic information about
WinDump, such as detailing some of its features, as well as
telling you what benefits you will get when you register your
copy of WinDump.

Chapter 2, Installation tells you how to install WinDump on
your computer. This is a straightforward procedure with no
surprises.

Chapter 3, Basic Concepts explains some of the basics
underlying WinDump. Read this if you are new to the concept of
dumping files.

Chapter 4, How To ...Guide takes you step-by-step through the
various features and facilities offered by WinDump. The
coverage of each topic is sufficient to get you started.

Chapter 5, Command Reference gives a full description of each
command, in menu order, with hints on how to get the best from
WinDump.

Chapter 6, Troubleshooting will help in the unlikely event
that you experience problems with WinDump. There is a
discussion of the most common sources of trouble, as well as a
list of error messages with explanations. If you still need
help, this chapter includes information on how to obtain
technical support.



                              7

Chapter 7, More About Shareware gives more information on
Shareware and its place in the software scene.


Conventions used in this manual

Names in angled brackets indicate names of keys on the
keyboard, such as <PageDn>. If there is more than one name,
such as <Ctrl+F4>, it means that the <Ctrl> key should be held
down while the <F4> key is pressed.

'NOTE' gives you some extra information that you should pay
particular attention to.











































                              8


                          CHAPTER 2
                         INSTALLATION


Contents of this release

WinDump is distributed on one diskette, and consists of the
following files:

WINDUMP.EXE    -the program
WINDUMP.HLP    -the help file
WINDUMP.TXT    -the User Guide (plain ASCII)
WINDUMP.REG    -registration form (plain ASCII)
README.TXT     -last-minute release information (plain ASCII)


Hardware and software environment

WinDump requires Microsoft Windows V3.0 or later. It is
generally accepted that Windows requires a minimum
configuration of 80286 processor, 2 Megabytes of main memory,
EGA display, and a hard disk. Although less powerful
configurations do work, the performance levels may not be
acceptable for all purposes.


Installing WinDump on your hard disk

It is a good idea to backup your WinDump distribution diskette
before you install WinDump. You can use the MS-DOS DISKCOPY
command, or something similar, to make the duplicate.

Next, copy all the files from the distribution diskette into
the directory on your hard disk from which you wish to run
WinDump. This directory should be on your execution path. Copy
the files using the Windows File Manager or the MS-DOS COPY
command.

NOTE It is important that WINDUMP.EXE and WINDUMP.HLP remain
     in the same directory, and that you do not rename either
     file.

When you run WinDump for the first time, a small file called
WINDUMP.INI will be placed in your Windows directory. This
contains option settings and other information that WinDump
needs to save from one session to the next.

NOTE Do not move this file from the directory where it has
     been created.


Running WinDump




                              9
Start WinDump by using one of these methods:

* Place WinDump in one of your Program Manager groups and then
  double-click on the WinDump icon to run the program.

* Type WINDUMP.EXE in the Run ... command of the File menu in
  Windows File Manager or Program Manager.

* Double-click on the WINDUMP.EXE entry in a File Manager
  directory listing.

Once WinDump has started up, you should be able to use the
Open command in the File menu to open a file and view its
contents. Press <F1> to bring up the WinDump Help index, and
confirm that the help file is installed correctly. If WinDump
fails to run properly, refer to the troubleshooting guide in
Chapter 6.


Installing a WinDump upgrade

When installing an upgrade, follow the same procedure as for
the first installation. You may choose whether to replace the
old version in the same directory, or place the new version in
a different directory. It is probably less trouble to replace
the old one.

The WINDUMP.INI file does not require any attention when
upgrading. It will continue to operate with any version of the
program.


























                              10


                          CHAPTER 3
                        BASIC CONCEPTS


The information in this chapter is intended for readers who
are not familiar with all the concepts involved when dumping
files using a hexadecimal dump program. Readers who feel
confident in this subject may safely skip to the next chapter.


Files

Files that you can read using WinDump are usually one of the
following types:

* Text -either plain or with formatting information
* Program -such as an EXE or COM file that you can run
* Data -such as a database

There are many other specialized types of file, but they all
essentially reduce down to one of the above. Many types of
file have some kind of internal record structure that is
specific to the way that the files are used.

WinDump treats all files as a simple series of bytes, and
displays these bytes in a file window. It does not recognise
any kind of internal structure.


Offsets

An offset is WinDump's way of referring to a position within a
file. Since a file is treated as a simple series of bytes,
WinDump can refer to any particular byte by its distance from
the beginning of the file. This is the byte's offset. For
example, the first byte of a file has an offset of 0, the
second byte has an offset of 1, and so on.

The largest offset that WinDump can handle is 7FFFFFFE
hexadecimal, or 2,147,483,646 decimal, which corresponds to a
maximum file size of over 2 gigabytes. WinDump displays file
offsets down the left-hand side of the file window.


Hexadecimal notation

Hexadecimal (or simply hex) notation is used widely in the
computer world because it matches very closely the computer's
own representation of numbers, which of course is based on
bits and bytes (taken here to mean groups of 8 bits).

The hexadecimal system is based on 16 different digits instead
of the 10 used in the decimal system. These are:


                              11

0, 1, 2, 3, 4, 5, 6, 7, 8, 9, A, B, C, D, E, F

which correspond to the decimal values 0 - 15. A single hex
digit therefore represents a 4-bit value, and two digits
represent the value of a byte. E.g. 3D hex corresponds to 61
decimal, and 00111101 in binary. This is exactly how WinDump
uses hex notation to display the contents of each byte of a
file.

WinDump uses hex or decimal to represent file offsets: this is
a switchable option.


Character sets

In addition to the hexadecimal values of the bytes in a file,
WinDump also displays the corresponding graphic characters.
These can be useful when the file contains a mixture of binary
data and text.

The relationship between byte values and graphic characters is
controlled by the character set selected. Windows mostly uses
the ANSI character set, but you may occasionally need to view
a file in the OEM character set, which is effectively the IBM
PC character set used under straight MS-DOS. Note that the
ANSI and OEM character sets are the same for byte values in
the range 20 - 7E hexadecimal. This means that letters,
numbers and common punctuation symbols will appear the same in
both character sets.



























                              12


                          CHAPTER 4
                       HOW TO... GUIDE


The topics in this chapter are arranged as a tutorial,
exploring all the features of WinDump in a step-by-step
fashion. If you are looking for detailed information on
specific commands, please use Chapter 5, Command Reference.


How to get on-line Help

WinDump uses the Windows help system to provide on-line
information as and when you need it. This information is a
little more concise than the material presented in this User
Guide, and is ideal for jogging your memory on specific
commands.

Refer to your Windows User's Guide for more information about
the help system, or select the Using Help option from the
WinDump Help menu.

The WinDump Help menu has three further options:

Index               shows the main help index for WinDump
Command Reference   shows the index to the commands section
How To              shows the index to the on-line 'How To'
                    topics

There is also a quick way of getting help: press the <F1> key,
or click the right mouse button (or the left button if you
have reversed them). This will normally take you straight to
the main index, but if you are in a dialog box or status
window, it will give you help related to what you are doing.


How to open a file

You must open a file before WinDump can display its contents,
or dump them to your printer.

1.   Choose the Open command from the File menu.
2.   Complete the dialog that tells WinDump the name of the
     file and where to find it.

Don't forget that you can press <F1> or click the right mouse
button during the dialog in order to get help.

There is also a quick way to open a recently used file -click
on one of the names that appear at the bottom of the File
menu. This is called the File History.

Once you have opened the file, WinDump will display the first


                              13

part of its contents in a new window.


How to display a file's contents

For each of the files that you open, WinDump maintains a
separate file window within the main WinDump window. Use these
commands from the Window menu to control how they are
arranged:

* Cascade to overlap the file windows.
* Tile to arrange the file windows with no overlap.
* Stay Tiled to ensure that the file windows remain tiled as
  you open and close files.

Use the next set of commands from the Options menu to choose a
character set and font from one of the following:

* ANSI System Font
* ANSI Courier Font
* OEM Terminal Font

The final three commands are also from the Options menu:

* Offsets in Hex switches the file offset values between
  decimal and hexadecimal.

* Lowercase Hex controls how hexadecimal digits are
  represented.

* Fill Window controls how many bytes are dumped per line. You
  can choose either to display 1,2,4,8,16, 32 etc. bytes per
  line, or to fill the whole width of the window size that you
  have set.

You can make your choice of display options permanent by using
the Preferences command from the Options menu.


How to find the right place in the file

There are three ways to move around a file using WinDump:

* Use the mouse or keyboard with the scroll bar to move
  forwards or backwards. The <PageUp>, <PageDn>, <Home>, <End>
  and arrow keys have their usual meanings.

* Jump to the offset that you require, using the Beginning of
  File, End of File or Go To commands from the Search menu.

* Search for a string within the file using the Find command,
  also in the Search menu.




                              14

How to compare files

Compare the contents of two files using these methods:

* Open the files that you want to compare, and move to the
  areas that interest you. Make a visual comparison of the
  contents. This method also works for more than two files,
  and is made easier if you select the Multi-Scroll command
  from the Options menu.

* Use the Differences command from the Search menu. This makes
  a comparison of two files, and highlights the parts that
  differ.


How to watch a file in real-time

Select the Auto-Refresh command from the Options menu. This
causes WinDump to update all the open file windows at a fixed
interval, which you can adjust in the Preferences dialog.

This means that you can detect any changes made to a file by
another application as soon as they happen. This can be useful
when you are debugging an application that generates a log or
trace file, or when you want to find out when certain bytes in
a file are changed by an application.


How to print a file

Use the Print command from the File menu to print all or part
of the current file. The Print dialog lets you choose how much
of the file to print, and tells you how many pages it will
occupy.

The printout appears very similar to the screen version,
except that each page carries a header containing the
filename, page number, and date and time of printing. A
minimum margin of 0.5 inches is applied to each side of the
print area; you can set larger margins using the Printer Setup
dialog in the Windows Control Panel, if it supports this
feature for your printer.

The Offsets in Hex, Lowercase Hex and Fill Window commands
affect the appearance of the printout in the same way as they
do for the display.










                              15


                          CHAPTER 5
                      COMMAND REFERENCE

This section is a reference to all of the menu commands in
WinDump.


FILE COMMANDS

_Open_

Use this command to open a file for dumping or printing. Also,
see File History for a quick way to open files.

The File Open dialog box contains the following fields:

Filename       Enter a filename, directory path or wildcard
               expression. Standard DOS wildcards such as
               *.dat are supported.

Directory      Shows the current disk drive and directory.

Files          Double-click on a name to open the file.

Directories    Double-click on a directory or disk-drive to
               select it.

File Info      Shows the size of the selected file, and the
               date and time it was last written.

OK             Opens the selected file.

Cancel         Quits the dialog.


_Close_

Use this command (in the File window's control menu) to close
the currently active file window.

The keyboard shortcut for Close is <Ctrl+F4>.

NOTE Be careful not to confuse this with the Close command in
     the main window's contro l menu -this closes your WinDump
     session in the same way as the Exit command.


_Info_
Use this command to display information about the current file
in a pop-up window. The window closes automatically when you
close the file to which it refers, or you can close it
manually by double-clicking on its control-menu box.



                              16

The File Info screen contains the following fields:

Filename         Note that WinDump may abbreviate long
                 pathnames by replacing some of the directory
                 names with '...'. It shortens the path by
                 removing the beginning of the pathname so
                 that it can include the full name of the
                 file. For example:
                 c:\bin\prog\pascal\testing\source\amelia.pas
                 might be shown as c:\...\source\amelia.pas

Size             File size in bytes, both hexadecimal and
                 decimal.

Written          Date and time of the last occasion that data
                 was written to the file. This is not always
                 the same as the creation date and time.

Attributes       May include: Read-Only, System, Hidden, and
                 Archive.



_Print_

Use this command to print the current file on your printer.
This is the default printer which is identified in the
Printers dialog of the Windows Control Panel. If you have not
already set one up, now is the time to do so using Control
Panel.

The fields on the Print screen are:

Filename         Shows which file will be printed.

Printer          Shows which printer and port will be used.

Current Window   Print only what is visible in the current
                 file window.

Whole File       Print the entire file.

From Offset      Enter the start and end offsets defining the
                 part of the file to print. Use hexadecimal
                 notation if you have selected the Offsets in
                 Hex option.

Pages            Shows how many pages the printout will
                 occupy.

Character Set    Shows which character set will be used. This
                 is controlled by the choice made in the
                 Options menu. A few Windows printer drivers
                 do not offer an OEM character set. In these


                              17

                 cases, ANSI will be used.

Print            Start printing, and display the Print Status
                 window.

Cancel           Quits the dialog.


_Print Status_

This window appears when you start a print operation from the
Print command in the File menu.


Page      Page number currently being processed by WinDump.

%         Percentage complete (both graphic and numeric). This
          does not necessarily mean that the printer has
          printed this much of the file, as there are numerous
          intermediate files and buffers involved in the
          process.

Cancel    Press this if you want to abandon the print
          operation immediately.

NOTE When the Print Status window is displayed, you cannot do
     any further work with WinDump until either the printing
     is complete, or you cancel it. However, you can still
     work with other programs, although as usual with Windows
     printing, you might find that response times are a little
     longer than normal.


_Exit_

This command causes an immediate exit from WinDump. All open
windows are closed and the File History list is saved, ready
for the next time you start WinDump.

The keyboard shortcut for Exit is <Alt+F4>.


_File History_

This is the list that appears at the bottom of the File menu,
showing the names of the last 8 files that you have opened.
The latest file is shown at the top, and the earliest at the
bottom.

Click on one of the files in the list to open it. This is
quicker than using the Open command because there is no need
to complete a dialog.

When you exit WinDump, the File History list is saved, ready


                              18

for the next session.

SEARCH COMMANDS


_Beginning of File_

Use this command to change the current position to the very
beginning of the current file.

The effects are that the window displaying the file starts at
offset 0, and commands based on the current position, such as
Print, Find, Find Again and Reverse Find Again will act from
the beginning of the file.

The keyboard shortcut for Beginning of File is <Home>.


_End of File_

Use this command to change the current position to the very
end of the current file.

The effects are that the window displaying the file ends at
the last byte of the file, and commands based on the current
position, such as Print, Find, Find Again and Reverse Find
Again will act from the end of the file.

The keyboard shortcut for End of File is <End>.


_Go To_

Use this command to change the current position of the current
file by specifying the required offset.


File Offset      Enter the offset that you require, or select
                 a value from the list by clicking on it. The
                 list contains the last 16 offsets. Use
                 hexadecimal notation if you have selected the
                 Offsets in Hex option.

OK               Goes to the specified offset.

Cancel           Quits the dialog.


_Find_

Use this command to locate a string of bytes in the current
file. Use Find Again to find the next occurrence of the
string, or Reverse Find Again to find the previous occurrence.
Text             Enter the string that you want to search for,


                              19

                 using up to 32 plain text characters, or
                 click on a string from the drop-down list.

Hex              Enter the hexadecimal values of up to 32
                 bytes (two hexadecimal digits per byte), or
                 click on a string from the drop-down list.

Case Sensitive   Check this if you want to distinguish between
                 uppercase and lowercase letters.

Beginning        Search forwards from the first byte of the
                 file.

End              Search backwards from the last byte.

Forward          Search forwards from the current position.

Backward         Search backwards from the current position.

OK               Start searching, and display the Find Status
                 window.

Cancel           Quit the dialog.

NOTE If you enter a zero byte (hex 00) into the Hex box, no
     further characters will appear in the Text box, although
     you can continue to use the Hex box. This is due to the
     way that Windows handles text strings.


_Find Status_

This window appears when you start a search from the Find
command in the Search menu.

Offset    The file offset at which WinDump is currently
          searching.

%         Percentage complete (both graphic and numeric).

Cancel    Press this if you want to abandon the search
          immediately.

NOTE When the Find Status window is displayed, you cannot do
     any further work with WinDump until either the search is
     complete, or you cancel it. However, you can still work
     with other programs, although you might find that
     response times are a little longer than normal because of
     the processor and disk activity involved in the search.


_Find Again_

Use this command to continue a search:


                              20

* with the same search string as the last Find command, and
* in the same direction.

Use Reverse Find Again to reverse the search.

The keyboard shortcut for Find Again is <F3>.


_Reverse Find Again_

Use this command to continue a search:

* with the same search string as the last Find command, but
* in the opposite direction.

Use Find Again to search in the original direction.

The keyboard shortcut for Reverse Find Again is <Shift+F3>.


_Differences_

Use this command to compare two files. You can select it only
when there are two files open.

Use Next Difference to find the next difference once you have
started a comparison.

Use the Differences Capture Range setting in the Preferences
dialog to control how the files are compared.

OK        Starts the comparison, and displays the Differences
          Status window.

Cancel    Quits the dialog.


_Differences Status_

This window appears when you start a comparison from the
Differences command in the Search menu.

Offset    The offset at which WinDump is currently comparing
          the files.

%         Percentage complete (both graphic and numeric).

Cancel    Press this if you want to abandon the comparison
          immediately.

This may not take effect immediately if WinDump is analysing a
difference rather than just searching for a difference.

NOTE When the Differences Status window is displayed, you


                              21

     cannot do any further work with WinDump until either the
     comparison is complete, or you cancel it. However, you
     can still work with other programs, although you might
     find that response times are a little longer than normal
     because of the processor and disk activity involved in
     the comparison.


_Next Difference_

Use this command to continue a comparison of two files already
started with the Differences command.

The keyboard shortcut for Next Difference is <F4>.


OPTIONS COMMANDS


_ANSI System Font_

Use this command to display the current file with the ANSI
character set in the System fixed-pitch font. See ANSI Courier
Font and OEM Terminal Font later in this section.

Use the Preferences command to change the default font used by
WinDump.


_ANSI Courier Font_

Use this command to display the current file with the ANSI
character set in Courier fixed-pitch font. See also ANSI
System Font and OEM Terminal Font.

Use the Preferences command to change the default font used by
WinDump.


_OEM Terminal Font_

Use this command to display the current file with the OEM
character set in the Terminal fixed-pitch font. See also ANSI
System Font and ANSI Courier Font.

Use the Preferences command to change the default font used by
WinDump.


_Offsets in Hex_

Use this command to display the offset values of the current
file in hexadecimal. Use it a second time to restore the
offset values to decimal.


                              22

Use the Preferences command to change the default setting of
Offsets in Hex.


_Lowercase Hex_

Use this command to display the contents of the current file
with the hexadecimal digits '0' - '9', 'a' - 'f'. Use it a
second time to cause the digits '0' - '9', 'A - 'F' to be
used.

Use the Preferences command to change the default setting of
Lowercase Hex.


_Multi-Scroll_

Use this command to turn on the Multi-Scroll option. Use it a
second time to turn the option off.

When active, Multi-Scroll allows you to scroll all the WinDump
windows simultaneously, by clicking or dragging on only one of
the scroll-bars, or by using the keyboard scrolling keys
(<PageUp>, <PageDn>, <Home>, <End>, and the four arrow keys).

Use the Preferences command to change the default setting of
Multi-Scroll.

HINT You may find that the Stay Tiled option works well with
     Multi-Scroll.


_Auto-Refresh_

Use this command to turn on the Auto-Refresh option. Use it a
second time to turn the option off.

Auto-Refresh regularly redisplays all the WinDump windows when
it is active. This lets you watch the contents of a file
change in real- time; for example whilst another application
generates a report or log file.

Use the Preferences command to change the default setting of
Auto-Refresh, and also to adjust the rate at which the windows
are redisplayed.


_Fill Window_

Use this command to turn on the Fill Window option. Use it a
second time to turn the option off.

For convenience, WinDump normally formats file windows so that



                              23

there are 1, 2, 4, 8, 16, or 32, etc. bytes displayed in each
line of the dump (depending upon the width of the window).

If the Fill Window option is on, WinDump packs as many bytes
into each line as it can, which uses the available window
space efficiently, but might be less convenient for some
purposes.

Use the Preferences command to change the default setting of
Fill Window.

NOTE Fill Window works the same way when you print a file.


_Preferences_

Use this command to set option defaults used in other parts of
WinDump. The settings can be saved, to be re-established next
time you start up WinDump.

The options shown in this window fall into 3 categories:

* default font options
* permanent option settings
* parameter settings

Default Font Options
     These three options affect only new file windows and they
     are also saved for future sessions. If you want to change
     an existing window, use the font control commands (ANSI
     System Font, ANSI Courier Font and OEM Terminal Font)
     from the Options menu.

     ANSI System    Sets the ANSI System font as the default
                    font

     ANSI Courier   Sets the ANSI Courier font as the default
                    font

     OEM Terminal   Sets the OEM Terminal font as the default
                    font

Permanent Option Settings
     The next six settings take effect from the next time that
     you start up WinDump. Use the corresponding commands in
     the Options and Window menus if you want to change the
     current display.

     Offsets in Hex Check this to display file offsets in
                    hexadecimal. Uncheck it to display them in
                    decimal.

     Lowercase Hex  Check this to use the hexadecimal digits
                    '0'- '9', 'a'-'f'. Uncheck it to use '0'-


                              24

                    '9', 'A'-'F'.

     Stay Tiled     Check this to set the Stay Tiled option.

     Multi-Scroll   Check this to set the Multi-Scroll option.

     Auto-Refresh   Check this to set the Auto-Refresh option.

     Fill Window    Check this to set the Fill Window option.

Parameter Settings
     These take effect immediately, as well as being saved for
     future WinDump sessions.

     Auto-Refresh Interval    Enter the Auto-Refresh Interval
                              in milliseconds. This is the
                              time interval between window
                              updates when the Auto-Refresh
                              option is active. It must be in
                              the range 50 to 65535
                              milliseconds - the recommended
                              value is 5000 (5 seconds).

     Differences Capture      Enter the Differences Capture
                              Range in bytes. Range This is
                              the size, in bytes, of the
                              largest difference that you want
                              the Differences command to be
                              able to find. It controls how
                              far ahead WinDump looks when a
                              difference is found, and
                              therefore has an effect on
                              performance. The recommended
                              setting is 250; values larger
                              than 500 or so may slow the
                              program down appreciably.

     Save                     Saves your preference settings.

     Cancel                   Quits the dialog. No changes are
                              saved.


WINDOW COMMANDS


_Cascade_

Use this command to arrange all the non-iconised WinDump
windows in overlapped layers so that the caption bars are
visible.

The keyboard shortcut for Cascade is <Shift+F5>. See also
Tile.


                              25



_Tile_

Use this command to arrange all the non-iconised WinDump
windows in the available space such that they do not overlap.

The keyboard shortcut for Tile is <Shift+F4>. See also
Cascade.


_Stay Tiled_

Use this command to turn on the Stay Tiled option. Use it a
second time to turn the option off. When active, Stay Tiled
causes all the non-iconised WinDump windows to remain tiled at
all times, even when new windows are opened and old ones
closed.

Use the Preferences command to change the default setting of
Stay Tiled.

NOTE Selecting the Stay Tiled option causes the Tile command
     to be disabled.


_Arrange Icons_

Use this command to arrange iconised WinDump windows.

_Close All_

Use this command to close all the open WinDump windows.























                              26


                          CHAPTER 6
                       TROUBLESHOOTING


Common Problems

_This copy of WinDump has expired_

Unregistered copies of WinDump will display this message about
18 months after release. This alerts you to the possibility
that you are not using the latest version containing the most
recent improvements and new features. The program will
continue to function normally, but you are advised to get a
more up-to-date copy.

Registered copies of WinDump do not display this message. When
you register your copy of WinDump you will automatically
receive the next major update when it becomes available, and
you will also be kept informed of subsequent major releases.


_This copy of WinDump has become corrupted_

This message usually means that the WINDUMP.EXE file has been
changed in some way, and cannot be relied upon to function
properly. For this reason, the program will exit immediately.
You must re-install WinDump from your original distribution
diskette. If you still get this problem, contact your support
provider (see Getting Support later in this chapter).


_Cannot find help file_

The Windows help system cannot find the help file,
WINDUMP.HLP. This must be in the same directory as
WINDUMP.EXE, and must not be renamed. If the file has
vanished, re-install it from your original distribution
diskette.


_Cannot open file_

This occurs when you try to open a file that does not exist,
or when you type an incorrect name into the Open dialog box.
It can also arise if you click on a filename in File History
that has been deleted since it was last used.


_Cannot access file_

This occurs when WinDump is unable to access an open file, for
example to perform a search, or to refresh the window. The
probable cause is that some other program, such as File


                              27

Manager, has deleted the file after you opened it in WinDump.


_Scrolling is very slow_

The speed at which WinDump scrolls through a file is limited
by the speed of the disk drive holding the file. If this is a
local hard disk, scrolling will be fast. If you are using a
diskette or a network drive, scrolling will be considerably
slower. If you need faster scrolling, you should consider
copying the file to your local hard disk before using WinDump.

When you drag the scroll bar thumb, files on local hard disks
are displayed continuously as you drag; other files are
displayed only when you release the mouse button. You may also
find that your choice of font affects scrolling speed.


_Analysing differences is very slow_

When you perform a file comparison using the Differences
command, WinDump first searches for the next difference
between the two files. Having found a difference, WinDump
analyses it to determine how to represent it visually. This
involves looking ahead in both files by the amount specified
in the Differences Capture Range (set in the Preferences
command), and making a large number of comparisons. This can
be time-consuming if a capture range of more than about 500
characters has been set. The effect depends upon the
processing power of your computer.


_Cannot print OEM character set_

If you have selected the OEM Terminal Font, and have asked to
print the file, you may be told that no OEM font is available
for the default printer and driver. The provision of OEM
character set capability is dependent upon each individual
printer manufacturer, and is unfortunately beyond the control
of WinDump. You are advised to experiment with alternative
drivers and/or printers to find a combination that can print
OEM.


_Cannot identify default printer_

WinDump can print only to the default printer, that is, the
printer identified in the Control Panel Printers dialog as the
default. This is also the printer described in the
'device=...' parameter in the [windows] section of WIN.INI. If
you do not already have a default printer, you must establish
one using Control Panel before you can print from WinDump.




                              28

_Insufficient free disk space for temporary print files_

Windows needs a certain amount of free disk space (in the
directory to which the 'TEMP' environment variable points)
when printing. If the free space is insufficient, printing may
slow down to the rate at which space is released by the
current print job, or may be abandoned altogether. The
solution is to make more space available by deleting or
archiving files.


_Auto-Refresh: no system timers are free_

Windows has a fixed number of system timers. These are used by
programs that need to perform time-related operations, such as
CLOCK. WinDump requests a system timer when you select the
Auto-Refresh option, so that it can update the windows at the
desired rate. If there are no timers free, WinDump is unable
to turn Auto-Refresh on. The solution is to identify the other
programs that are using timers, and close one of them down.


_Runtime error NNN at XXXX:YYYY_

This indicates an internal error in WinDump. Please make a
note of the values that appear in place of NNN, XXXX and YYYY,
and contact your support provider.


_Application error. Error code = XX_

This indicates a resource problem, possibly due to a shortage
of free memory. If the problem is repeatable, please make a
note of the value that appears in place of XX, and contact
your support provider.


_Unrecoverable Application Error_
_General Protection Fault_

These can be indicative of many different types of problem,
including free memory shortage, and program errors (not
necessarily in the program that was active at the time). If
the problem is repeatable, please make a note of the exact
circumstances, and contact your support provider (see Getting
Support later in this chapter).


Getting Support

If you have read the previous section on common problems, and
still have not found the answer, you may need to request
support. Support is offered to registered users for a period
of 90 days following registration. (Support beyond this
period can be arranged at cost.) The following methods of

                              29

getting support may be used:

* telephone, by calling 0491 681478 within the UK, or +44 491
  681478 from overseas. You are entitled to a cumulative
  maximum of one hour 'connect time' for telephone support.

* electronic mail, to Compuserve Information Service user ID
  100023,201 or via Internet address 100023.201@compuserve.com

* post, by writing to:
     John Napier,
     1 Wayside Green,
     Woodcote,
     Reading, RG8 0PR
     United Kingdom

When requesting support, please supply the following
information:

* the product name, version number and release number. You can
  obtain these from the Registration Details command in the
  WinDump Help menu.

* the serial number of your copy of WinDump. This is an 8-
  character string appearing in the Registration Details box.

* a precise description of the problem, and the circumstances
  that cause it occur.

You may also request support if you are an unregistered user,
and you cannot get WinDump to work at all.

























                              30


                          CHAPTER 7
                     MORE ABOUT SHAREWARE


The following information is made available by ASP, the
Association of Shareware Professionals.

"Shareware distribution gives users a chance to try software
before buying it. If you try a Shareware program and continue
using it, you are expected to register. Individual programs
differ on details -- some request registration while others
require it, some specify a maximum trial period. With
registration, you get anything from the simple right to
continue using the software to an updated program with printed
manual. Copyright laws apply to both Shareware and commercial
software, and the copyright holder retains all rights, with a
few specific exceptions as stated below.

Shareware authors are accomplished programmers, just like
commercial authors, and the programs are of comparable
quality. (In both cases, there are good programs and bad
ones!) The main difference is in the method of distribution.
The author specifically grants the right to copy and
distribute the software, either to all and sundry or to a
specific group. For example, some authors require written
permission before a commercial disk vendor may copy their
Shareware.

Shareware is a distribution method, not a type of software.
You should find software that suits your needs and pocketbook,
whether it's commercial or Shareware. The Shareware system
makes fitting your needs easier, because you can try before
you buy. And because the overhead is low, prices are low also.
Shareware has the ultimate money-back guarantee -if you don't
use the product, you don't pay for it."




















                              31
