OS/2 Shareware BBS: 6 File/06-File.zip/pmdmatch.zip/PMDMatch.HLP

OS/2 Help File | 1995-05-20 | 50KB | 1,270 lines

ΓòÉΓòÉΓòÉ 1. About PMDMatch ΓòÉΓòÉΓòÉ

PMDMatch is an OS/2 utility inspired by the DirMatch utility originally
published years ago in PC Magazine.  I use it to maintain floppy backups of the
projects I'm working on by matching the project directory with the same
directory on the floppy and only having to copy files that are newer.  It can
also be used when 'merging' a software update (by taking a 'snapshot' before
the installation and then comparing that to the resulting directories
afterward), as a file viewer, and for limited directory management (it is a
specific purpose utility, so don't expect a full-fledged directory management
package).  Support is provided in the 'shareware' section of OS2BVEN on
CompuServe.


ΓòÉΓòÉΓòÉ 2. Command line parameters ΓòÉΓòÉΓòÉ

There are several command line switches and parameters which can control the
way PMDMatch starts up.

Any parameters on the command line which are not immediately preceeded by a
dash (-) or forward slash (/) are assumed to be a directory name.  The first
such parameter encountered is used as the Left directory name and the second
one is used as the Right directory.  Unless the /B option (see below) is
specified, these names are saved after the previous execution and used for the
next time if no directories are supplied on the command line.

The following parameters can be supplied on the command line.  These will
override any settings which had been saved by changing them interactively
during a previous execution, but will not be saved.  Several of these can also
be controlled by settings in the 'Filters' dialog box:

      /1 - This will cause PMDMatch to just show a single directory's contents.

      /A - This will only show files which are 'a'like in that they have the
      same name as in the other directory, regardless of their relative
      dates/sizes.

      /B - This will 'b'ypass the usage of the previously specified directory
      locations and will bypass saving them when the current execution session
      is terminated.

      /C filename - This instructs PMDMatch to 'c'apture a snapshot for the
      first directory name and save it in the path/name specified, without
      bringing up the normal PMDMatch screen.  If the 'filename' is not
      specified, a dialog box will allow you to specify the location.  In this
      case, place the /C parameter at the end of the parameter; otherwise, a
      parameter which follows it will be mis-interpreted as a 'filename'
      specification.

      /D - This will only show files which either don't exist in the other
      directory or have a 'd'ifferent date/size.

      /F filename - This specifies the path/name of a file containing a list of
      'f'ile names which are the only ones to include

      /G - This instructs PMDMatch to generate a command file whenever an
      action, such as copying, is chosen to be performed for the selected
      items.

      /L - This will show al'l' files in both directories, regardless of
      comparison to/existence of files in the other directory.

      /M - This will only show 'm'odified files which have the same name as in
      the other directory and have a different date/size.

      /O - This will show files which have the 'o'perating system/hidden
      attributes set.

      /R - This will cause the the program to 'r'ecurse through the directories
      below the current ones and include the files in them as well.

      Note:  Use this with care as it can result in walking the entire disk if
      you start at the root, which can be very disk, memory, and CPU intensive!

      /S - This will cause the directory 's'election dialog to open when
      PMDMatch is first started up so the directory choices can be made at that
      time.

      /U - This will only show files which are 'u'nique in that they exist in
      one directory but not in the other directory.

 If no filter option is supplied and there has not been a previous execution
 which changed the setting, it will default to show al'l'.


ΓòÉΓòÉΓòÉ 3. PMDMatch.ini file ΓòÉΓòÉΓòÉ

Almost all configurable information is saved in the PMDMatch.ini file.  When
the program starts, it checks the current directory first. If a PMDMatch.ini
file is found, it is used.  If it is not found, the PMDMatch.ini in the
directory where the PMDMatch.exe file is located is used.  If it does not
exist, it will be created.  This allows the program to save colors, position
information, directory choices, fonts, etc. so you can configure it to look the
way you want and those settings will be used at the next execution.  You can
use the Save Options menu to immediately save all the settings to a
PMDMatch.ini file in the current directory.


ΓòÉΓòÉΓòÉ 4. Color/Font customization ΓòÉΓòÉΓòÉ

In addition to checking/unchecking the items on the Options menu, you can also
customize the appearance of PMDMatch.  The directory containers and all of the
buttons can be individually set by drag/drop operations from the Color and Font
palettes.  In order to change the color of the text, be sure to hold down the
Ctrl key while drag/dropping the color from the Color palette.


ΓòÉΓòÉΓòÉ 5. Left/Right containers ΓòÉΓòÉΓòÉ

The main section of the program window is divided into equal sized left and
right 'containers'.  A container is an OS/2 object designed for containing
various types of information (in this case, information about the files in each
of two directories).  These containers are displayed in 'detail' mode which
displays the information in columns.  The first column contains the filenames
in each of the selected directories whose files which meet the filter views
criteria.  At the end of each filename, there may be some combination of
'{ahrs}' displayed.  This indicates that the file has 'a'rchived, 'h'idden,
'r'ead-only, and/or 's'ystem attributes.  The rest of the columns show the file
size, date and time, and the size of any extended attributes attached.  The way
these are displayed and the separators used can be controlled by using the
'Country' object (normally) in the System Setup folder.

OS/2 provides many standard ways of working with information in containers.
The PMDMatch containers support 'multiple selection' which means you can click
Mouse Button 1, (MB1, normally the left mouse button), on one or several of the
lines of information.  The ones that are selected will then be the ones used
for the next action to be taken, such as copying or deleting.  If you click
again, the selection will be turned off so you can change your mind when you
need to, as long as you do it before starting the action.  Another thing you
can do with the containers is to click Mouse Button 2, (MB2, normally the right
mouse button), over one of them.  This will bring up a context sensitive popup
menu from which you can select many of the operations contained in the main
menus.  One major advantage to this is that if you click on Mouse Button 2
(MB2, normally the right mouse button) over a single file, you can choose to
perform an action on it, such as copying it, without having to first select it.

The PMDMatch containers also support drag/drop operations to move the file(s)
from either container to a WorkPlace Shell folder.


