Metropoli BBS
VIEWER: mrfilepm.doc MODE: TEXT (CP437)











        MR. FILE/PM: A SIMPLE, CONFIGURABLE OS/2 FILE MANAGER (4.1)







                           October 25, 1992




                           Mike Kaczmarski
                                IBM AdStaR
                                Tucson, AZ




                        IBM ESDTOOLS Use Only




































                                                          IBM ESDTOOLS USE ONLY


























































  ii






  IBM ESDTOOLS Use Only


  PREFACE
  _______





  Mr. File/PM was intended as a simple replacement for the File Manager or
  Drives. In addition, it should provide easy access to the OS/2 command line
  and configurability to streamline execution of commands against a group of
  files.


| CHANGES FOR MR. FILE/PM VERSION 4.1

| Requested Enhancements:

| o   Enhanced the 32-bit version of the program to support either a top-down
|     or left-to-right sort ordering on the file display window.  Files dis-
|     played can be sorted either top to bottom by column or left to right by
|     row.

| o   Enhanced the copy/move drag/drop dialog windows to allow the user to
|     change between move/copy operations after a drop has been made.  This
|     will permit the use of the default workplace shell copy/move keys, or to
|     change the desired action at the last moment.

| o   Added support for copying or moving files to a subdirectory shown in the
|     current window, simply by dropping the files on the sub-directory.

| o   Added support for CTRL-/ and CTRL-\ in selecting all files and de-
|     selecting all files, respectively.

| Most of the work on this version was involved with correcting deficiencies
| with the initial 32-bit version 4.0, as documented below:

| Corrections:

| o   Corrected a problem when dragging multiple files to the shredder.  All
|     files can now be confirmed for deletion with a single key-stroke.

| o   Corrected the 32-bit Workplace Shell drag/drop implementation to cor-
|     rectly print files on the printer on which the files are dropped.

| o   Corrected problems with the initial profile placement (MRFILEPM.INI)

| o   Increased the size of the mask dialog to allow for a large number of
|     masks to be specified.




                                                                   Preface  iii






                                                          IBM ESDTOOLS Use Only


| o   Enhance the "copy to clipboard" function to copy file attribute values to
|     the clipboard, along with the file names, when file details are shown in
|     the display window.

| o   Corrected all file system problems (both local and LAN file systems) by
|     using the 16-bit file system calls from the 32-bit program.

| o   Made minor adjustments to the size dialog display in order to reduce its
|     size.

| o   Changed the 32-bit executable to use the system font dialog for selecting
|     fonts.  Previous users of the program will have to re-select their font
|     when starting version 4.1.

| o   Corrected problems with window refresh when the scroll window is clicked
|     on to switch to MrFile/PM from other windows.


  CHANGES FOR MR. FILE/PM VERSION 4.0

  Requested Enhancements:

  o   Mr.File/PM has been ported to an OS/2 2.0 32-bit implementation that sup-
      ports the Workplace Shell drag/drop protocol (MRFILE32.EXE and
      MRFILE32.HLP).  The 16-bit version of Mr.File/PM continues to be main-
      tained and is supplied in the package under the name MRFILEPM.EXE, with
      its companion help file MRFILEPM.HLP

      The ABOUT MR.FILE... dialog selected from the HELP menu displays
          ________________                          ____
      "Mr.File/PM (4.0) : 32-Bit" in the 32-bit version, and "Mr.File/PM (4.0)"
      in the 16-bit version.

  o   Enhanced the copy operation between two running copied of Mr.File/PM to
      support moving files as well as copying them.  Also added a dialog box
      that prompts for replacing files during the transfer or replacing older
      files only during the transfer.

  o   Reduced the size of the "Size Information" dialog so that it can be
      tucked into a corner of he screen while Mr.File/PM is used to traverse
      the file tree.

  o   Placed a DELETE button on the command dialog so that saved commands can
               ______
      be deleted from the dialog, if so desired.

  o   Added CANCEL buttons to the copy and move progress dialogs as well in
            ______
      pup-up errors to the dialogs so that the transfer process can be can-
      celled at any time.

  Corrections:

  o   Corrected the profile logic so that MRFILEPM.INI files can be located
      when correctly specified in the initial start up dialog (appears when an
      existing MRFILEPM.INI file is not found).



  iv






  IBM ESDTOOLS Use Only


  o   Fixed problems with client window update when focus is switched to the
      Mr.File/PM window.

  o   Corrected problems with Mr.File/PM timing out while waiting for a large
      or remote directory to be scanned.

  o   Corrected problems in supporting long file names in the various dialogs.

  o   Corrected problems with the ordering of dialog buttons.

  o   Corrected problems associated with the MRFILEPM.DBG files that a number
      of people sent me.

  o   Corrected a problem with the destination dialog when all files are being
      displayed for a particular file tree.

  o   Corrected a problem when dragging a directory between two copies of
      Mr.File/PM.

  o   Corrected the dotted line that is shown when a modified file mask is used
      so that it would be visible using XGA displays.

  o   The secondary mouse button no longer acts like the primary mouse button
      with the Ctrl key pressed down when selecting files.  This is due to that
      fact that the drag/drop support is very sensitive to mouse movements made
      with the secondary mouse button pressed.

  o   Fixed other miscellaneous problems.




























                                                                     Preface  v






                                                          IBM ESDTOOLS Use Only


























































  vi






  IBM ESDTOOLS Use Only


  NOTES ON DRAG/DROP SUPPORT
  __________________________





  While drag/drop support was added for OS/2 2.0, the older "configurable"
  drag/drop support was retained for those who wish to use it.  If you con-
  figure Mr.File/PM to perform certain actions when files are dropped on other
  windows (using DRAG/DROP WINDOW ASSOCIATIONS under the PROFILE MENU), the
                 _____________________________           ____________
  older protocol must be used.  The older drag/drop protocol will be invoked
| when the ALT key is held down while dragging files. An option may be used to
| set the default drag drop to the configurable flavor from the PREFERENCES
                                                                ___________
| selection under the PROFILE menu.

  You may notice that the workplace drag/drop is quite slow in tracking to
  mouse movements when a large number of files are selected.  This is due to
  the fact that the workplace shell sends messages to the window under the
  mouse for EACH file selected.  The older configurable drag/drop protocol does
  not do that and so you may want to use this for copying or moving a large
  number of files.

  When Mr.File/PM (32-bit: MRFILE32.EXE) is started, the default drag/drop pro-
  tocol is the Workplace shell protocol. To use the configurable protocol, hold
| down the ALT key before starting the drag operation.  If you change the
| selection in the PREFERENCES dialog under the PROFILE menu, the default
                   ___________                  _______
| drag/drop protocol will be the configurable flavor, and the Workplace shell
| drag/drop will be invoked if the ALT key is held down before the drag is
| started.

  +--- IMPORTANT: DRAG/DROP KEY CHANGES --------------------------------------+
  |                                                                           |
  | Please note that the way in which drag/drop works has been changed in     |
  | this release to be consistent with the OS/2 2.0 workplace shell.  This    |
  | change applies to the configurable drag/drop support as well as with the  |
  | 16-bit version of the program.                                            |
  |                                                                           |
  | o   The DEFAULT action to occur when files are dragged, is to MOVE the    |
  |     files.                                                                |
  |                                                                           |
  | o   To COPY files, hold down the CTRL key while the files are dragged.    |
  |                                                                           |
  | With the workplace shell drag/drop,                                       |
  |                                                                           |
  | o   File LINKS (SHADOWS) to the desktop or other folders can be created   |
  |     if the CTRL and SHIFT keys are held down during the drag.             |
  |                                                                           |