ΓòÉΓòÉΓòÉ 6. Keyboard/Mouse ΓòÉΓòÉΓòÉ

FUNCTION KEYS

 F2-Mark         Selects all of the directory items.

 F3-Clear        Clears all of the directory items.

 F4-Copy         Copies the selected files.

 F5-Move         Moves the selected files.

 F6-Delete       Deletes the selected files.

 F7-Filter       Cycles through the filter views.

 F8-Swap         Swaps the contents of the directory container windows.

 F10-Stats       Displays the Statistics dialog box.

 F11-Indexed Help Displays the Help index.

 F12-Refresh     Refreshes the contents of the directories.

 Alt+F4          Exits the application.

 UTILITY KEYS

 The keyboard can also be used for some of the utility activities.  In general,
 you can use the underlined letter when the menus are pulled down to select
 that menu item.  The 'Alt' key in conjunction with the underlined letter will
 select them when the menus are not pulled down.  In addition, some
 accellerator keys have been defined to perform some of the utility functions
 directly.  These are listed below:

 Ctrl+B        Bring up the Both directory selection dialog box.

 Ctrl+S        Bring up the Same directory selection dialog box.

 Ctrl+I        Toggle the Include Subdirectories state.

 Ctrl+F        Bring up the Filters setting dialog box.

 Ctrl+Alt+F    Cycles through the filter views.

 Ctrl+Alt+A    Sets the filter view to Alike.

 Ctrl+Alt+D    Sets the filter view to Different.

 Ctrl+Alt+L    Sets the filter view to All.

 Ctrl+Alt+M    Sets the filter view to Modified.

 Ctrl+Alt+U    Sets the filter view to Unique.

 Tab           This can be used to move the focus in circular sequence from the
               button row (if showing) to the left container to the right
               container and back again.

 Esc           This can be used to cancel and dismiss any dialog box.

 SYSTEM KEYS

 These keys can be used to leave the utility (intact) and make use of some
 other OS/2 program/feature:

 Alt+Esc     Switch to the next program, including full-screen programs.

 Ctrl+Esc    Switch to the Task List.

 MOUSE

 The mouse can be used for most actions just as it is used in other places in
 OS/2, such as for selecting menu items and options and making choices by
 clicking on buttons.  Some additional uses specific to PMDMatch are:

     Double-clicking Mouse Button 1 (MB1, normally the left mouse button) on a
      file entry in either of the containers will start the 'editor' program
      and pass that file name to it.

     Double-clicking Mouse Button 1 in the title area of the container (just
      below the menu bar) will bring up the directory selection dialog box.

     Clicking Mouse Button 1 while depressing the Alt key over either of the
      directory names will bring up an entry field box in which the name of the
      directory can be edited to change it to another one.

     Clicking Mouse Button 1 while depressing the Alt key over a file name
      will bring up an entry field box in which the name of the file can be
      edited to change it to another name.

     Clicking Mouse Button 2 (MB2, normally the right mouse button) over
      either of the containers will bring up a context sensitive popup menu.

     Clicking Mouse Button 2 over entries in either container and moving the
      mouse while the button is still depressed will begin a drag/drop
      operation to move the file(s) to a WorkPlace Shell folder.


ΓòÉΓòÉΓòÉ 7. Drag/Drop ΓòÉΓòÉΓòÉ

You can use the 'drag/drop' operation in order to copy/move the file(s) from
either of the containers to any WorkPlace Shell folder (including one which is
opened using the 'Open Dir as Folder' menu item).  If the <Ctrl> key is
depressed when the drop happens (by releasing the mouse button when positioned
over the folder into which you want the file(s) to be placed), the file(s) will
be copied.  If both the <Shift> and <Ctrl> keys are depressed, a 'shadow' will
be created.  If neither of these key combinations are depressed when a drop
occurs, the file(s) will be moved.

Whether a single or multiple files is/are dragged depends upon which file the
pointer is over when the drag is begun.  If it is over a selected file, the
drag/drop will apply to all of the selected files in that container.  If it is
clicked over a file that is NOT selected, the drag/drop will be with that
individual file.


ΓòÉΓòÉΓòÉ 8. Progress dialog ΓòÉΓòÉΓòÉ

This dialog box comes up whenever PMDMatch is busy performing some extended
action such as copying files, etc.  Even though it is busy doing something,
some of the other controls can still be used, such as showing the Statistics
dialog.  Any operations which cannot be performed while it is busy will be
'greyed' out and therefore not selectable.  If you use the Cancel button while
the dialog is showing, the action being performed will be cancelled at the next
safe opportunity.  In other words, a file whose copy is in progress at that
time will continue until completed but no new copying will be started.


ΓòÉΓòÉΓòÉ 9. Access denied dialog ΓòÉΓòÉΓòÉ

This dialog box will appear when you are trying to copy onto or delete a file
which has 'protection' attributes (hidden, read-only, and/or system) set AND
the 'Ignore target File Attributes' option is NOT checked/enabled.  It will
indicate the file path/name that is involved and present button choices which
allow you to cancel the rest of the entire action, skip, or overwrite as
follows:

     Cancel this action

     Skip this file

     Skip this and any others

     Overwrite/delete this file

     Overwrite/delete this and any others


ΓòÉΓòÉΓòÉ 9.1. Cancel this action ΓòÉΓòÉΓòÉ

This button will cause PMDMatch to cancel this action at an appropriate and
'safe' moment; in other words, files which are currently being processed
(copied, etc.) will continue until completion but no others will be started.


ΓòÉΓòÉΓòÉ 9.2. Skip this file ΓòÉΓòÉΓòÉ

This button will cause PMDMatch to skip this 'access-denied' file; if there is
another one encounted during this action, the dialog box will be presented
again.


ΓòÉΓòÉΓòÉ 9.3. Skip this and any others ΓòÉΓòÉΓòÉ

This button will cause PMDMatch to skip this and any other 'access-denied'
files encounted during this action, without presenting the dialog box again.


ΓòÉΓòÉΓòÉ 9.4. Overwrite this file ΓòÉΓòÉΓòÉ

If doing a 'copy' action, this button will cause PMDMatch to reset the
attributes on this 'access-denied' file, delete it, and then copy onto it.  If
this is a 'delete' action, the attributes will be reset and then the file
deleted.


ΓòÉΓòÉΓòÉ 9.5. Overwrite this and any others ΓòÉΓòÉΓòÉ

If doing a 'copy' action, this button will cause PMDMatch to reset the
attributes, delete, and then copy onto this and any other 'access-denied' files
it encounters during this action, without presenting the dialog box again.  If
this is a 'delete' action, the attributes will be reset and then the file
deleted for this and any other 'access-denied' files it encounters.


ΓòÉΓòÉΓòÉ 10. File menu ΓòÉΓòÉΓòÉ

The functions on this menu are related to loading/saving snapshots, printing
comparisons, and exiting the program.


ΓòÉΓòÉΓòÉ 11. File-Open Dir as Folder ΓòÉΓòÉΓòÉ

Choosing this item from the File menu will cascade a menu which allows you to
open either the left or right directory as a folder on the desktop in an icon
view.  Choosing it from the popup menu will open whichever directory the
pointer was over when the menu was popped up.  You can then use that folder for
typical WorkPlace Shell drag/drop operations.


ΓòÉΓòÉΓòÉ 12. File-Load a Snapshot ΓòÉΓòÉΓòÉ

Choosing this item will present a dialog box which allows you to select a
snapshot file to display in a directory container.  This previously saved
snapshot of a list of files in a directory can be used to compare the new state
of a directory (such as after a software update is applied) to its previous
state.  If you wish, you can manually add comments or blank lines to these
files; each comment line must start with an asterisk in column 1.


ΓòÉΓòÉΓòÉ 13. File-Save a Snapshot ΓòÉΓòÉΓòÉ

Choosing this item will present a dialog box which allows you to select a
snapshot file to which to write the list of files displayed in the directory
container.  You may also enter a comment which will be placed at the top of the
snapshot file.  This snapshot can be used to compare the new state of a
directory (such as after a software update is applied) to its previous state.
If you wish, you can manually add comments or blank lines to these files; each
comment line must start with an asterisk in column 1.


ΓòÉΓòÉΓòÉ 13.1. File selection ΓòÉΓòÉΓòÉ

This dialog box allows you to choose the filename to be used in the operation
for which it was invoked (e.g. loading or saving a snapshot of the directory
contents).  When initially displayed, the dialog shows files in the current
directory, on the current drive.  It uses the following controls:

     Select file name

     Snapshot comment

     Select Load to/Save from

     Select drive

     Select files list

     Select directories list


ΓòÉΓòÉΓòÉ 13.2. Select file name ΓòÉΓòÉΓòÉ

This entry field contains the name of the file.  It can either be typed in
directly or chosen from the files list box.


ΓòÉΓòÉΓòÉ 13.3. Snapshot comment ΓòÉΓòÉΓòÉ

This entry field allows you to enter a comment which will be written to the top
of the snapshot file when it is saved.


ΓòÉΓòÉΓòÉ 13.4. Select Load to/Save from ΓòÉΓòÉΓòÉ

This pair of radio-buttons allow you to select which of the containers (Left or
Right) will be involved in the operation.


ΓòÉΓòÉΓòÉ 13.5. Select drive ΓòÉΓòÉΓòÉ

This drops down a list of drive letters for which directories and files can be
selected.


ΓòÉΓòÉΓòÉ 13.6. Select files list ΓòÉΓòÉΓòÉ

This displays the list of files in the currently selected directory for the
currently selected drive.  Double-clicking on one of these names puts it in the
file name entry field and tells the program to use it.


ΓòÉΓòÉΓòÉ 13.7. Select directories list ΓòÉΓòÉΓòÉ

This displays the list of directories for the currently selected drive.
Double-clicking on one of these names loads the list of files in that directory
into the files list box.


ΓòÉΓòÉΓòÉ 14. File-Exit ΓòÉΓòÉΓòÉ

Choosing this item will exit the program.


ΓòÉΓòÉΓòÉ 15. Directories menu ΓòÉΓòÉΓòÉ

The functions on this menu are related to choosing the directories to view and
how they are viewed.


ΓòÉΓòÉΓòÉ 16. Directories-Both Directories ΓòÉΓòÉΓòÉ

Choosing this item will present a dialog box which allows you to select the
directories to display in each of the directory containers.  (You can also
invoke this dialog box at start-up with the /S command line switch.)


ΓòÉΓòÉΓòÉ 17. Directories-Same Directory ΓòÉΓòÉΓòÉ

Choosing this item will present a dialog box which allows you to select a
directory that is common to two different drives.  It is handy when you want to
refresh a directory on a diskette with files from an identical directory on a
hard drive (where the latest versions of some files reside).

Select the two drives using the Left Drive and Right Drive drop-down list
boxes.  The last one that you select will be the "master" and determine the
directory which is displayed in the left container.  (The right container isn't
used in this dialog.)  The "master" drive that you use for the selection is
designated with an "<" pointed toward the Left Drive or an ">" pointing toward
the Right Drive.


ΓòÉΓòÉΓòÉ 17.1. Drive/Directory selection ΓòÉΓòÉΓòÉ

This dialog box allows you to choose the directory to display in the container
window.  It uses the following controls:

     Select drive

     Show subdirectories

     Select directory


ΓòÉΓòÉΓòÉ 17.2. Select drive ΓòÉΓòÉΓòÉ

This drops down a list of drive letters which can be selected to go with the
directory selected.


ΓòÉΓòÉΓòÉ 17.3. Select show subdirectories ΓòÉΓòÉΓòÉ

This check box controls whether the directory list box shows all of the
directories below the current level (checked) or just those at the next level
(unchecked).  Don't confuse this check box's function with the "Include
subdirectories" option (on the Options menu), which controls whether or not
files in all subdirectories are displayed in the main PMDMatch left and right
containers.


ΓòÉΓòÉΓòÉ 17.4. Select directory ΓòÉΓòÉΓòÉ