| | The move or copy operation can be changed by selecting the proper buttons |
| | in the destination dialog, before the actual operation is performed..     |
  |                                                                           |
  +---------------------------------------------------------------------------+





                                                Notes on Drag/Drop Support  vii






                                                          IBM ESDTOOLS Use Only


























































  viii






  IBM ESDTOOLS Use Only


  CONTENTS
  ________





  OVERVIEW   1

  INSTALLING MR.FILE/PM   3

  TRAVERSING THE FILE SYSTEM   5
  Using the Mouse to Traverse the File System   5
  Using the Keyboard to Traverse the File System   5

  SELECTING FILES AND DIRECTORIES   7
  Using the Mouse to Select files/directories   7
  Using the Keyboard to select files/directories.   7

  REMEMBERING A DRIVE'S CURRENT DIRECTORY   9

  JUMPING TO A FILE IN THE DISPLAY WINDOW   11

  SHOWING ALL FILES IN A DIRECTORY TREE   13

  OPENING A FILE   15

  PERFORMING OPERATIONS ON SELECTED FILES/DIRECTORIES   17

  EXECUTING COMMANDS   19
  The Command Dialog   19
    Command Format   19

  KEY ASSIGNMENTS   23

  THE DESTINATION DIALOG   27

  CHANGING THE FILE MASK   29

  CHANGING THE FILE DISPLAY LENGTH   31

  QUICK CHANGE TO A PREVIOUS DIRECTORY   33

  DRAGGING AND DROPPING SELECTED FILES/DIRECTORIES   35

  DEFAULTING TO THE WORKPLACE SHELL OR THE CONFIGURABLE DRAG/DROP PROTOCOL   37

  CHANGING THE FONT FOR THE FILE DISPLAY   39

  DISPLAYING SIZE INFORMATION   41

  STARTING ANOTHER COPY OF MRFILE/PM   43

  CUSTOMIZING MR. FILE/PM   45



                                                                   Contents  ix






                                                          IBM ESDTOOLS Use Only


  CUSTOM MENU OPTIONS   47

  FILE/COMMAND ASSOCIATIONS   49

  DRAG/DROP WINDOW ASSOCIATIONS   51