This shows a list of directories for the drive letter which is shown.  In the
case of selecting the same directory, where both drive letters are associated
with the same combination box, this shows the directories on the last drive
that was selected (an arrow symbol next to the drive select box shows which
drive was last selected).


ΓòÉΓòÉΓòÉ 18. Directories-Single directory mode ΓòÉΓòÉΓòÉ

This menu check item option controls whether the program shows just a single
directory (checked) or not (unchecked).  This can be useful when you just want
to browse a directory and look inside some of the files using the editor.  This
option is NOT saved for the next time.  (The /1 command-line switch can also be
used to invoke this option.)


ΓòÉΓòÉΓòÉ 19. Directories-Swap ΓòÉΓòÉΓòÉ

Choosing this (either by using the button or from a menu) swaps the contents of
the two directory container windows.


ΓòÉΓòÉΓòÉ 20. Directories-Refresh ΓòÉΓòÉΓòÉ

Choosing this (either by using the button or from a menu) refreshes the
contents of the directories.  It will read the contents of both the directories
and update the directory windows accordingly.  This means you can leave the
program open, do file operations using other means (such as the command line),
and still be able to perform directory matching.


ΓòÉΓòÉΓòÉ 21. Directories-Stats ΓòÉΓòÉΓòÉ

Choosing this (either by using the button or from a menu) brings up the
Statistics dialog box.  It displays statistics about both of the directories.
The 'sizes' are the sum of the bytes used by the files, not the file system
allocation units which those files consume.  For instance, a 1 byte long file
will count as 1 rather than the 2048 or 4096 byte cluster it could consume on a
FAT type of disk.


ΓòÉΓòÉΓòÉ 21.1. Stats dialog ΓòÉΓòÉΓòÉ

The Statistics dialog is a non-modal, display-only dialog box. What this means
is that is can remain visible and continue being updated while other operations
are performed and no input is accepted from the user.


ΓòÉΓòÉΓòÉ 22. Options menu ΓòÉΓòÉΓòÉ

The functions on this menu are related to the setup options for the utility.
These options (and many other settings) are kept in the PMDMatch.ini file.


ΓòÉΓòÉΓòÉ 23. Options-Settings notebook ΓòÉΓòÉΓòÉ

The settings controlled by this notebook are for those options that are not
frequently changed.


ΓòÉΓòÉΓòÉ 24. Settings-Comparitor ΓòÉΓòÉΓòÉ

This page allows you to select the program you want to use for comparing files
and any options you want passed to it.  Files can be compared by clicking Mouse
Button 2 (normally the right mouse button) over a file entry which has a
corresponding entry in the other container and then choosing Compare from the
menu.

The program I like to use for this is an IBM 'employee written software'
program called Graphical File Compare.  It is available in CompuServe's OS2USER
Lib 23 IBM Files library as 'OS2GFC.ZIP'.


ΓòÉΓòÉΓòÉ 24.1. Comparitor path/file ΓòÉΓòÉΓòÉ

This is the path/file of the compare program that will be started and passed
the name of the chosen files.


ΓòÉΓòÉΓòÉ 24.2. Comparitor options ΓòÉΓòÉΓòÉ

This entry field is for options (parameters) that will be passed to the compare
program when it is started.


ΓòÉΓòÉΓòÉ 25. Settings-Confirm ΓòÉΓòÉΓòÉ

This page allows you control the following confirmation messages:

     Confirm on Copy

     Confirm on Move

     Confirm on Delete

     Confirm on Esc cancel/Abort

     Confirm on Exit


ΓòÉΓòÉΓòÉ 25.1. Confirm on Copy ΓòÉΓòÉΓòÉ

This checkbox item controls whether a confirmation dialog is displayed
(checked) or not (unchecked) before doing a copy.


ΓòÉΓòÉΓòÉ 25.2. Confirm on Move ΓòÉΓòÉΓòÉ

This checkbox item controls whether a confirmation dialog is displayed
(checked) or not (unchecked) before doing a move.


ΓòÉΓòÉΓòÉ 25.3. Confirm on Delete ΓòÉΓòÉΓòÉ

This checkbox item controls whether a confirmation dialog is displayed
(checked) or not (unchecked) before doing a delete.


ΓòÉΓòÉΓòÉ 25.4. Confirm on Esc cancel/Abort ΓòÉΓòÉΓòÉ

This checkbox item controls whether a confirmation dialog is displayed
(checked) or not (unchecked) before doing a cancel (initiated by using the
<Esc> key during an operation) or Abort (in response to an error message dialog
box).


ΓòÉΓòÉΓòÉ 25.5. Confirm on Exit ΓòÉΓòÉΓòÉ

This checkbox item controls whether a confirmation dialog is displayed
(checked) or not (unchecked) before exiting the program.


ΓòÉΓòÉΓòÉ 26. Settings-Editor ΓòÉΓòÉΓòÉ

This page allows you to select the program you want to use for viewing files
and any options you want passed to it.  A file can be viewed by either
double-clicking on its entry in the directory window or using the cursor to
position to the file entry you want to view and hitting <Enter>.


ΓòÉΓòÉΓòÉ 26.1. Editor path/file ΓòÉΓòÉΓòÉ

This is the path/file of the editor program that will be started and passed the
name of the chosen file.


ΓòÉΓòÉΓòÉ 26.2. Editor options ΓòÉΓòÉΓòÉ

This entry field is for options (parameters) that will be passed to the editor
when it is started.


ΓòÉΓòÉΓòÉ 27. Settings-Miscellaneous ΓòÉΓòÉΓòÉ

This page allows you control the following miscellaneous settings:

     Ignore target File Attributes

     Move does Copy/Delete

     Disable automatic Refresh


ΓòÉΓòÉΓòÉ 27.1. Ignore target File Attributes ΓòÉΓòÉΓòÉ

This checkbox item controls whether any target files for copy and delete
operations have their attribute(s) reset (checked) or not (unchecked) before
the operation.  This allows you to overwrite or delete files that you may not
want to, so be very careful with this setting!


ΓòÉΓòÉΓòÉ 27.2. Move does Copy/Delete ΓòÉΓòÉΓòÉ

This checkbox item controls whether a 'move' is done by first doing a copy and
then deleting the source file (checked) or using OS/2's move command
(unchecked).  Since the OS/2 move command will fail if the target file exists,
the copy/delete option works best in most cases.


ΓòÉΓòÉΓòÉ 27.3. Disable automatic Refresh ΓòÉΓòÉΓòÉ

This checkbox item controls whether an automatic refresh of the containers'
contents occurs after the requested action is performed (unchecked) or not
(checked).  This can save the time required to reload the containers if you
already know you are going to be changing directories next or if you want the
container to stay positioned where it was when you do, for instance, a file
rename and want to move to the next one and rename it.

Note:  Use this option with care as it can be very confusing about what has
changed and what has not since the container is not updated.  For instance, if
you move a file, it will still appear to be in the original location.


ΓòÉΓòÉΓòÉ 28. Settings-Show ΓòÉΓòÉΓòÉ

This page allows you control the showing of the following:

     Show buttons

     Show progress dialog

     Show container activity

     Highlight identical files

     Indicate {a}rchived Files


ΓòÉΓòÉΓòÉ 28.1. Show buttons ΓòÉΓòÉΓòÉ

This checkbox item controls whether the push-buttons at the bottom are
displayed (checked) or not (unchecked).  If you prefer using the popup menu,
you can get extra room in the directory containers by turning off the buttons.
And even with the buttons not showing, you can still use the 'F'unction keys.


ΓòÉΓòÉΓòÉ 28.2. Show progress dialog ΓòÉΓòÉΓòÉ

This checkbox item controls whether the progress dialog is displayed (checked)
or not (unchecked) when PMDMatch is busy.  Regardless of the setting of this
option, those controls which cannot be used while PMDMatch is busy will still
be disabled.


ΓòÉΓòÉΓòÉ 28.3. Show container activity ΓòÉΓòÉΓòÉ

This checkbox item controls whether the actions in the containers are animated
(checked) or not (unchecked).  If this is checked, the container view is
scrolled to the next item to be acted on and items in the container being acted
on (copied, moved, etc.) are shown with 'in use' emphasis while being copied
and then with 'disabled' emphasis once the action on it is complete.  When this
is unchecked, no indications are displayed; however, the progress dialog (or
alarm-clock if the progress dialog is turned off) will still indicate when
PMDMatch is busy performing the requested action.


ΓòÉΓòÉΓòÉ 28.4. Highlight identical files ΓòÉΓòÉΓòÉ

Sometimes you may be looking for disk space that is wasted by having identical
files in different locations.  Since the 'All' filter shows every file and the
'Alike' filter shows files with the same file name that may actually be
different in size or date, some method is needed to be able to quickly identify
those files that are really identical.  This checkbox item controls whether
identical files are highlighted (checked) or not (unchecked) when they are
displayed with the Show filter set to either the 'All' or 'Alike' modes.


ΓòÉΓòÉΓòÉ 28.5. Indicate {a}rchived Files ΓòÉΓòÉΓòÉ

This checkbox item controls whether any files with the 'a'rchived bit set are
indicated by the {a} (checked) or not (unchecked).  If the setting of this
attribute is the ONLY difference between a pair of files in the left/right
containers, and this option is NOT checked, the files are considered to be
identical.


ΓòÉΓòÉΓòÉ 29. Settings-Startup ΓòÉΓòÉΓòÉ

This page allows you control the following conditions at startup:

     Display Logo at start

     Select Directories at start


ΓòÉΓòÉΓòÉ 29.1. Display Logo at start ΓòÉΓòÉΓòÉ

This checkbox item controls whether the program logo is displayed (checked) or
not (unchecked) when the program starts up.  However, it adheres to the system
settings for the Logo so if you set the system to not display Logos, it won't
display even if this is checked.


ΓòÉΓòÉΓòÉ 29.2. Select Directories at start ΓòÉΓòÉΓòÉ

This checkbox item controls whether the program presents the directory
selection dialog box (checked) or not (unchecked) when the program starts up.
(The /S command-line switch can also be used to invoke this option.)


ΓòÉΓòÉΓòÉ 29.3. Include Subdirectories at start ΓòÉΓòÉΓòÉ

This checkbox item controls whether the program includes subdirectories
(checked) or not (unchecked) when the program starts up.  (The /R command-line
switch can also be used to cause subdirectories to be included at startup.)

Note:  Use this option with care as it can result in walking the entire disk if
you start at the root!  It affects the contents of both the left and the right
containers.  When it is checked, files and subdirectories -- in all levels of
the directory hierarchy below the current directory -- will appear.  This
option can be disk, memory, and CPU intensive; there might be periods of
seeming inactivity and it may take a bit for the program to do its cleanup when
exiting, so please be patient.


ΓòÉΓòÉΓòÉ 30. Options-Filters ΓòÉΓòÉΓòÉ

This dialog box allows you to select how the data in the two directories is
filtered before being displayed.  It can first be filtered by whether or not to
include hidden/system files, then by masks for which files to include, then by
masks for which of those files to exclude, then by a list of which file names
to include, and finally by one of five comparison views categories; All, Alike,
Different, Modified, and Unique.

In addition, you can choose whether or not the file attributes, file sizes,
file date/times, and/or EA sizes are used when comparing for differences.


ΓòÉΓòÉΓòÉ 30.1. Filter include hidden/system files ΓòÉΓòÉΓòÉ

This check box controls whether hidden/system files are displayed (checked) or
not (unchecked).


ΓòÉΓòÉΓòÉ 30.2. Filter include masks ΓòÉΓòÉΓòÉ

This entry field allows you to enter a list of 'wild-card mask' specifications,
separated by commas, of the files you want to process.  For instance, '*.*'
will get all of the files in the directory and '*.c,*.h*' will get all of the
files ending in .c as well as all of the files containing .h.  Files to be
'excluded' are checked after the files matching the 'include masks' are
identified but before the 'include list' files.


ΓòÉΓòÉΓòÉ 30.3. Filter exclude masks ΓòÉΓòÉΓòÉ