| MRFILE/PM (32-BIT) PREFERENCES   53

















































  x






  IBM ESDTOOLS Use Only


  OVERVIEW
  ________





  Mr. File/PM is a simple OS/2 file manager that provides:

  1.  Traversal of directories and drives in the OS/2 file system including:

      o   file/directory sorting
      o   file attribute display
      o   file/directory copy, move, delete, and rename operations
      o   file/directory attribute modification
      o   MASK specification to view matching file names
          ____
      o   display of drive, memory, and selected file size statistics

  2.  Entry of commands that get executed immediately as separate tasks

      o   including the ability to execute commands using selected files from
          the file display

  3.  Customizing the Mr. File/PM file pull-down menu to automate user-defined
      commands against selected files

  4.  Customizing Mr. File/PM to determine commands that automatically get exe-
      cuted against files when double-clicked

  5.  Customizing Mr.File/PM to invoke certain commands when file are dropped
      on specified windows on the desktop.

  6.  Customizing Mr.File/PM so that it starts with selected default features
      (font, mask, hidden files, temporary disk space, etc)

  7.  Support for the OS/2 1.X and 2.0 Drag-Drop protocol for files selected on
      the screen including dropping on a drive letter to copy to a subdirectory
      on the selected drive, or dropping on a Communications manager 3270 Emu-
      lator screen to copy the files to that host session, using a program like
      almcopy.

  The following sections provide more information on the functions provided:

  o   "Installing Mr.File/PM" on page 3

  o   "Traversing the file system" on page 5

  o   "Selecting Files and Directories" on page 7

  o   "Remembering a Drive's Current Directory" on page 9

  o   "JUMPing to a file in the display window" on page 11

  o   "Opening a File" on page 15



                                                                    Overview  1






                                                          IBM ESDTOOLS Use Only


  o   "Performing operations on selected files/directories" on page 17

  o   "Showing All Files in a Directory Tree" on page 13

  o   "Executing Commands" on page 19

  o   "Changing the File Mask" on page 29

  o   "Changing the File Display Length" on page 31

  o   "Quick Change to a Previous Directory" on page 33

  o   "Dragging and Dropping Selected Files/Directories" on page 35

  o   "Defaulting to the Workplace Shell or the Configurable Drag/Drop pro-
      tocol" on page 37

  o   "Changing the font for the file display" on page 39

  o   "Displaying Size Information" on page 41

  o   "Starting another copy of MrFile/PM" on page 43

  o   "Customizing Mr. File/PM" on page 45
































  2






  IBM ESDTOOLS Use Only


  INSTALLING MR.FILE/PM
  _____________________





  To install the 32-bit (OS/2 2.0) version of Mr. File/PM, perform the fol-
  lowing actions:

  1.  Copy the following file to a directory that resides in your OS/2 search
      path (from the PATH= statement in CONFIG.SYS).
                     _____

      o   MRFILE32.EXE

  2.  Copy MRFILE32.HLP to a directory that shows up in your HELP path (from
      the HELP= statement in CONFIG.SYS).
          _____

      o   I recommend copying the file to C:\OS2\HELP

  3.  From an OS/2 session, type the following:

      o   start mrfile32.exe

  To install the 16-bit (OS/2 1.X+) version of Mr. File/PM, perform the fol-
  lowing actions:

  1.  Copy the following file to a directory that resides in your OS/2 search
      path (from the PATH= statement in CONFIG.SYS).
                     _____

      o   MRFILEPM.EXE

  2.  Copy MRFILEPM.HLP to a directory that shows up in your HELP path (from
      the HELP= statement in CONFIG.SYS).
          _____

      o   I recommend copying the file to C:\OS2\HELP

  3.  From and OS/2 session, type the following:

      o   start mrfilepm.exe

  Mr.File/PM will create a configuration file named MRFILEPM.INI to store con-
  figuration information for Mr.File/PM.  This file can be located in any
  directory specified in your PATH= parameter in CONFIG.SYS.
                              _____

  If you wish to locate the MRFILEPM.INI file in a directory that is not in
  your PATH specification, you can specify the directory in a special environ-
  ment variable, MRFILE_PATH= in CONFIG.SYS.  If this variable is used, it will
                 ____________
  take precedence over directories specified in the PATH=  (e.g.
                                                    _____
  MRFILE_PATH=C:\MYINIDIR\).
  ________________________

  The following sequence describes how Mr.File/PM attempts to locate
  MRFILEPM.INI when starting:




                                                       Installing Mr.File/PM  3






                                                          IBM ESDTOOLS Use Only


  1.  Mr.File/PM looks to see if MRFILE_PATH= has been specified.  If it has,
                                 ____________
      the program checks to see if MRFILEPM.INI exists in the directory speci-
      fied.

      If MRFILEPM.INI exists in the directory, then it is used.  Otherwise, the
      user is prompted for the location of the MRFILEPM.INI file, using the
      directory specified in MRFILE_PATH as the default.
                             ___________

  2.  If Mr.File/PM finds that MRFILE_PATH= has NOT been specified, then the
                               ____________     ___
      path is searched (list of directories in PATH= in CONFIG.SYS)  looking
                                               _____
      for the MRFILEPM.INI file.

      If MRFILEPM.INI is found in a directory in the path, then it is used.
      Otherwise, the user is prompted for the location of the MRFILEPM.INI
      file, using the directory from which MRIFLEPM.EXE was loaded as the
      default.

  Please note that if you specify MRFILE_PATH=, then the PATH= is never used to
                                  ____________
  search for MRFILEPM.INI.  The easiest thing to do is to place the
  MRFILEPM.INI file in a directory in your PATH=, usually in the same directory
  in which MRFILEPM.EXE is located.

  The ABOUT MR. FILE... selection from the HELP pull-down menu will display the
      _________________                    ____
  fully-qualified name of the MRFILEPM.INI file that is currently being used by
  the program.































  4






  IBM ESDTOOLS Use Only


  TRAVERSING THE FILE SYSTEM
  __________________________





  Mr. File/PM initializes by displaying files and subdirectories on the current
  drive and in the current subdirectory.  The default display shows files in a
  column-row format similar to a spreadsheet.  This can be changed with the
  Length  menu selection to show file/directory attributes as well. ("Changing
  the File Display Length" on page 31).

  Disk drives are displayed across the top of the window in a format like
  [-A-].

  The current directory and FILE MASK are displayed in the title bar.
                            _________


  USING THE MOUSE TO TRAVERSE THE FILE SYSTEM
  ___________________________________________

  To display files/directories on another disk drive, double-click with the
  primary mouse button on the drive letter for the drive.

  To change to another directory, double-click on the directory (with the
  primary mouse button) in the file display window.  Directories include the
  '\' character at the end of their name.  The ..\ entry indicates the parent
  directory, and may be double-clicked on to move to the parent.

| To OPEN a file, double-click on the file name.
     ____

| One or more directories or files may be selected to perform other operations
| on (like copying, renaming or deleting).  Refer to "Selecting Files and
| Directories" on page 7 for more information on this.


  USING THE KEYBOARD TO TRAVERSE THE FILE SYSTEM
  ______________________________________________

  To display files/directories on another disk drive, press and hold the Ctrl
  and Shift keys and then press the letter for the drive that you want to
  change to.

  To change to another directory, use the arrow keys to position the selection
  box over the directory you wish to change to in the file display window.
  Pressing enter when the desired directory is selected will change to that
  directory.  Directories include the '\' character at the end of their name.
  The ..\ indicates the parent directory, and may be selected to move to the
  parent.

| To OPEN a file, press enter when the file name is selected.
     ____

| One or more directories or files may be selected to perform other operations
| on (like copying, renaming or deleting).  Refer to "Selecting Files and
| Directories" on page 7 for more information on this.



                                                  Traversing the file system  5






                                                          IBM ESDTOOLS Use Only


























































  6






  IBM ESDTOOLS Use Only


  SELECTING FILES AND DIRECTORIES
  _______________________________





  One or more files may be SELECTED so that operations can be performed upon
  them (e.g.  copy, delete, rename...).  A single file, or group of files and
  subdirectories can be selected within the directory displayed.


  USING THE MOUSE TO SELECT FILES/DIRECTORIES
  ___________________________________________

  To select a file/directory with the mouse, click on the file or directory
  name with the primary mouse button.  Other files/directories that were
  selected will be de-selected when this is done.

  A number of files/directories my be selected by moving the mouse over their
  name while HOLDING DOWN the primary mouse button.
             ____________

  To select a list of files/directories that follow each other in the display
  window, click on the first file/directory, and then, while holding down the
  SHIFT key, click on the last file in the list.

  To select a number of files/directory from differing positions in the display
  window, click on  them while holding down the CTRL key.  This will select the
| file or directory with out de-selecting those currently selected.  The sec-
| ondary mouse button may also be used to select files in this manner.

| To DE-SELECT a file/directory click on it while holding the CTRL key down, or
| click on it with the secondary mouse button.

  ALL selected files/directories can be de-selected when selecting another
  file/directory by clicking on it with the primary mouse button (shift or ctrl
  keys are not held down).


  USING THE KEYBOARD TO SELECT FILES/DIRECTORIES.
  _______________________________________________

  To select a file or directory with the keyboard, use the arrow keys to place
  the selection bar on the desired file or directory name.

  To select a list for files/directories that are located next to each other on
  the display, use the arrow keys to move the selection bar to the first bar,
  and then move the selection bar to the last file while holding down the SHIFT
  key.










                                             Selecting Files and Directories  7






                                                          IBM ESDTOOLS Use Only


























































  8






  IBM ESDTOOLS Use Only


  REMEMBERING A DRIVE'S CURRENT DIRECTORY
  _______________________________________





  To display files/directories on another disk drive, double-click with the
  primary mouse button on the drive letter for the drive, or press and hold the
  Ctrl and Shift keys and then press the letter for the drive that you want to
  change to.  MrFile/PM will normally display the root directory for the drive
  selected.  If REMEMBER DRIVE'S CURRENT DIRECTORY is selected from the OPTIONS
                __________________________________                      _______
  pull-down menu, however, a drive's "current directory" is displayed when it
  is switched to.  The current directory for a drive is normally the last
  directory that was displayed on that drive, when you switched to a differing
  drive.

  The state of this "Remember" option is displayed with a check mark next to
  the selection in the OPTIONS pull-down menu when active.  The state is saved
                       _______
  in MRFILEPM.INI when SAVE CURRENT OPTIONS is selected from the PROFILE pull-
                       ____________________                      _______
  down menu.




































                                     Remembering a Drive's Current Directory  9






                                                          IBM ESDTOOLS Use Only


























































  10






  IBM ESDTOOLS Use Only


  JUMPING TO A FILE IN THE DISPLAY WINDOW
  _______________________________________





  When large directories are displayed, you can use the JUMP feature of
  MrFile/PM to quickly position the selection bar to a particular file name.
  While holding down the SPACE BAR, a key press will cause the MrFile/PM
  selection in the display window to JUMP to the first file whose name begins
  with the letter pressed (if it exists).  More keys may be pressed (while the
  space bar remains down) to further qualify the search.  When the down or
  right arrow is pressed (while the space bar remains down), the next file
  matching the search string is selected, the up or left arrow keys move the
  selection bar to the previous file that matches the search characters.

  For example, to locate MRFILEPM.EXE in the current directory, hold down the
  space bar and press the 'M' key. The selection bar will jump to the first
  file whose name begins with an 'M' (if any exist in the current directory).
  With the space bar still down, press the 'R' key to jump to the first file
  whose name begins with 'MR'.  Pressing the right or down arrow key, with the
  space bar still held down will jump to the NEXT file whose name begins with
  'MR'.  The up or left arrow keys will jump to the previous file beginning
| with 'MR'.  To start a new search, release the space bar, press the home key
| (to position the window to the beginning of the display), hold down the space
| bar and start pressing keys again.






























                                    JUMPing to a file in the display window  11






                                                          IBM ESDTOOLS Use Only


























































  12






  IBM ESDTOOLS Use Only


  SHOWING ALL FILES IN A DIRECTORY TREE
  _____________________________________





  When SHOW ALL FILES IN CURRENT TREE is selected from the VIEW pull-down menu,
       ______________________________                      ____
  Mr.File/PM will scan the current directory for all files, recursively through
| all directories, downward from the current directory ( all files on the
| drive, if the current directory is the root (\) ).  The scan may take a while
| to accomplish, depending upon the size of the current directory.

  The fully-qualified file name for each file in the tree will be displayed in
  the file display window.  The following summarizes some of the uses for
  Mr.File/PM in this mode:

  o   you can find the largest files in the tree (sorting by file size)

  o   you can find the latest file updated in the tree (sorting by date)

  o   you can look for duplicate files in the tree (sorting by file name)

  o   you can search the tree for all instances of a certain file name pattern
      (by changing the file mask using the FILE MASK option from the VIEW pull-
                                           _________                 ____
      down menu)

  Most file operations will be available when operating in this mode.  The only
  notable exception being traversal of the drive's directory tree.  If you
  click again on the current drive letter, you will see all files in the tree
  from the root, or all files on the current drive.  The QUICK CHANGE option
                                                         ____________
  can be used to change to other directory trees that you have been using to
  see the files in their trees.
























                                      Showing All Files in a Directory Tree  13






                                                          IBM ESDTOOLS Use Only


























































  14






  IBM ESDTOOLS Use Only


  OPENING A FILE
  ______________





  To OPEN a file, double-click on the file name in the file display window, or
     ____
  press enter when the selection bar (dotted box) is positioned on the file
  name.

  The action performed on a file when 'opened' is determined by the file's name
  and is specified in the PROFILE menu.  These actions may be customized so
                          _______
  that your desired actions occur automatically when the file is opened ("Cus-
  tomizing Mr. File/PM" on page 45.).










































                                                             Opening a File  15






                                                          IBM ESDTOOLS Use Only


























































  16






  IBM ESDTOOLS Use Only


  PERFORMING OPERATIONS ON SELECTED FILES/DIRECTORIES
  ___________________________________________________





  A number of actions can be performed on selected files or directories:

  o   Files/directories can be COPIED to another drive or directory by
      selecting the COPY menu option from the FILE pull-down menu or by
                    ____                      ____
      pressing ctrl-c.

      The destination dialog will be displayed so that you can selected a des-
      tination for the files/directories to be copied to.  ("The Destination
      Dialog" on page 27)

      If a directory is selected, all files and subdirectories under the
      selected directory will be copied to the destination drive/directory.

      You may choose to replace files in the target directory if they have the
      same name as the files being copied, or you may choose to replace those
      files only if they have the same name as the files being copied and they
      are older (have an earlier modification date) than the files being
      copied.

  o   Files/directories can be MOVED to another drive or directory by selecting
      the MOVE menu option from the FILE pull-down menu or by pressing ctrl-m.
          ____                      ____

      The destination dialog will be displayed so that you can selected a des-
      tination for the files/directories to be moved to.

      When moving a directory from one location to another, the original direc-
      tory and its contents WILL NOT be deleted.  This will be fixed in a sub-
      sequent release of Mr. File/PM.

  o   Selected files/directories can be CLONED (copied to another name in the
      current directory) by selecting the CLONE menu option from the FILE menu
                                          _____                      ____
      or by pressing ctrl-o.  A dialog box will be displayed so that you can
      enter the name to which the file or directory should be cloned.

      When directories are cloned, all files and subdirectories under the
      selected directory will be copied to the new directory.

      You may choose to replace files in the target directory if they have the
      same name as the files being copied, or you may choose to replace those
      files only if they have the same name as the files being copied, and they
      are older (have an earlier modification date) than the files being
      copied.

  o   Selected files/directories can be RENAMED (to another name in the current
      directory) by selecting the RENAME menu option from the FILE menu or by
                                  ______                      ____
      pressing ctrl-r.  A dialog box will be displayed so that you can enter
      the name to which the file or directory should be renamed.



                        Performing operations on selected files/directories  17






                                                          IBM ESDTOOLS Use Only


  o   To DELETE selected files/directories, choose the DELETE menu option from
                                                       ______
      the FILE menu or press ctrl-d.  A dialog box will be displayed showing
          ____
      the candidate files for deletion.  You can change your mind about
      deleting certain files by double-clicking on the to remove them from the
      list.  Choosing OK will delete the files/directories listed.

      When a directory is deleted, all files and subdirectories in the direc-
      tory are also deleted.

  o   To change the ATTRIBUTES of selected files/directories, choose the CHANGE
                                                                         ______
      ATTRIBUTES menu selection from the FILE menu or press ctrl-b.  The dialog
      __________                         ____
      displayed will allow to choose attribute values for setting or clearing
      on the selected files/directories.

  o   To DRAG the selected files over the window of an application that sup-
      ports the drag-drop protocol, hold down the secondary mouse button
      (manipulator button), and move the mouse pointer over the target applica-
      tion window or icon.  The mouse pointer icon will change to indicate
|     whether or not a target application can receive dragged files.  Files
|     must be selected in the Mr. File/PM window to be eligible for dragging.

      The files may be dragged over a disk drive letter to copy them to a
      directory on the indicated drive.  The destination window will be shown
      when the files are dropped on the drive letter prompting for the direc-
      tory desired on that drive.

      The files may be dropped over a Communications Manager 3270 Emulator
      session to copy them to the host (using a program like ALMCOPY).  Please
      refer to "Customizing Mr. File/PM" on page 45 for instructions on speci-
      fying this copy program.

      The files may be dropped over another MrFile/PM window (another copy of
      MrFile/PM) to copy the files to the directory displayed in the second
      MrFile/PM window.

  o   To execute a command against selected files/directories, select the COM-
                                                                          ____
      MANDS menu option from the FILE menu or press ESC.  The command display
      _____                      ____
      will be displayed so that your command can be entered.

      The Command Dialog will be also displayed automatically anytime you start
      to type a command on the file display.  Please refer to "Executing Com-
      mands" on page 19 for more information on typing in a command.














  18






  IBM ESDTOOLS Use Only


  EXECUTING COMMANDS
  __________________





  You may type in an OS/2 or DOS command to execute at any time, by pressing
  the ESC key or simply by starting to type the command.

  The command dialog will be displayed, and your command will execute as a sep-
  arate process when OK is selected (when you press enter after typing the
  command).

  Any OS/2 or DOS command or program name can be specified for execution.  You
  may also specify a command that will execute against selected
  files/directories.


  THE COMMAND DIALOG
  __________________

  The command dialog is shown when you press the ESC key or start to type in a
  command.  The dialog displays a list for the last 20 commands that you exe-
  cuted so that they may be chosen again for execution.

  You may type in a new command to execute.  Optionally, the command you
  specify can use the selected files/directories in the command line.

  You may remove saved commands from the command dialog list box by pressing
  the DELETE key on the dialog when a command is selected in the list box.
      ______


  COMMAND FORMAT

  The following diagram illustrates the format for a command you enter:






















                                                         Executing Commands  19






                                                          IBM ESDTOOLS Use Only




  >>─-───---──────-─<command>─>
     | - |└─ dos ─┘
     | + |
     └ . ┘

    ┌───────────────────────┐
    V                       |
  >──-─────────-───-──────-─-<<
     |─ parms ─|   |─ /  ─|
     └─ &var  ─┘   |─ // ─|
                   |─ /f ─|
                   |─ /n ─|
                   |─ /e ─|
                   |─ /p ─|
                   |─ /d ─|
                   |─ /l ─|
                   |─ /m ─|
                   └─ /cb─┘


  The <COMMAND> symbol represents the name of the command you specify.  This
  command can be any OS/2 or DOS command or program.  The following list
  describes the other command parameters.

  -         Does not pause after the <command> is executed.  Normally, the
            command is paused after execution until a key is pressed.  The '-'
            specification at the beginning of the command line cancels this
            pause and the task immediately exits after execution of the
            command.

  +         Operates the same as the - parameter above, but starts the session
            with the screen MAXIMIZED on the screen.

  .         Operates the same as the - parameter above, but starts the session
            with the screen MINIMIZED (as an icon) on the screen.

  DOS       Executes the <command> in the OS/2 DOS box.  Any DOS command or
            program can be specified as the <command> symbol using this option.

            Under OS/2 2.0, the command is started in a DOS session, using the
            paths specified in the AUTOEXEC.BAT file in the root of the boot
            drive, if it exists.  You can change the started DOS window session
            to a full-screen session by pressing Alt-Home after the session has
            started.

  PARMS     Any needed command parameters.

  &VAR      Parameter variables that must be specified before the command is
            executed.  The Ampersand(&) character before a variable name indi-
            cates that you want Mr.File/PM to prompt you for a parameter value
            before executing the command.  When the command is executed by
            Mr.File/PM, a dialog box will be displayed, showing the command,


  20






  IBM ESDTOOLS Use Only


            and asking for the value of the variable.  You may then type in the
            parameter value, and press enter to have the value used in the exe-
            cution of the command.

            A special variable, &path, may be specified to cause Mr.File/PM to
            prompt the user for a directory path (using a special directory
            dialog to traverse the file system).  The directory selected is
            then substituted into the command in the place of the &path spec-
            ification.

|           Two ampersand characters (&&) may be specified to place a single
|           ampersand in the command stream.  A single ampersand can be placed
|           in the command stream between commands that should be executed.  In
|           this manner, more than one command may be specified on a single
|           command line.  For example, the command "dir && date" will execute
|           the directory command followed by the date command.

  /         Substitutes the fully-qualified name(s) for selected
            file(s)/directory(ies).  The specified command will be repeated for
            each file/directory that is selected in the file display window.

  //        Substitutes the '/' character in the command stream.

  /F        Substitutes the file name (name + extension) for each selected
            file/directory.  The specified command will be repeated for each
            file/directory that is selected in the file display window.  The
            full directory path will not be included with the name.

  /N        Substitutes the name for each selected file/directory.  The speci-
            fied command will be repeated for each file/directory that is
            selected in the file display window.  File extensions will not be
            included.

  /E        Substitutes the extension for each selected file/directory.  The
            specified command will be repeated for each file/directory that is
            selected in the file display window.  File names will not be
            included.

  /P        Substitutes the fully qualified path name for the current directory
            in the command.  Selected file/directory names are not included.

  /D        Substitutes the Drive letter for the current directory.  The colon
            (":") character is not included.

  /L        Substitutes a list containing all selected files/directories in the
            command stream.  The selected files/directories are all substituted
            in one string and the command is not repeated for each selected
            file/directory.

            This option is a good choice for loading all selected files into a
            single instance of an editor (e.g. epm).

  /M        Substitutes the current directory mask into the the command.



                                                         Executing Commands  21






                                                          IBM ESDTOOLS Use Only


  /CB       Substitutes a line of text from the Presentation Manager clip board
            into the command.  The command will be repeated as many times as
            there are lines of text in the clipboard (or as there are selected
            files, which ever is greater), substituting each line of text found
            in the clipboard in a command.

            For example, to download a list of files from your Communications
            Manager emulator session, MARK the file names (in fulist or
            filelist), and COPY them to the clipboard.  The following command
            can then be used to download the filenames in the clipboard to your
            current MrFile/PM directory:

            ALMCOPY HA:/CB
            ______________











































  22






  IBM ESDTOOLS Use Only


  KEY ASSIGNMENTS
  _______________





  ACCELERATOR KEYS (FOR MR. FILE/PM)

| CTRL+/
|      Select all directories/files in the current directory

  CTRL+A
       Select all directories/files in the current directory

  CTRL+B
       Change the attributes of the selected files

  CTRL+C
       Copy the selected file to another drive/directory

  CTRL+D
       Delete the selected directories/files

  DEL
       Delete the selected directories/files

| CTRL+E
|      Sort the file list by file extension

  CTRL+F
       Refresh the file display

  CTRL+H
       Change the font for the file display

  CTRL+I
       Toggle the mode to display all files in the current directory tree
       (directory tree downward from the current path)

  CTRL+INS
       Copy the names of the selected directories/files (fully-qualified) into
       the PM clipboard

       You can use this method to copy a file name to the clipboard, an then
       insert it in an entry field for another program by pressing shift-ins
       when the cursor is active in the edit box.  This is a handy method to
       open a file without typing its name or searching through the directory
       tree in the open file dialog of another program.

  CTRL+K
       Change the file display mask





                                                            Key Assignments  23






                                                          IBM ESDTOOLS Use Only


  CTRL+L
       Toggle the Length of the files displayed (from short length to long
       length and visa versa).  Long length shows the file attributes.

  CTRL+M
       Move the selected file to another drive/directory

  CTRL+N
       Sort the file list by file name

  CTRL+O
       Clone the selected files

  CTRL+P
       Save the current Mr.File/PM configuration (screen position, font, etc.)
       so that it is re-established the next time that Mr.File/PM is invoked.

  CTRL+Q
       'Quick Change' to a previous directory in which you performed operations
       or executed commands

  CTRL+R
       Rename the selected directories/files

| CTRL+S
|      Display statistics on the size of the current disk drive, selected
|      files, and free disk space

  CTRL+T
       Sort the file list by file modification date

  CTRL+U
       Deselect all files in the file list

| CTRL+\
|      Deselect all files in the file list

  CTRL+V
       Save the current directory in the quick change list

  CTRL+W
       Change to the last directory in the quick change list

  CTRL+Y
       Create a new directory

  INS
       Create a new directory

  CTRL+Z
       Sort the file list by file size in descending order





  24






  IBM ESDTOOLS Use Only


  F1
       Display the Mr. File/PM extended help menu

  F3
       Exit program



















































                                                            Key Assignments  25






                                                          IBM ESDTOOLS Use Only


























































  26






  IBM ESDTOOLS Use Only


  THE DESTINATION DIALOG
  ______________________





  The destination dialog helps you choose a destination for a move or copy
  operation on selected files or directories.

  To choose the destination for the operation, double click on the disk drive
  letter for the drive you wish to target and then select the directory you
  desire on the drive by double-clicking on the directory name.  The directo-
  ries are displayed one level at a time.  You may traverse the directory tree
  by selecting a subdirectory to go down the tree, or by selecting the ..\
  directory to go up the tree (to the parent directory).

  As drives and directories are selected, the destination will be displayed in
  the box at the bottom of the dialog window.  Optionally, you may type in the
  destination path name in this box instead of selecting the drives and direc-
  tories from the list selections.

  The REPLACE EXISTING FILES check box may be marked if you do not want to be
      ______________________
  prompted when a directory or file name that you are copying/moving conflicts
  with the name of an existing file/directory at the target location.  Con-
  flicting files or directories will be erased before the selected
  file/directory is copied to the target, if it has the same name.  Do not
  check this box, if you want to confirm (via. a dialog box) the replacement of
  existing files or directories at the target destination.

  If you want to replace files only if their modification date is earlier than
  the source file date, then the REPLACE OLDER FILES check box should be
                                 ___________________
  selected.

| You may change the operation from Move to Copy or from Copy to Move by
| selecting the proper radio button beside the MOVE or COPY words in the dialog
| window.

  Select the OK push-button to start the move/copy to your selected target, or
  select CANCEL to abort the operation.

















                                                     The Destination Dialog  27






                                                          IBM ESDTOOLS Use Only


























































  28






  IBM ESDTOOLS Use Only


  CHANGING THE FILE MASK
  ______________________





  The file mask determines which files are displayed in the Mr.  File/PM file
  display window.  All subdirectories are displayed, regardless of the file
  mask specification.  The * and ? wildcard characters may be used for the mask
  specification in the same manner as with the DIR command.

  The default file mask is *.  To change the mask, select the FILE MASK...
  selection from the VIEW pull-down menu, or type ctrl-K.

  You may also use the CHANGE MASK dialog to display system or hidden files.
  These files are not normally shown in the file window.

  Multiple mask specifications can be used to determine which files are to be
  shown.  Each mask wildcard should be separated by a space, comma, or semi-
  colon.  For example, the *.C;*.H specification will show all C programs and
  header files in the current directory (files having an extension of .C or
  .H.).

  When a mask other than the default (*) is displayed, the line between dis-
  played drive letters and  directories/files will be dashed, to remind you
  that all files that exist in the directory may not be shown.  When the
  default file mask is used, the line between the drives and directories/files
  is solid.




























                                                     Changing the File Mask  29






                                                          IBM ESDTOOLS Use Only


























































  30






  IBM ESDTOOLS Use Only


  CHANGING THE FILE DISPLAY LENGTH
  ________________________________





  Files are normally displayed in the display window by file name only.  To see
  file attributes (such as date modified, size and other attributes), select
  the LIST FILE ATTRIBUTES selection from the VIEW pull-down menu or press
      ____________________                    ____
  ctrl-L.

  The LIST FILE ATTRIBUTES selection or ctrl-L may be used to toggle between
      ____________________
  long and short file display modes.  All Mr. File selection and command
  options operate with the display in either long or short modes.










































                                           Changing the File Display Length  31






                                                          IBM ESDTOOLS Use Only


























































  32






  IBM ESDTOOLS Use Only


  QUICK CHANGE TO A PREVIOUS DIRECTORY
  ____________________________________





  Whenever you perform an operation in Mr. File/PM (e.g copying files or exe-
  cuting commands), the directory you are operating in is saved.  After trav-
  ersing to another directory in the system, you may switch back to a previous
  directory by selecting QUICK CHANGE TO PREVIOUS DIRECTORY from the OPTIONS
                         __________________________________          _______
  pull-down menu, or by pressing Ctrl-Q. A dialog will be displayed that lists
  the last 20 directories in which you performed an operation.  Simply select
  the directory that you wish to return to and Press the SWITCH TO button to
                                                         _________
  quickly change back to that directory.

  If you would like to remove a directory from the quick change list, select
  the directory and press the DELETE button.
                              ______

  If you would like to save a particular directory in the quick change list so
  that you can move back to it using this option, select SAVE CURRENT DIRECTORY
                                                         ______________________
  FOR QUICK CHANGE from the OPTIONS pull-down menu or press Ctrl-V while you
  ________________          _______
  are in the desired directory.  The current directory will be saved in the
  quick change list so that you can switch to it quickly from another place in
  the file system.

  The Ctrl-W key will switch you back to the most recent directory in the quick
  change list (displayed from most recent to least recent when Ctrl-Q is
  pressed).   You may use this option to toggle between two directories of
  interest by following this procedure:

  1.  Change to the first directory

  2.  Press Ctrl-V to save the directory ion the quick change list.

  3.  Change to the second directory

  4.  Press Ctrl-V to save this directory in the quick-Change list

  5.  Press the Ctrl-W (walk-back) key to toggle between the first and second
      directories.
















                                       Quick Change to a Previous Directory  33






                                                          IBM ESDTOOLS Use Only


























































  34






  IBM ESDTOOLS Use Only


  DRAGGING AND DROPPING SELECTED FILES/DIRECTORIES
  ________________________________________________





  Mr. File/PM supports the Drag/Drop protocol implemented by programs such as
  File Manager, Drives, and the EPM (Enhanced) editor.  For the 32-bit version,
  the workplace shell drag/drop is supported as well as a "configurable"
  drag/drop protocol (used in OS/2 1.2 and 1.3).  The 16-bit version only sup-
  ports this "configurable" version.

  To use the drag drop protocol, do the following:

  1.  Select files/directories to be transferred to a target application (like
      EPM) in the Mr. File/PM file display window.

  2.  Press and hold the secondary mouse button (manipulator button).

  3.  Move the mouse pointer, noting that the pointer image changes as it is
      passed over windows or icons that do and do not support the drag/drop
      protocol.

  4.  While over an application that does support drop, release the secondary
      mouse button to transfer the selected files to the application.

  You may move or copy selected files/directories to another drive/directory by
  dropping them on a drive letter at the top of the Mr. File/PM display.  The
  destination dialog will  be displayed to prompt you for the directory on the
  selected drive that you wish to move/copy the files/directories to.  By
  default, selected files and directories are MOVED when dragged and dropped
  over a drive letter or another copy of Mr.File/PM. To COPY. the
  files/directories, hold down the CTRL key when dragging the files.
                                   ____

  Files may be moved or copied between two instances of Mr.File/PM using the
  drag/drop operation.

  You may also copy selected files to a host session, using a program like
  ALMCOPY.EXE, by dropping the files over the host session window or icon (3270
  Emulator window).  Mr. File/PM must be configured correctly to do this.
  Please refer to "Customizing Mr. File/PM" on page 45 for more details.















                           Dragging and Dropping Selected Files/Directories  35






                                                          IBM ESDTOOLS Use Only


























































  36






  IBM ESDTOOLS Use Only


  DEFAULTING TO THE WORKPLACE SHELL OR THE CONFIGURABLE DRAG/DROP PROTOCOL
  ________________________________________________________________________





  (32-bit MrFile/PM only - MRFILE32.EXE)

  When Mr.File/PM is started the first time, it defaults to use the OS/2 2.0
  workplace shell drag/drop protocol when selected files or directories are
  dragged with the secondary mouse button.  If you wish to configure Mr.File/PM
  to perform specific actions when files are dropped over other application
  windows ("Drag/Drop Window Associations" on page 51), you must use the
  "Configurable" drag/drop protocol to do this. The configurable drag/drop pro-
  tocol is used when you hold down the ALT key before starting a drag opera-
                                       ___
  tion.

| You can change the default drag/drop protocol to the "configurable" variety
| (so that you do not need to hold down the ALT key to invoke it), by de-
                                            ___
| selecting the proper choice from the PREFERENCES dialog under the PROFILE
                                                                    _______
| menu.  The Workplace Shell drag/drop protocol will then be invoked only when
| the ALT key is pressed before starting a drag operation, and the default drag
      ___
| operation will be the "configurable" protocol.

































   Defaulting to the Workplace Shell or the Configurable Drag/Drop protocol  37






                                                          IBM ESDTOOLS Use Only


























































  38






  IBM ESDTOOLS Use Only


  CHANGING THE FONT FOR THE FILE DISPLAY
  ______________________________________





  To change the font that is used to display files in Mr. File/PM, choose the
  CHANGE FONT... option from the OPTIONS pull-down menu or press CTRL-H.  The
  ______________                 _______                         ______
  font dialog will be display, initialized with the names of all fonts that
  could be found on your system.

  Click with the primary mouse button (or use the keyboard to position the
  highlight bar) over the font that you would like to switch to.  The Mr.
  File/PM display will change immediately to the font that you have selected,
  or an error message will be displayed if that font is already being used in
  the Mr. File/PM window.

  Press the OK button on the dialog when you are satisfied with the font that
  Mr. File/PM is using, or press the CANCEL button to return to the font that
  was active before the font dialog was displayed.

  You may specify a default font to be used when starting Mr.File/PM.  Please
  refer to "Customizing Mr. File/PM" on page 45 for more details.

| 32-BIT VERSION: The system font dialog is used to set the font for the
| MRFILE32.EXE program.  Follow the directions for the font dialog to set the
| MrFile/PM font using this program.





























                                     Changing the font for the file display  39






                                                          IBM ESDTOOLS Use Only


























































  40






  IBM ESDTOOLS Use Only


  DISPLAYING SIZE INFORMATION
  ___________________________





  To display information on the size of the current directory, selected files,
  space allocated and free on the current disk drive, drive label, and largest
  block of memory free, select SIZE INFORMATION from the OPTIONS pull-down
                               ________________          _______
  menu, or press CTRL-S.
                 ______

  The size dialog may be moved to the side of the MrFile/PM window, and will
  remain active until the OK button is pressed, or the dialog window is closed
  with the dialog system menu.  As you change drives, directories, or select
  files, the size statistics in the dialog window will be updated.  This mode
  may be useful when you are interested in determining sizes for marked files,
  or are interested in the sizes of directories in your file system.







































                                                Displaying Size Information  41






                                                          IBM ESDTOOLS Use Only


























































  42






  IBM ESDTOOLS Use Only


  STARTING ANOTHER COPY OF MRFILE/PM
  __________________________________





  Sometimes it is useful to have more than one directory displayed at one time.
  If you start another copy of MrFile/PM, you can quickly examine the contents
  of two directories and use Drag/Drop to copy files between the two directo-
  ries (dragging files from one copy of MrFile/PM to another MrFile/PM window).

  To start another copy of Mrfile/PM, displaying a specific directory,
  DOUBLE-CLICK with the SECONDARY mouse button on the drive letter or directory
  name of the specified drive or directory (optionally, you can double-click
  with the primary mouse button while holding down the CTRL key).  Another copy
                                                       ____
  of MrFile/PM will be started displaying the contents of item clicked on (the
  root for a drive, if a drive is clicked, or the contents of a specific direc-
  tory, if you double-clicked on a directory).






































                                         Starting another copy of MrFile/PM  43






                                                          IBM ESDTOOLS Use Only


























































  44






  IBM ESDTOOLS Use Only


  CUSTOMIZING MR. FILE/PM
  _______________________





  Mr. File/PM can be customized in a number of ways through the use of the
  PROFILE pull-down menu.
  _______

  The SAVE CURRENT OPTIONS selection saves the current state of the following
      ____________________
  settings so that they will be re-established the next time that Mr.File/PM is
  started:

  o   the font being used to display drives, directories, and files

  o   the sort order for the file/directory display

  o   whether or not file attributes are displayed in the file display window

  o   the mask that is used for selecting files or directories to be displayed
      in the window

| o   the default drag/drop protocol, and sort ordering for the file display
|     window

  The SPECIFY DRIVE FOR TEMPORARY FILES option from the PROFILE pull-down menu
      _________________________________                 _______
  allows you to specify the drive on which temporary files will be stored by
  Mr.File/PM (command files for execution).  A virtual drive is an excellent
  choice for this option, since it will improve performance.

  The SAVE POSITION/SIZE selection saves the current window size and position
      __________________
  on the screen so that they will be re-established the next time that
  Mr.File/PM is started.

  Other Mr.File/PM customizations that can be made from the PROFILE pull-down
                                                            _______
  menu are discussed in the following three sections (select one of the fol-
  lowing form more details):

  o   "Custom Menu Options" on page 47

  o   "File/Command Associations" on page 49

  o   "Drag/Drop Window Associations" on page 51













                                                    Customizing Mr. File/PM  45






                                                          IBM ESDTOOLS Use Only


























































  46






  IBM ESDTOOLS Use Only


  CUSTOM MENU OPTIONS
  ___________________





  The CUSTOM MENU OPTIONS dialog lets you specify customized actions to be
      ___________________
  added to the FILE pull-down menu for MrFile/PM, or create and add items to
               ____
  your own pull-down menus from the main action bar.  These actions can be used
  to execute commands you specify against selected files in the file display
  area of the Mr.  File/PM window.  Select CUSTOM MENU OPTIONS from the PROFILE
                                           ___________________          _______
  pull-down menu to get to this option.

  The dialog box displays menu titles for the actions that you configure in a
  list box at the top of the dialog.  For the selected title, the title text
  and associated "Command Format" on page 19  (command) is displayed in entry
  boxes near the bottom of the dialog.  The following actions may be used to
  change your pull-down menu options:

  o   To add a new item to a pull-down menu, Type in the Menu Option text that
         ___
      you would like to appear in the pull-down menu, and specify the "Command
      Format" on page 19  (command) that should be executed when the option is
      selected.  To do this, you may have to replace (over-type) the text that
      is currently displayed in the edit boxes at the bottom of the dialog.
      Press the ADD button to add your new command to the Menu.  The command
                ___
      will be added immediately after the options that is currently selected in
      the list box at the top of the dialog.

  o   To change an existing menu option, select the option in the list box, and
         ______
      change the  menu option title, and associated "Command Format" on page 19
      (command) in the edit boxes at the bottom of the dialog. Press the CHANGE
                                                                         ______
      button to have the menu option changed.

  o   To delete an existing menu option, select the option in the list box, and
         ______
      press the DELETE button.
                ______

  o   The pull-down menus will display the options you specify in the order
      that they appear in the list box at the top of the dialog.  You may
      change the order that these commands appear in by selecting an option in
                 _____
      the list box, and pressing the TO TOP button to move the option to the
                                     ______
      top of the list box.

  Normally, the item you describe will be added to the FILE pull-down menu.
                                                       ____
  You may, however, create your own pull-down menu from the action bar by spec-
  ifying the special character '|' or '_' (underscore) in your menu option
  text.  When the '|' or '_' character is used in menu option text, the text
  specified to the LEFT of the '|' or '_' character is assumed to specify the
  name of the new pull-down menu, and the text to the RIGHT of the '|' or '_'
  character species one of the selections that will be available in the new
  pull-down menu.

  For example, lets assume that you wish to add a new pull-down menu for
  "Editors."  The following entries could be added to the CUSTOM MENU OPTIONS
                                                          ___________________
  dialog to accomplish this:


                                                        Custom Menu Options  47






                                                          IBM ESDTOOLS Use Only


    Menu Option Text          Command to be Executed
    -------------------      -------------------------

    Editors | System Editor   .start e.exe /
    Editors _ EPM Editor      .start epm.exe /

  When these options are saved, a new pull-down menu, EDITORS, will be appear
                                                      _______
  on the Action bar for MrFile/PM.  Selections "System Editor" and "EPM Editor"
  will appear when the EDITORS menu is selected.  Note that the "Editors |"
                       _______
  specification in the menu option text for the two selections must be iden-
  tical so that both selections appear under the same pull-down menu.

  Two special commands may be used to build pull-down menus to change the file
  display mask or change to a certain directory.  The MASK command may be spec-
                                                      ____
  ified on the command line with wildcard characters to change the directory
  mask that is used to display files in the file display window (similar to the
  FILE MASK dialog selectable from the VIEW pull-down menu).  The CD command
                                                                  __
  may be used with a fully-qualified directory name to change MrFile/PM to a
  certain directory.

  Custom pull-down menus that change the file mask and change to specific
  directories can be configured as shown below:

    Menu Option Text          Command to be Executed
    -------------------      -------------------------

    Masks | All Files         mask *
    Masks | Source Code       mask *.c;*.h
    Masks | Executables       mask *.exe;*.com

    Directories _ Root        cd c:\
    Directories _ Accounting  cd D:\finances\acct
    Directories _ System      cd C:\os2\system\

  When these options are configured, two new menu items will be displayed on
  the MrFile/PM action bar: MASKS, and DIRECTORIES.  The MASKS menu will
                            _____      ___________       _____
  display 3 selections that can be selected to alter the file display mask to
  show filenames that match the wildcard patters shown above.  The DIRECTORIES
                                                                   ___________
  menu can be used to change to the directories specified.  Using these two
  commands, you can configure your most often-used file masks and directories
  so they appear as MrFile/PM pull-down menus.

  Once you are finished making your changes, you may press the SAVE button to
                                                               ____
  save the changes and immediately change your FILE pull-down menu.  If you
                                               ____
  decide that you do not want to make the changes, press the CANCEL button to
                                                             ______
  cancel your updates.  The HELP button will display help text for using the
                            ____
  dialog.









  48






  IBM ESDTOOLS Use Only


  FILE/COMMAND ASSOCIATIONS
  _________________________





  The FILE/COMMAND ASSOCIATIONS dialog lets you specify customized "Command
      _________________________
  Format" on page 19 (commands) that should be executed when files matching
  specific patterns are opened (double-clicked on with the mouse, or selected
  when enter is pressed in the file display window).  Select FILE/COMMAND ASSO-
                                                             __________________
  CIATIONS from the PROFILE pull-down menu to get to this option.
  ________          _______

  The dialog box displays file matching patterns in a list box at the top of
  the dialog.  For the selected pattern, the pattern and associated "Command
  Format" on page 19 (command) is displayed in entry boxes near the bottom of
  the dialog.  File patterns use the normal OS/2 convention: '*' matches 0 or
  more characters in a file name, and '?' matches a single character.  To match
  all files, '*.*' would be specified for the pattern.

  The following actions may be used to change your file/command associations:

  o   To add a new file pattern/command association, Type in the file name
         ___
      pattern, and specify the "Command Format" on page 19 (command) that
      should be executed when files matching this pattern are opened.  To do
      this, you may have to replace (over-type) the text that is currently dis-
      played in the edit boxes at the bottom of the dialog.  Press the ADD
                                                                       ___
      button to add your new association.  The command will be added imme-
      diately after the pattern that is currently selected in the list box at
      the top of the dialog.

  o   To change an existing association, select the pattern in the list box,
         ______
      and change the pattern and/or associated "Command Format" on page 19
      (command) in the edit boxes at the bottom of the dialog. Press the CHANGE
                                                                         ______
      button to have the association changed.

  o   To delete an existing association, select the pattern in the list box,
         ______
      and press the DELETE button.
                    ______

| o   When a file is opened, the patterns in the association list are searched
|     from top to bottom;  the first match found specifies the command to be
|     invoked.  Knowing this, you may want to order the list so that more spe-
|     cific patterns appear first, and more general patterns appear near the
|     end of the list ('*.*' at the top of the list would always be matched,
|     ignoring any other patterns you have specified).  To move a pattern to
|     the top of the list, select the pattern and press the TO TOP button.
                                                            ______

  Once you are finished making your changes, you may press the SAVE button to
                                                               ____
  save the changes.   If you decide that you do not want to make the changes,
  press the CANCEL button to cancel your updates.  The HELP button will display
            ______                                     ____
  help text for using the dialog.






                                                  File/Command Associations  49






                                                          IBM ESDTOOLS Use Only


























































  50






  IBM ESDTOOLS Use Only


  DRAG/DROP WINDOW ASSOCIATIONS
  _____________________________





  The DRAG/DROP WINDOW ASSOCIATIONS dialog lets you specify customized "Command
      _____________________________
  Format" on page 19 (commands) that should be executed when files are dropped
  over windows whose titles match the text specified.  With this option, you
  can do things like automatically send file to the host when they are dropped
  over a communications manager 3270 Emulator window. Select DRAG/DROP WINDOW
                                                             ________________
  ASSOCIATIONS from the PROFILE pull-down menu to get to this option.
  ____________          _______

  The dialog box displays window titles in a list box at the top of the dialog.
  For the selected title, the title and associated "Command Format" on page 19
  (command) is displayed in entry boxes near the bottom of the dialog.  The
  Window title does not have to be specified in its entirety - Mr. File/PM will
  ensure that the title specified matches the left-most portion of a window
  title over which files are dropped.

  The following actions may be used to change your drag/drop window associ-
  ations:

  o   To add a new drag/drop window association, Type in the Window Title, and
         ___
      specify the "Command Format" on page 19 (command) that should be executed
      when files are dropped over windows with this title.   To do this, you
      may have to replace (over-type) the text that is currently displayed in
      the edit boxes at the bottom of the dialog.  Press the ADD button to add
                                                             ___
      your new association.  The command will be added immediately after the
      title that is currently selected in the list box at the top of the
      dialog.

  o   To change an existing association, select the title in the list box, and
         ______
      change the title and/or associated "Command Format" on page 19 (command)
      in the edit boxes at the bottom of the dialog. Press the CHANGE button to
                                                               ______
      have the association changed.

  o   To delete an existing association, select the title in the list box, and
         ______
      press the DELETE button.
                ______

  o   When files are dropped over a window, the titles in the association list
      are searched from top to bottom;  the first match found specifies the
      command to be invoked.  Knowing this, you may want to order the list so
      that more specific titles appear first, and more general titles appear
      near the end of the list.  To move a title to the top of the list, select
      the title and press the TO TOP button.
                              ______

  Once you are finished making your changes, you may press the SAVE button to
                                                               ____
  save the changes.   If you decide that you do not want to make the changes,
  press the CANCEL button to cancel your updates.  The HELP button will display
            ______                                     ____
  help text for using the dialog.





                                              Drag/Drop Window Associations  51






                                                          IBM ESDTOOLS Use Only


























































  52






  IBM ESDTOOLS Use Only


| MRFILE/PM (32-BIT) PREFERENCES
  ______________________________





| The Preferences dialog from the PROFILE menu can be used to set the default
      ___________
| file sorting order and the Drag/Drop protocol.  You can decide whether file
| names should be sorted down displayed columns (top-to-bottom) or across dis-
| played rows (left-to-right).

| If the Workplace Shell drag-drop protocol is selected as the default, you may
| interact with other objects on the desktop, or use the configurable drag drop
| by pressing the Alt key before dragging selected file/directories.  When the
                  ___
| Configurable drag/drop protocol is selected, the Alt key must be pressed
                                                   ___
| before a drag operation begins to interact with other Workplace shell objects
| (such as the shredder or printers.

| The configurable drag/drop protocol can be configured, using "Drag/Drop
| Window Associations" on page 51 to perform specific actions when
| files/directories are dropped over certain open windows.  In addition, the
| configurable drag/drop protocol will operate more smoothly when copying or
| moving a large number of files.

































                                             MrFile/PM (32-bit) Preferences  53
[ RETURN TO DIRECTORY ]