This entry field allows you to enter a list of 'wild-card mask' specifications,
separated by commas, of the files you want excluded from those that qualified
for the include masks.  For instance, '*.obj' will skip all object files in the
directory and '*.obj, *.tmp*' will skip both object and temporary files.  Files
to be 'excluded' are checked before the 'included list' files is checked.


ΓòÉΓòÉΓòÉ 30.4. Filter include find button ΓòÉΓòÉΓòÉ

This button brings up a standard file dialog box which can be used to locate
the file containing the list of files to be 'included'.


ΓòÉΓòÉΓòÉ 30.5. Filter include list ΓòÉΓòÉΓòÉ

This entry field allows you to enter the file path/name containing a list of
file names (these may be fully qualified path/names or just file names) to
which you want to limit the display.  Only files which match one of the names
in the list will be shown.  Some users have asked for this as a way to narrow
the focus to a specific set of files that exist within a large subdirectory.
This can be useful if you have a known set of files related to some project,
but there are other projects/files as well in the directory, and you only want
to be concerned with those specific files for the PMDMatch operations.  The
file can be in the format that is created by a 'snapshot' or can be manually
created with a normal ASCII text editor.  If manually created, each file name
must be on a line by itself.  If HPFS 'long' filenames are used which contain
embedded spaces, the name must be enclosed in double-quotes.  Note that this
list is not checked until after the 'include' and 'exclude' masks.  Also, the
file path/name specified is not saved across executions; it may be given on the
command line using the '/F' option.


ΓòÉΓòÉΓòÉ 30.6. Filter views ΓòÉΓòÉΓòÉ

The views categories are:

     All - This will show all files in both directories, regardless of
      comparison to/existence of files in the other directory.  (The /L
      command-line switch can also be used to establish this view when you
      start PMDMatch.)

     Alike - This will only show files which have the same name as in the
      other directory, regardless of their relative dates/sizes.  (The /A
      command-line switch can also be used to establish this view when you
      start PMDMatch.)

     Different - This will only show files which either don't exist in the
      other directory or have a different date/size.  (The /D command-line
      switch can also be used to establish this view when you start PMDMatch.)

      When two files with the same name are displayed in the Different view,
      the information on the file with the latest date/time is 'highlighted'.
      This allows you to quickly see which one is the newer file.  And, if you
      have a mixture (newer ones on both sides) the highlighting makes it
      easier to select them for copying, etc.

     Modified - This will only show files which have the same name as in the
      other directory and have a different date/size; files which only differ
      in their 'attributes' will not show here.  (The /M command-line switch
      can also be used to establish this view when you start PMDMatch.)

     Unique - This will only show files which exist in one directory but not
      in the other directory.  (The /U command-line switch can also be used to
      establish this view when you start PMDMatch.)


ΓòÉΓòÉΓòÉ 30.7. Filter check attributes ΓòÉΓòÉΓòÉ

This checkbox item controls whether the program uses (checked) the file
attributes in determining whether the files are different or ignores them
(unchecked).  If it is checked and the attributes are different, the file name
will be highlighted on both sides.


ΓòÉΓòÉΓòÉ 30.8. Filter check file sizes ΓòÉΓòÉΓòÉ

This checkbox item controls whether the program uses (checked) the file sizes
in determining whether the files are different or ignores them (unchecked).  If
it is checked and the file sizes are different, the file size fields will both
be highlighted.


ΓòÉΓòÉΓòÉ 30.9. Filter check date/times ΓòÉΓòÉΓòÉ

This checkbox item controls whether the program uses (checked) the date/times
in determining whether the files are different or ignores them (unchecked).  If
it is checked and the date/times are different, all of the fields of the newer
file will both be highlighted.

If this field is not checked, the 'modified' filter will be disabled since the
only purpose of the 'modified' filter mode is to show files whose date/times
are different.


ΓòÉΓòÉΓòÉ 30.10. Filter check EA sizes ΓòÉΓòÉΓòÉ

This checkbox item controls whether the program uses (checked) the Extended
Attribute sizes in determining whether the files are different or ignores them
(unchecked).  If it is checked and the EA sizes are different, the EA size
fields will both be highlighted.


ΓòÉΓòÉΓòÉ 31. Options-Mark/Clear modes ΓòÉΓòÉΓòÉ

This dialog box allows you to specify what happens when the Mark and Clear
buttons are used, and how the 'mark all'  and 'mark newer' items on the popup
menu operates.  The Mark button can be set to mark (select) either all the
items on the left or all the items on the right.  The Clear button can be set
to clear (deselect) either all the items on the left, all the items on the
right, or all items on both sides.  The 'mark all' menu item can be set to
default to just marking all the files or marking and then either copying,
deleting, or moving the files.  The 'mark newer' menu item can be set to
default to just marking the newer files or marking them and then either
copying, deleting or moving them.


ΓòÉΓòÉΓòÉ 31.1. Mark mode ΓòÉΓòÉΓòÉ

This determines whether all the items on the left or right are marked
(selected) when the Mark button is used.


ΓòÉΓòÉΓòÉ 31.2. Clear mode ΓòÉΓòÉΓòÉ

This determines whether all the items on the left, right or both are cleared
(deselected) when the Clear button is used.


ΓòÉΓòÉΓòÉ 31.3. Mark menu default ΓòÉΓòÉΓòÉ

This determines what the default is for the conditional cascade menu item for
marking all files.  When the menu item itself is clicked, it will perform the
default which is chosen here.  If you click on the arrow at the end of the
menu, you can choose an action other than the default.  These radio buttons
allow you to set the default to just mark all the files, or to mark them all
and then also copy, delete, or move them.


ΓòÉΓòÉΓòÉ 31.4. Mark newer menu default ΓòÉΓòÉΓòÉ

This determines what the default is for the conditional cascade menu item for
marking newer files.  When the menu item itself is clicked, it will perform the
default which is chosen here.  If you click on the arrow at the end of the
menu, you can choose an action other than the default.  These radio buttons
allow you to set the default to just mark the newer files, or to mark them and
then also copy, delete, or move them.


ΓòÉΓòÉΓòÉ 32. Options-Include subdirectories ΓòÉΓòÉΓòÉ

This menu check item option controls whether the files in the subdirectories
below the current one are displayed (checked) or not (unchecked).  This setting
is NOT saved in the PMDMatch.ini file so, unless you force it on with the /R
command-line switch or check the Include Subdirectories at startup option in
the Startup tab of the Settings notebook, it will not be on at the next
execution.  This option is completely separate from the settings for the
'directory selection' dialog box.


ΓòÉΓòÉΓòÉ 33. Options-Generate a .CMD file ΓòÉΓòÉΓòÉ

This menu check item option controls whether a .CMD file is generated (checked)
or not (unchecked) whenever an action such as copying is performed, at which
time you will be prompted to the supply the name of the file to generate.  The
.CMD file is a REXX program file that can later be used to perform the same
actions as would have taken place immediately if this option were unchecked.
You can override the 'left' and 'right' drive letters at the time of execution
by supplying them, in that order, on the command line.  This can be used in the
case of keeping remote servers in sync.  You could do the comparison during the
day and generate the .cmd file.  Then send the .cmd file to the remote server
to be performed during the night.  Since the file is a REXX program, you could
modify it to do whatever other operations are required for your particular
situation.


ΓòÉΓòÉΓòÉ 34. Options-Save options ΓòÉΓòÉΓòÉ

This menu item acts like a pushbutton.  When you click on it, all of the
current program settings are saved immediately to a PMDMatch.ini file in the
current directory.  This allows you to easily maintain different PMDMatch
settings for different applications.


ΓòÉΓòÉΓòÉ 35. Popup menu ΓòÉΓòÉΓòÉ

The functions on this menu are available when Mouse Button 2 (MB2, normally the
right mouse button) is clicked over either of the containers, and some of the
menu's options reflect the container over which it was invoked.  If it is
clicked over a container in which there is a selected file, the
copy/move/delete items will apply to all of the selected files in both
containers, just as if the buttons had been used.  If it is clicked over a file
that is NOT selected, and there are no files selected in that container, the
copy/move/delete items will apply to that individual file.


ΓòÉΓòÉΓòÉ 36. Popup-Mark all and... ΓòÉΓòÉΓòÉ

The popup menu contains a cascade menu item which allows you to mark all the
files and then optionally act on them.  If you click on the text part of this
menu item, it will perform the default operation, which can be specified in the
Mark/Clear modes dialog.  If you click on the arrow, another menu will cascade
down which allows you to choose another operation to override the default.


ΓòÉΓòÉΓòÉ 37. Popup-Mark newer and... ΓòÉΓòÉΓòÉ

The popup menu contains a cascade menu item which allows you to mark just the
newer files and then optionally act on them.  If you click on the text part of
this menu item, it will perform the default operation, which can be specified
in the Mark/Clear modes dialog.  If you click on the arrow, another menu will
cascade down which allows you to choose another operation to override the
default.

If the pointer was over either of the containers when the menu was popped up,
the marking will happen only in that container.  If it is over some
'whitespace' in the container (such as in the title area or below the last
container entry), the marking will happen in both containers.


ΓòÉΓòÉΓòÉ 38. Popup-Copy ΓòÉΓòÉΓòÉ

Choosing this item will copy the file(s) to the opposite container.  If Mouse
Button 2 (MB2, normally the right mouse button) was clicked over a file that is
NOT selected, that file will be copied; if not, all selected files in both
containers will be copied.


ΓòÉΓòÉΓòÉ 39. Popup-Move ΓòÉΓòÉΓòÉ

Choosing this item will move the file(s) to the opposite container.  If Mouse
Button 2 (MB2, normally the right mouse button) was clicked over a file that is
NOT selected, that file will be moved; if not, all selected files in both
containers will be moved.


ΓòÉΓòÉΓòÉ 40. Popup-Delete ΓòÉΓòÉΓòÉ

Choosing this item will delete the file(s).  If Mouse Button 2 (MB2, normally
the right mouse button) was clicked over a file that is NOT selected, that file
will be deleted; if not, all selected files in both containers will be deleted.


ΓòÉΓòÉΓòÉ 41. Popup-Rename ΓòÉΓòÉΓòÉ

Choosing this item will put the file name into a text editable box, (as if you
had done an Alt-Mouse Button 2 click over the file entry) in which you can
change the name and cause the file to be renamed.


ΓòÉΓòÉΓòÉ 42. Popup-Compare ΓòÉΓòÉΓòÉ

Choosing this item will start the specified comparitor program and pass it the
names of the files.


ΓòÉΓòÉΓòÉ 43. Mark button ΓòÉΓòÉΓòÉ

Choosing this using the button selects ALL of the entries in accordance with
the Mark/Clear modes settings; choosing Mark from the popup menu selects ALL of
the entries for the container over which the menu pops up.


ΓòÉΓòÉΓòÉ 44. Clear button ΓòÉΓòÉΓòÉ

Choosing this using the button clears ALL of the directory items in accordance
with the settings of the Mark/Clear modes settings; choosing Clear from the
popup menu clears ALL of the entries for the container over which the menu pops
up.


ΓòÉΓòÉΓòÉ 45. Copy button ΓòÉΓòÉΓòÉ

Choosing this (either by using the button or from the popup menu) starts
copying the selected files from either (or both) of the directories to the
directory which is displayed on the opposing side of the PMDMatch container.


ΓòÉΓòÉΓòÉ 46. Move button ΓòÉΓòÉΓòÉ

Choosing this (either by using the button or from the popup menu) starts moving
the selected files from either (or both) of the directories to the  directory
which is displayed on the opposing side of the PMDMatch container.


ΓòÉΓòÉΓòÉ 47. Delete button ΓòÉΓòÉΓòÉ

Choosing this (either by using the button or from the popup menu) starts
deleting the selected files from either (or both) of their respective
directories.


ΓòÉΓòÉΓòÉ 48. Help Menu ΓòÉΓòÉΓòÉ

The choices on the Help pull-down provide the following:

 Help index
      Displays the index of the help menu.

 General Help
      Provides detailed information on using the PMDMatch utility.

 Keys Help
      Provides information about keys/mouse usage.

 Using Help
      Displays information about using the PMDMatch utility's help.


ΓòÉΓòÉΓòÉ 49. Help-Using ΓòÉΓòÉΓòÉ

Use this choice to obtain information on how to use the Help facility.


ΓòÉΓòÉΓòÉ 50. Help-General ΓòÉΓòÉΓòÉ

Use this choice to get general help for the program. General help provides
general information about the PMDMatch utility.


ΓòÉΓòÉΓòÉ 51. Help-Keys ΓòÉΓòÉΓòÉ

Use this choice to see a list of keys and a description of the function of the
keys.


ΓòÉΓòÉΓòÉ 52. Help-Contents ΓòÉΓòÉΓòÉ

Use this choice to display the help table of contents.  The help table of
contents lists the titles of the help information in order by contents.


ΓòÉΓòÉΓòÉ 53. Help-Index ΓòÉΓòÉΓòÉ

Use this choice to display the help index.  The help index lists the titles of
the help information in alphabetical order.


ΓòÉΓòÉΓòÉ 54. Help-Product Information ΓòÉΓòÉΓòÉ

This dialog displays information about the application, such as version number
and copyright notice.


ΓòÉΓòÉΓòÉ 55. Help-Registration Information ΓòÉΓòÉΓòÉ

This product is NOT freeware.  It is distributed under the ShareWare concept
and depends upon registration fees in order to support its development.
Unlike, commercial 'shrink-wrapped' software, this concept urges you to give
the entire set of program files to others to try before they buy.  Other than
that, you should consider this to be JUST LIKE commercial software.  If you
continue using the program, even if there are some things you'd like to work
differently, you are obligated to pay for it.  SUPPORT SHAREWARE WITH YOUR
REGISTRATION FEES!!!!!

This document and the current version of this program ("the software") are
copyrighted by the author. The copyright owner hereby licenses you to: use the
software; make as many copies of the program and documentation as you wish;
give such copies to anyone; and distribute the software and documentation via
electronic means.  However, you are specifically prohibited from charging, or
requesting donations, for any such copies, however made.  No copy of the
software may be distributed or given away without this document and this notice
must not be removed.

Direct mail payment should be made in US$ either by a check drawn on a US bank,
US money order, or an American Express International money order.  Mail your
payment and registration form (form and prices are in the ORDER.DOC file) to:

       Larry R. Waibel
       Leading the Way
       427 Haverford Road
       Ramona, Calif.  92065

 Orders may be placed via CompuServe by the GO SWREG mechanism.  The
 registration ID for PMDMatch is 5204.

 Orders may also be made by contacting BMT Micro who will accept Visa,
 Mastercard, Discover, American Express, Cashiers Checks, Money Orders,
 Personal Checks, (just about anything except smoke signals <s>).

       By Mail:
            BMT Micro
            452 Horn Rd
            Wilmington, NC  28412-2411
            USA
       By Phone:
            [phone]  Voice
            [phone]  Orders only
       By FAX:
            [phone]
       By BBS:
            [phone]  (10 lines, all 14.4)
            [phone]  (28.8 line)
       By CompuServe:
            74031,307    (Be sure to include all information on the form)

 Suggestions, questions, and technical support requests should be addressed to
 the author via the 'OS/2 Shareware' section of the CompuServe OS2BVEN (GO
 OS2SHARE) forum, ID 71333,2463.  (I have an alternate ID, 70441,1274, but I
 don't check it very often; only use it if you don't get any response from the
 primary ID).

 Standard Disclaimer of Warranty:  Larry R. Waibel and Leading the Way hereby
 disclaim all warranties relating to this software, whether express or implied,
 including without limitation any implied warranties of merchantability or
 fitness for a particular purpose.  They will not be liable for any special,
 incidental, consequential, indirect or similar damages due to loss of data or
 any other reason.  In no event shall Larry R. Waibel and Leading the Way's
 liability for any damages ever exceed the price paid for the license to use
 the software, regardless of the form of the claim.  If this product causes you
 any problems, I will do my best to help determine what happened and correct
 any bugs I find.  However, as stated, I can NOT be held responsible for any
 data, financial, or other loss incurred by its use!

 Note:  The OS/2 Ready! mark is a trademark of International Business Machines
 Corporation.


ΓòÉΓòÉΓòÉ 56. Dialog Ok ΓòÉΓòÉΓòÉ

This applies all of the changes made in the dialog.


ΓòÉΓòÉΓòÉ 57. Dialog Cancel ΓòÉΓòÉΓòÉ

This dismisses the dialog box and discards all of the changes made in the
dialog.


ΓòÉΓòÉΓòÉ 58. Dialog Help ΓòÉΓòÉΓòÉ

This shows the general help for the dialog box.


ΓòÉΓòÉΓòÉ 59. Error handling ΓòÉΓòÉΓòÉ

When the program starts up, it attempts to create a PMDMATCH.ERR file in the
current directory; if that file exists, it tries to create PMDMxTCH.ERR, where
"x" equals B, C, D, and so on.  If the program ends abnormally for some reason,
this file will left and its contents may help the author track down the
problem.  But if your system 'crashes' or is improperly shutdown while PMDMatch
is running, these files will be left as well; they can be deleted without
causing any problems for PMDMatch.

Another type of error that can happen will bring up a message box indicating
that an *Error with a given code has occurred at a certain line number in a
certain program file.  If you get this type of error, a MYPMERRS.ERR file will
be written in the current directory which contains that information and may
also be needed by the author; it can also be deleted without problem.

Finally, some 'recoverable' DOS API errors (such as access denied when trying
to write to a read-only file or the floppy drive not being ready) can occur
which will bring up a message box allowing you to Abort, Retry, or Ignore the
operation currently in progress.  Just click the appropriate button.


ΓòÉΓòÉΓòÉ 60. UNKNOWN ΓòÉΓòÉΓòÉ

This message is displayed when there is no help at this time for the item you
have selected.  If this happens, please contact the author so he can supply the
help needed!