OS/2 Professional/OS2PRO194.ISO/os2/wps/disk/spacemap/spacemap.hlp

OS/2 Help File | 1993-11-18 | 94KB | 3,315 lines

ΓòÉΓòÉΓòÉ 1. Help for Directory Window ΓòÉΓòÉΓòÉ

The Directory window displays information about the disk space used by a
specified Parent directory.  This includes data about the directory's disk
drive and child directories.

Fields:

   Parent directory
   Directory list

 Actions:

   Scan
   Stop
   Open
   Files
   Back
   Help


ΓòÉΓòÉΓòÉ 2. Help for Parent Directory ΓòÉΓòÉΓòÉ

Use this field to specify the drive, path, and name of the directory to be
scanned.

For example:

   C:\
   C:\SALES
   C:\SALES\NOV93
   C:\SALES\NOV93\JOHNSON


ΓòÉΓòÉΓòÉ 3. Help for Directory List ΓòÉΓòÉΓòÉ

SpaceMap displays the results of the most recent scan of the Parent Directory
in this field.  Each entry in the list is an immediate child directory of the
parent.  There may also be an entry named "<PARENT>" which reports the space
used by the Parent Directory itself.

Columns:

   Bytes allocated
   Directory
   Relative size


ΓòÉΓòÉΓòÉ 4. Help for Bytes Allocated Column ΓòÉΓòÉΓòÉ

This column contains the total number of bytes allocated  (plus the the total
bytes used for Extended Attributes)  for each directory in the list.  This
number is the sum of space usage for all files and directory pointers  in a
directory and in all of its descendent directories.


ΓòÉΓòÉΓòÉ 5. Help for Directory Column ΓòÉΓòÉΓòÉ

This column contains the name of the directory for each entry in the list.  If
the name is preceded by the symbol '' this means that the directory has child
directories and can therefore be 'opened'.  If the name is preceded by the
symbol '*' this means that the directory has been erased or moved and that a
re-scan has not yet been done.


ΓòÉΓòÉΓòÉ 6. Help for Relative Size Column ΓòÉΓòÉΓòÉ

This column contains two parts:  a number and a bar.  The number is a
percentage representing how much of the total space is used by each directory
in the list.  Total space can be either the sum of all space in the directory
list ('per scan') or the total space capacity of the disk drive ('per disk').

The bar is a graphical representation of the 'per scan' value (even if the
number is 'per disk').  The length of the bar is relative to the directory
entry with the largest size (i.e. bytes allocated) in the list.


ΓòÉΓòÉΓòÉ 7. Help for Scan ΓòÉΓòÉΓòÉ

Select Scan to search the directory tree (starting at the Parent Directory).
This action will replace the currently displayed Directory List with a new
list.  The new list will contain the immediate child directories of the
specified Parent Directory.  Also, the disk drive statistics will be updated.


ΓòÉΓòÉΓòÉ 8. Help for Stop ΓòÉΓòÉΓòÉ

Select Stop to terminate the disk drive scan operation which is currently being
executed.


ΓòÉΓòÉΓòÉ 9. Help for Back ΓòÉΓòÉΓòÉ

Select Back to move 'up' the directory tree to the previous level (i.e. the
parent directory of the current Parent Directory).  If the information for the
previous level is not available, an implicit 'scan' command is issued for the
new Parent Directory value.


ΓòÉΓòÉΓòÉ 10. Help for Help ΓòÉΓòÉΓòÉ

Select Help to view information describing the Directory Window and its fields
and buttons.


ΓòÉΓòÉΓòÉ 11. Help for Save ΓòÉΓòÉΓòÉ

Select Save to write a copy of the current directory list to the file name you
previously specified using the Save as selection.

Any parameters you specified in the Save as selection will continue to be in
effect for this selection.  However, the 'duplicate file name' parameter will
always default to Replace.


ΓòÉΓòÉΓòÉ 12. Help for Save As ΓòÉΓòÉΓòÉ

Select Save as to write a copy of the current directory list to a specified
file.  A pop-up window will be displayed to allow you to specify the file name
and other parameters.


ΓòÉΓòÉΓòÉ 13. Help for Print ΓòÉΓòÉΓòÉ

Select Print to send a report containing the current directory list to the LPT1
printer.

This report will follow the current 'size' and 'sort' rules for the directory
list.


ΓòÉΓòÉΓòÉ 14. Help for Exit ΓòÉΓòÉΓòÉ

Select Exit to terminate the SpaceMap program.  If you chose to set defaults at
any time during the session, those defaults will be written to the SPACEMAP.INI
file at this time.


ΓòÉΓòÉΓòÉ 15. Help for Open ΓòÉΓòÉΓòÉ

Select Open to display a list of the immediate child directories for the
selected directory.


ΓòÉΓòÉΓòÉ 16. Help for Files ΓòÉΓòÉΓòÉ

Select Files to display the Files Window containing the list of files in the
selected directory.


ΓòÉΓòÉΓòÉ 17. Help for Copy ΓòÉΓòÉΓòÉ

Select Copy to make a duplicate of the contents of the selected directory in a
specified target directory.  The target directory can be on the current disk
drive or on a different one.  Both the source directory's files and its
descedent directories (and their files) will be copied.  A pop-up window will
be displayed to allow you to specify the target directory and other parameters.


ΓòÉΓòÉΓòÉ 18. Help for Move ΓòÉΓòÉΓòÉ

Select Move to transfer the contents of the selected directory to a specified
target directory.  The target directory can be on the current disk drive or on
a different one.  Both the source directory's files and its descendent
directories (and their files) will be moved.  If all the contents of the source
directory are successfully moved, then the directory itself will be deleted.  A
pop-up window will be displayed to allow you to specify the target directory
and other parameters.


ΓòÉΓòÉΓòÉ 19. Help for Erase ΓòÉΓòÉΓòÉ

Select Erase to delete the contents of the selected directory from the current
disk drive.  Both the directory's files and its descendent directories (and
their files) will be deleted.  If all the contents of the directory are
successfully deleted, then the directory itself will be deleted.  A pop-up
window will be displayed to allow you to specify the parameters for this
action.


ΓòÉΓòÉΓòÉ 20. Help for Cut ΓòÉΓòÉΓòÉ

Select Cut to remove the selected text block from the Parent Directory field
and place the block into the OS/2 clipboard.


ΓòÉΓòÉΓòÉ 21. Help for Copy ΓòÉΓòÉΓòÉ

Select Copy to make a duplicate of the selected text block from the Parent
Directory field and place the block into the OS/2 clipboard.


ΓòÉΓòÉΓòÉ 22. Help for Paste ΓòÉΓòÉΓòÉ

Select Paste to insert the contents of the OS/2 clipboard into the text in the
Parent Directory field at the cursor position.


ΓòÉΓòÉΓòÉ 23. Help for Clear ΓòÉΓòÉΓòÉ

Select Clear to remove the selected text block from the Parent Directory field.


ΓòÉΓòÉΓòÉ 24. Help for Criteria ΓòÉΓòÉΓòÉ

Select Criteria to specify the file search parameters for the scan operation.
A pop-up window will be displayed to allow you to specify the parameters for
the scan.  If a previous scan has been done using the old parameters, then an
implicit scan command will be issued after you specify the new parameters.


ΓòÉΓòÉΓòÉ 25. Help for Size Relative To ΓòÉΓòÉΓòÉ

Select Size relative to to specify the method used to compute the number
displayed in the Relative Size column of the Directory List.


ΓòÉΓòÉΓòÉ 26. Help for Total Bytes Scanned ΓòÉΓòÉΓòÉ

Select Total bytes scanned to base the the number displayed in the Relative
Size column of the Directory List on the sum of the Bytes Allocated column.


ΓòÉΓòÉΓòÉ 27. Help for Total Bytes On Disk ΓòÉΓòÉΓòÉ

Select Total bytes on disk to base the the number displayed in the Relative
Size column of the Directory List on the total storage capacity of the disk
drive.


ΓòÉΓòÉΓòÉ 28. Help for Sort By ΓòÉΓòÉΓòÉ

Select Sort by to specify the method used to order the entries in the Directory
List.


ΓòÉΓòÉΓòÉ 29. Help for Name ΓòÉΓòÉΓòÉ

Select Name to order the entries in the Directory List in ascending sequence by
the Directory column.


ΓòÉΓòÉΓòÉ 30. Help for Size (ascending) ΓòÉΓòÉΓòÉ

Select Size (ascending) to order the entries in the Directory List in ascending
sequence by the Bytes Allocated column.


ΓòÉΓòÉΓòÉ 31. Help for Size (descending) ΓòÉΓòÉΓòÉ

Select Size (descending) to order the entries in the Directory List in
descending sequence by the Bytes Allocated column.


ΓòÉΓòÉΓòÉ 32. Help for Set Defaults ΓòÉΓòÉΓòÉ

Select Set defaults to make the current view parameters (criteria, size, and
sort) the default values for program initialization. These new default values
will be saved to the SPACEMAP.INI file on disk at the end of this session.


ΓòÉΓòÉΓòÉ 33. Help for Load ΓòÉΓòÉΓòÉ

Select Load to replace the current view settings (criteria, size, sort, etc.)
with a new group of settings stored in a specified file on disk.  This file was
previously created using the Save or Save as selections.  A pop-up window will
be displayed to allow you to specify the file name and other parameters.


ΓòÉΓòÉΓòÉ 34. Help for Save ΓòÉΓòÉΓòÉ

Select Save to write a copy of the current view settings (criteria, size, sort,
etc.) to the file name you previously specified using the Save as selection.
At a later time, you can restore these view settings by selecting Load and
specifying the file name to be loaded.

Any parameters you specified in the Save as selection will continue to be in
effect for this selection.  However, the 'duplicate file name' parameter will
always default to Replace.


ΓòÉΓòÉΓòÉ 35. Help for Save As ΓòÉΓòÉΓòÉ

Select Save as to write a copy of the current view settings (criteria, size,
sort, etc.) to a specified file.  A pop-up window will be displayed to allow
you to specify the file name and other parameters.  At a later time, you can
restore these view settings by selecting Load and specifying the file name to
be loaded.


ΓòÉΓòÉΓòÉ 36. Help for Auto Re-scan When Needed ΓòÉΓòÉΓòÉ

Select Auto re-scan when needed to indicate that an implicit scan command
should be issued whenever SpaceMap becomes aware of the fact the contents of
the Directory Window need to be refreshed.  This selection is a toggle switch
that can be either in the checkmarked ('on' state) or in the not checkmarked
('off' state).  If this selection is 'off', then you are responsible for
issuing a scan command manually whenever one is needed.


ΓòÉΓòÉΓòÉ 37. Help for Confirm Copy, Move, Erase ΓòÉΓòÉΓòÉ

Select Confirm copy, move, erase to indicate that requests to copy, move, or
erase a directory should be confirmed via a pop-up window before being
executed.  This selection is a toggle switch that can be either in the
checkmarked ('on' state) or in the not checkmarked ('off' state).  If this
selection is 'off', then the copy, move, or erase action will be carried out
immediately.  This is the rough equivalent of driving a car without your seat
belt buckled.  Do so at your own risk.


ΓòÉΓòÉΓòÉ 38. Help for Use Warning Beeps ΓòÉΓòÉΓòÉ

Select Use warning beeps to indicate that SpaceMap should make various sounds
on your computer's speaker to notify you of critical events, error conditions,
or other problems.  This selection is a toggle switch that can be either in the
checkmarked ('on' state) or in the not checkmarked ('off' state).  If this
selection is 'off', then no warning beeps are made.  Note that turning this
selection 'off' will not eliminate ALL beeps make by SpaceMap.  Some sounds are
automatically make by OS/2 whenever an application program takes certain
actions.  To turn off sound in these instances, change the system defaults.


ΓòÉΓòÉΓòÉ 39. Help for Set Defaults ΓòÉΓòÉΓòÉ

Select Set defaults to make the current options the default values for program
initialization.  These new default values will be saved to the SPACEMAP.INI
file on disk at the end of this session.


ΓòÉΓòÉΓòÉ 40. Help for Editor ΓòÉΓòÉΓòÉ

Select Editor to specify an editor program to be used by the Files Window
whenever you make the Edit selection for a selected file.  Selecting Editor
will cause a pop-up window to be displayed to allow you to specify the editor
file name and other parameters.


ΓòÉΓòÉΓòÉ 41. Help for Help Index ΓòÉΓòÉΓòÉ

Select Help index to display a pop-up window containing a list of topics
covered by SpaceMap's help facility.  Selecting a topic from this list will
display the appropriate help text.


ΓòÉΓòÉΓòÉ 42. Help for General Help ΓòÉΓòÉΓòÉ

Select General help to display a pop-up window containing a descriptive
overview of the SpaceMap program.


ΓòÉΓòÉΓòÉ 43. Help for Using Help ΓòÉΓòÉΓòÉ

Select Using help to display a pop-up window containing information about how
to use the Help Facility.


ΓòÉΓòÉΓòÉ 44. Help for Keys Help ΓòÉΓòÉΓòÉ

Select Keys help to display a pop-up window containing a information about
various accelerator keys you can use to speed up interaction with the Directory
Window.


ΓòÉΓòÉΓòÉ 45. Help for Tutorial ΓòÉΓòÉΓòÉ

Select Tutorial to start the SpaceMap Tutorial program. This program allows you
to explore SpaceMap's functions using a built-in 'imaginary' disk drive.  A set
of lessons for the tutorial can be printed once the program is started.  Note
that when the tutorial program starts, the real SpaceMap program will be hidden
from view.  When you exit the Tutorial Program, the real SpaceMap program will
re-appear.


ΓòÉΓòÉΓòÉ 46. Help for Product Information ΓòÉΓòÉΓòÉ

Select Product information to display a pop-up window containing various
notices about the program.  Among these notices are the name and telephone
number of the software vendor, the copyright statement, and the version number.


ΓòÉΓòÉΓòÉ 47. Help for License Agreement ΓòÉΓòÉΓòÉ

Select License agreement to display a pop-up window containing the software
license agreement for this product.


ΓòÉΓòÉΓòÉ 48. Help for SpaceMap ΓòÉΓòÉΓòÉ

SpaceMap is a utility program which allows you to analyze and manage disk space
usage at the directory and file level.  It also provides facilities for
directory tree navigation, file search, and file management.

Any disk drive attached to an OS/2 workstation can be analyzed and manipulated.
This includes LAN drives which appear as normal OS/2 drives via the LAN
re-director.  Supported disk drive formats include FAT (old DOS format), HPFS,
and CD-ROM.

SpaceMap has two primary windows:  the Directory Window and the File Window.

The Directory Window scans a disk drive and displays a list of child
directories for a specified parent directory.  Each entry in the list contains
a number which is the sum of all space used by that child directory AND its
descendent directories.  Directories in the list can be copied, moved, or
erased.

Summary information about the latest 'scan' operation and about the disk drive
as a whole are also displayed.

If an entry in the list has child directories itself, a list of those
directories and their space usage can be displayed replacing the current list.
The former child directory now becomes the parent.  In this way you can dig
down into a directory tree (one level at a time) to see how space usage is
distributed at each level.  You can then back up (one level at a time) until
you have returned to the original parent directory and its child list.

The Directory Window also provides you with a powerful file search facility
which lets you 'filter in' and/or 'filter out' space used by certain type of
files.  Copying, moving, and erasing directories can be made to apply only to
files meeting the current search criteria, if desired.  For example, on an HPFS
drive you could move all files with a .DAT extension which have not been
accessed in the last 90 days to a different disk drive (retaining their
original directory structure).

The second primary window in Spacemap, the File Window, displays a list of
files contained in a directory selected from the directory list.  Only files
meeting the current search criteria are displayed.  The File Window 'pops up'
over the Directory Window.  The Directory Window cannot generally be used until
you close the File Window.

Entries in the file list can be edited with a user-specified editor program.

Also, one or more files can be 'marked'.  Copy, move, and erase operations can
then be performed on the 'marked' files only.

In summary, by using the Directory and File Windows you can search a disk drive
vertically and horizontally.  You can look at a filtered view of drive's
contents.  You can edit, copy, move, or erased those contents until you have
achieved your goal of reducing space usage on the drive.


ΓòÉΓòÉΓòÉ 49. Help for Keys ΓòÉΓòÉΓòÉ

The following table list the special key assignments used by the Directory
Window.

 Key             Command
 Double-click    Open
 Escape          Back
 B               Back
 F               Files
 O               Open
 S               Scan
 T               Stop
 F2              Save directory list
 F3              Exit
 F5              Print directory list
 F7              Save View
 Sh+Ins          Paste text block
 Sh+Del          Cut text block
 Ctrl+Ins        Copy text block
 Ctrl+Del        Clear text block
 Ctrl+E          Erase directory
 Ctrl+M          Move directory
 Ctrl+R          View criteria
 Ctrl+Y          Copy directory
 Alt+A           Sort by size (asc)
 Alt+D           Sort by size (desc)
 Alt+K           Size per disk
 Alt+N           Sort by name
 Alt+S           Size per scanned


ΓòÉΓòÉΓòÉ 50. Help for Product Info ΓòÉΓòÉΓòÉ

SpaceMap for OS/2 - Demo Edition

Version 1.00

(C) Copyright 1993 Capstone Software, Inc.

Address:  Capstone Software, Inc.
      P.O. Box 416
      Carmel, IN  46032

 Phone:  [phone] (inside  USA)

      [phone] (outside USA)

OS/2 is a trademark of
International Business Machines Corp.


ΓòÉΓòÉΓòÉ 51. License Agreement ΓòÉΓòÉΓòÉ

Capstone Software, Inc.

Software License Agreement

1. Introduction

The enclosed diskette contains a copyrighted software program ("the Program")
which is licensed, not sold.  This document is a license agreement between
Capstone Software, Inc. ("Capstone") and the licensee of this product ("you").
By opening the envelope containing the Program diskette(s), you accept the
terms of this agreement.  If you do not accept this agreement, immediately
return the diskette envelope, unopened, along with all accompanying materials
to Capstone.

2. Grant of License

Capstone grants you the right to use the enclosed Program on multiple computers
at multiple locations.  The Program may be used by more than one person at a
time.

3. Copyright

The Program is owned by Capstone and is protected by United States copyright
laws and international treaty provisions.  Therefore, you must treat the
Program like any other copyrighted material (e.g., a book or musical recording)
except that you may (a) make multiple copies of the Program provided you
duplicate the diskette label(s) - including the copyright notice - for each
copy, and (b) transfer the Program to multiple hard disks for usage purposes.
Subject to these two exceptions you may not reproduce, copy, or in any other
way duplicate the Program without the prior express written consent of
Capstone.

4. Other Restrictions

You may not rent or lease the Program, but you may transfer copies of the
Program on a permanent basis provided you follow the copyright provisions
above, and provide the recipient with a copy of this agreement. Also, you may
not reverse engineer, decompile, or disassemble the Program.

5. No Warranty

The Program and accompanying materials are licensed "AS IS" without warranty as
to their performance, merchantability, or fitness for any particular purpose.
The entire risk as to the results, consequences, and performance of the Program
is assumed by you.

In no event will Capstone be liable to you for damages, including any loss of
profits, lost savings, or other incidental or consequential damages arising out
of your use of or inability to use the Program, even if Capstone or an
authorized Capstone representative has been advised of the possibility of such
damages.

Capstone recommends that you backup your data to removeable media on a daily
basis.  The Program should never be used on data which cannot be readily
recovered from a backup copy.

6. Customer Support

Capstone will attempt to answer your technical support requests concerning the
Program.  However, this service is offered on a reasonable efforts basis only,
and Capstone may not be able to resolve every support request.

7. Governing Rules

If any provision of this agreement is found to be unlawful, void, or
unenforceable, then that provision shall be severed from this agreement and
will not affect the validity and enforceability of any of the remaining
provisions.  This agreement shall be governed by the laws of the State of
Indiana.

8. Violation of Contract

In the event that you violate any of the provisions of this agreement, Capstone
will be entitled to receive from you and you will pay the full amount of any
damages Capstone suffers by virtue of such violation, together with all
attorneys fees and costs Capstone incurs in prosecuting its claims resulting
from such violation(s).

9. Termination of License

If you violate any provision of this agreement this license shall immediately
terminate, whereupon you shall cease all use of the Program and either ship to
Capstone, permanently erase, or destroy all diskettes in your possession
containing copies or translations of the Program.

10. Entire Agreement

This Agreement constitutes the entire agreement between you and Capstone and
supersedes all prior understandings or representations by the parties in
respect to the Program.

11. Any Questions

If you have any questions concerning the terms of this agreement, please write
to:

   Capstone Software, Inc.
   P.O. Box 416
   Carmel, IN  46032

or call 1-800-500-2244 (inside the USA)

    [phone] (outside the USA)


ΓòÉΓòÉΓòÉ 52. Help for File Window ΓòÉΓòÉΓòÉ

The File window displays information about the disk space used by the files
contained in a specified directory.

Fields:

   File list

 Actions:

   Close
   Edit
   Mark
   Help


ΓòÉΓòÉΓòÉ 53. Help for File List ΓòÉΓòÉΓòÉ

SpaceMap displays the results of the most recent scan of the contents of a
specified directory in this field.  Each entry in the list is either a file or
a directory pointer contained in the specified directory.

Columns:

   Bytes allocated
   File
   Date
   Attributes


ΓòÉΓòÉΓòÉ 54. Help for Bytes Allocated Column ΓòÉΓòÉΓòÉ

This column contains the number of bytes allocated (plus the bytes used for
Extended Attributes) for each file (or directory pointer) in the list.


ΓòÉΓòÉΓòÉ 55. Help for File Column ΓòÉΓòÉΓòÉ

This column contains the name of the file (or directory pointer)  for each
entry in the list.  If the name is enclosed in '<' and '>'  symbols this means
that the entry is a directory pointer.  If the name is preceded by the symbol
''  this means that the entry can be edited via the user-specified editor
program and can also be 'marked'.  If the name is preceded by the symbol 'Γûê'
this means that the entry is 'marked'.  If an entry is both editable and
marked, then it will be preceded by both symbols.


ΓòÉΓòÉΓòÉ 56. Help for Date Column ΓòÉΓòÉΓòÉ

This column contains one of three dates (Creation, Last Access, or Last Write)
for each file (or directory pointer)  in the list.  Creation date is the date
the file first came into being on your disk drive.  Last Access date is the
date of the most recent use of this file by any program for 'read' (but not
'write') purposes.  Last Write date is the date of the most recent use of this
file by any program for 'write' purposes.

Note:  These three dates bear no particular relation to each other.  A file
could be created on drive C: on January 1, read on February 1, and changed on
March 1. In this case Last Access Date would be less than Last Write Date.  If
the file were then copied to Drive D: on April 1, its Creation Date(April 1)
would be greater than its Last Write Date(March 1).  Thus, if you want to find
all files which have not been touched (in any way) since a given date, you must
check both Last Access Date and Last Write Date.


ΓòÉΓòÉΓòÉ 57. Help for Attributes Column ΓòÉΓòÉΓòÉ

This column contains four attribute indicators which describe the access
characteristics of each file (or directory pointer).  Each indicator is either
a letter or the symbol '-'.  A letter shows that the attribute is 'on' while a
'-' shows that it is 'off'.  The indicators appear in a fix order as listed
below:

 Letter      Description
 S           System
 H           Hidden
 R           Read-only
 A           Needs to be archived


ΓòÉΓòÉΓòÉ 58. Help for Close ΓòÉΓòÉΓòÉ

Select Close to terminate the File Window and return to the Directory Window.


ΓòÉΓòÉΓòÉ 59. Help for Help ΓòÉΓòÉΓòÉ

Select Help to view information describing the File Window and its fields and
buttons.


ΓòÉΓòÉΓòÉ 60. Help for Save ΓòÉΓòÉΓòÉ

Select Save to write a copy of the current file list to the file name you
previously specified using the Save as selection.

Any parameters you specified in the Save as selection will continue to be in
effect for this selection.  However, the 'duplicate file name' parameter will
always default to Replace.


ΓòÉΓòÉΓòÉ 61. Help for Save As ΓòÉΓòÉΓòÉ

Select Save as to write a copy of the current file list to a specified file.  A
pop-up window will be displayed to allow you to specify the file name and other
parameters.


ΓòÉΓòÉΓòÉ 62. Help for Print ΓòÉΓòÉΓòÉ

Select Print to send a report containing the current file list to the LPT1
printer.

This report will follow the current 'date' and 'sort' rules for the file list.


ΓòÉΓòÉΓòÉ 63. Help for Edit ΓòÉΓòÉΓòÉ

Select Edit to invoke the user-specified editor program on the selected file.
Note that only files (and not  directory pointers)  can be edited.  An editable
entry in the File List is preceded by the symbol ''.


ΓòÉΓòÉΓòÉ 64. Help for Sum ΓòÉΓòÉΓòÉ

Select Sum to display a pop-up window containing the total amount of space used
by all marked files in the list.


ΓòÉΓòÉΓòÉ 65. Help for Print ΓòÉΓòÉΓòÉ

Select Print to send a report containing the names (and other information) for
all marked files in the list to the LPT1 printer.

This report will follow the current 'date' and 'sort' rules for the file list.


ΓòÉΓòÉΓòÉ 66. Help for Copy ΓòÉΓòÉΓòÉ

Select Copy to make a duplicate of all marked files in the list and place them
in a specified target directory.  The target directory can be on the current
disk drive or on a different one.  A pop-up window will be displayed to allow
you to specify the target directory and other parameters.


ΓòÉΓòÉΓòÉ 67. Help for Move ΓòÉΓòÉΓòÉ

Select Move to transfer all marked files in the list to to a specified target
directory.  The target directory can be on the current disk drive or on a
different one.  A pop-up window will be displayed to allow you to specify the
target directory and other parameters.


ΓòÉΓòÉΓòÉ 68. Help for Erase ΓòÉΓòÉΓòÉ

Select Erase to delete all marked files in the list.  A pop-up window will be
displayed to allow you to specify the parameters for this action.


ΓòÉΓòÉΓòÉ 69. Help for Mark/Unmark ΓòÉΓòÉΓòÉ

Select Mark/Unmark to place an entry in the list into the 'marked' state.  Only
files can be marked, not directory pointers.  A markable entry in the File List
is preceded by the symbol ''.

This action is a toggle switch.  If a file is 'marked' and you select this
action, then the file becomes 'unmarked'.  If a file is 'unmarked' and you
select this action, then the file becomes 'marked'.  Marked files are indicated
by the presence of a 'Γûê' symbol preceding their name.


ΓòÉΓòÉΓòÉ 70. Help for Mark All ΓòÉΓòÉΓòÉ

Select Mark all to place all file entries in the list into the 'marked' state.
Only files will be marked, not directory pointers.  Marked files are indicated
by the presence of a 'Γûê'  symbol preceding their name.


ΓòÉΓòÉΓòÉ 71. Help for Unmark All ΓòÉΓòÉΓòÉ

Select Unmark all to place all file entries in the list into the 'unmarked'
state.  Marked files are indicated by the presence of a 'Γûê' symbol preceding
their name.  Unmarked files are indicated by the absence of such a symbol.


ΓòÉΓòÉΓòÉ 72. Help for Date ΓòÉΓòÉΓòÉ

Select Date to specify which file date to display in the date column of the
File List.


ΓòÉΓòÉΓòÉ 73. Help for Creation ΓòÉΓòÉΓòÉ

Select Creation to display each file's Creation date in the date column of the
File List.


ΓòÉΓòÉΓòÉ 74. Help for Last Access ΓòÉΓòÉΓòÉ

Select Last access to display each file's Last Access date in the date column
of the File List.


ΓòÉΓòÉΓòÉ 75. Help for Last Write ΓòÉΓòÉΓòÉ

Select Last write to display each file's Last Write date in the date column of
the File List.


ΓòÉΓòÉΓòÉ 76. Help for Sort By ΓòÉΓòÉΓòÉ

Select Sort by to specify the method used to order the entries in the File
List.


ΓòÉΓòÉΓòÉ 77. Help for Date (ascending) ΓòÉΓòÉΓòÉ

Select Date (ascending) to order the entries in the File List in ascending
sequence by the Date column.


ΓòÉΓòÉΓòÉ 78. Help for Date (descending) ΓòÉΓòÉΓòÉ

Select Date (descending) to order the entries in the File List in descending
sequence by the Date column.


ΓòÉΓòÉΓòÉ 79. Help for Name ΓòÉΓòÉΓòÉ

Select Name to order the entries in the File List in ascending sequence by the
File column.


ΓòÉΓòÉΓòÉ 80. Help for Size (ascending) ΓòÉΓòÉΓòÉ

Select Size (ascending) to order the entries in the File List in ascending
sequence by the Bytes Allocated column.


ΓòÉΓòÉΓòÉ 81. Help for Size (descending) ΓòÉΓòÉΓòÉ

Select Size (descending) to order the entries in the File List in descending
sequence by the Bytes Allocated column.


ΓòÉΓòÉΓòÉ 82. Help for Set Defaults ΓòÉΓòÉΓòÉ

Select Set defaults to make the current view parameters (date and sort) the
default values for program initialization.  These new default values will be
saved to the SPACEMAP.INI file on disk at the end of this session.


ΓòÉΓòÉΓòÉ 83. Help for Help Index ΓòÉΓòÉΓòÉ

Select Help index to display a pop-up window containing a list of topics
covered by SpaceMap's help facility.  Selecting a topic from this list will
display the appropriate help text.


ΓòÉΓòÉΓòÉ 84. Help for Using Help ΓòÉΓòÉΓòÉ

Select Using help to display a pop-up window containing information about how
to use the Help Facility.


ΓòÉΓòÉΓòÉ 85. Help for Keys Help ΓòÉΓòÉΓòÉ

Select Keys help to display a pop-up window containing a information about
various accelerator keys you can use to speed up interaction with the File
Window.


ΓòÉΓòÉΓòÉ 86. Help for Keys ΓòÉΓòÉΓòÉ

The following table list the special key assignments used by the File Window.

 Key             Command
 Double-click    Edit
 Escape          Close
 C               Close
 E               Edit
 M               Mark/Unmark
 F2              Save file list
 F4              Print marked file list
 F5              Print file list
 Ctrl+A          Mark all files
 Ctrl+E          Erase marked files
 Ctrl+M          Move marked files
 Ctrl+S          Sum marked files
 Ctrl+U          Unmark all files
 Ctrl+Y          Copy marked files
 Alt+A           Sort by size (asc)
 Alt+C           Show creation date
 Alt+D           Sort by size (desc)
 Alt+E           Sort by date (desc)
 Alt+L           Show last access date
 Alt+N           Sort by name
 Alt+S           Sort by date (asc)
 Alt+W           Show last write date


ΓòÉΓòÉΓòÉ 87. Help for Copy Directory Window ΓòÉΓòÉΓòÉ

The Copy Directory pop-up window allows you to copy the selected directory and
all of its descendents to a specified target directory.

Fields:

   Source directory
   Target directory
   If target does not exist
   What kind of files to copy
   If file already exists
   If EA's not supported

 Actions:

   Copy
   Stop
   Cancel
   Help


ΓòÉΓòÉΓòÉ 88. Help for Source Directory ΓòÉΓòÉΓòÉ

SpaceMap displays the drive, path, and name of the source directory in this
field.

For example:

   C:\
   C:\OS2\APPS
   C:\OS2\APPS\DLL


ΓòÉΓòÉΓòÉ 89. Help for Target Directory ΓòÉΓòÉΓòÉ

Use this field to specify the drive, path, and name of the target directory.

For example:

   C:\
   C:\SALES
   C:\SALES\NOV93
   C:\SALES\NOV93\JOHNSON


ΓòÉΓòÉΓòÉ 90. Help for If Target Does Not Exist ΓòÉΓòÉΓòÉ

Use this field to specify the action to take if the target directory does not
exist.  This action also applies to child directories of the source which do
not exist on the target.

Select Create it to create the target directory before copying the contents of
the source directory into it.

Select Don't copy to terminate the copy operation if the primary target
directory is the one that is missing.  If the missing target directory is a
child directory, then it will be skipped over, and the operation will continue
with the next child directory.


ΓòÉΓòÉΓòÉ 91. Help for What Kind of Files To Copy ΓòÉΓòÉΓòÉ

Use this field to specify the type of files that should be copied from the
source directory to the target directory.

Select Files matching View Criteria only to copy only files whose
characteristics match the specified file search criteria.  Note: this is a very
powerful feature which allows you, for example, to copy only .DAT files which
have not been accessed in the last 90 days.

Select All files to copy the entire contents of the source directory regardless
of the current file search criteria.


ΓòÉΓòÉΓòÉ 92. Help for If File Already Exists ΓòÉΓòÉΓòÉ

Use this field to specify the action to take if a file already exists in the
target directory.  This action also applies if a file in one of the source
child directories already exists in its counterpart child directory on the
target.

Select Inquire to cause a Duplicate File Name on Target pop-up window to be
displayed whenever a duplicate file situation arises.  You can specify in this
window the action to take for the particular duplicate file involved. Actions
available include:  rename, replace, append, skip, and quit.

Select Replace to cause the duplicate file on the target to be automatically
replaced by the source file.

If a file name compression occurs and a duplicate situation arises as a result,
then Replace is automatically converted into Inquire for the rest of the files
in that directory.  The same thing happens for a file name expansion which
results in a duplicate situation.

If a directory name compression occurs and a duplicate situation arises as a
result, then Replace is automatically converted into Inquire for the rest of
directories in the current copy operation.  Also, Duplicate Directory Name on
Target pop-up window is displayed.  You can specify in this window the action
to take for the particular duplicate directory involved. Actions available
include:  rename, accept, skip, and quit.

Select Append to cause the duplicate file on the source to be automatically
added on to the end of the target file.  Append follows the same rules as
Replace in cases involving file or directory name compression or expansion
which result in a duplicate situation.

Select Don't copy to cause the file in question to be skipped over.  The copy
operation will continue with the next file in the source directory.

If you have selected Replace or Append, then two sub-options become available
to you:

     Select Even if target System attribute is 'On' to cause the 'replace' or
     'append' action to be carried out even in cases where the duplicate target
     file is a 'system' file.

     Select Even if target Read-only attribute is 'On'  to cause the 'replace'
     or 'append' action to be carried out even in cases where the duplicate
     target file is a 'read-only' file.


ΓòÉΓòÉΓòÉ 93. Help for If EA's Not Supported ΓòÉΓòÉΓòÉ

Use this field to specify the action to take if the source file has Extended
Attributes, but the target drive does not support them.

Select Copy anyway to continue with the copy operation. The file will be
copied, but not its Extended Attributes.

Select Don't copy to skip this file and continue the copy operation with the
next file.


ΓòÉΓòÉΓòÉ 94. Help for Copy ΓòÉΓòÉΓòÉ

Select Copy to start the copy operation.


ΓòÉΓòÉΓòÉ 95. Help for Stop ΓòÉΓòÉΓòÉ

Select Stop to terminate a copy operation which is in-progress.


ΓòÉΓòÉΓòÉ 96. Help for Cancel ΓòÉΓòÉΓòÉ

Select Cancel to close the pop-up window.  This will not alter whatever copy
action you may or may not have taken so far.


ΓòÉΓòÉΓòÉ 97. Help for Help ΓòÉΓòÉΓòÉ

Select Help to view information describing the Copy Directory pop-up window and
its fields and buttons.


ΓòÉΓòÉΓòÉ 98. Help for Duplicate File Name ΓòÉΓòÉΓòÉ

The Duplicate File Name on Target pop-up window allows you to specify the
action to take whenever a duplicate file situation arises during a directory
copy or move operation.

Fields:

   Source path
   Target path
   Source file
   Target file
   Target file attributes
   New target name

 Actions:

   Rename
   Replace
   Append
   Skip
   Quit
   Help


ΓòÉΓòÉΓòÉ 99. Help for Source Path ΓòÉΓòÉΓòÉ

SpaceMap displays the drive, path, and name of the source directory in this
field.


ΓòÉΓòÉΓòÉ 100. Help for Target Path ΓòÉΓòÉΓòÉ

SpaceMap displays the drive, path, and name of the target directory in this
field.


ΓòÉΓòÉΓòÉ 101. Help for Source File ΓòÉΓòÉΓòÉ

SpaceMap displays the source file name in this field.


ΓòÉΓòÉΓòÉ 102. Help for Target File ΓòÉΓòÉΓòÉ

SpaceMap displays the target file name in this field.


ΓòÉΓòÉΓòÉ 103. Help for Target File Attributes ΓòÉΓòÉΓòÉ

SpaceMap displays the target file attributes in this field.  If you choose the
Replace or Append actions, then these operations will be carried out even if
the target file attributes are System or Read-only.  This field is displayed so
that you can make the decision to override these two attributes on a
case-by-case basis.


ΓòÉΓòÉΓòÉ 104. Help for New Target File ΓòÉΓòÉΓòÉ

Use this field to specify the new target file name in the case where you are
going to select the Rename action.  If this new name turns out to be a
duplicate also, then you will be notified and given another chance to respond
to the original duplicate name situation.


ΓòÉΓòÉΓòÉ 105. Help for Rename ΓòÉΓòÉΓòÉ

Select Rename to start the rename operation.  The source file will be called by
the new name in the target directory.


ΓòÉΓòÉΓòÉ 106. Help for Replace ΓòÉΓòÉΓòÉ

Select Replace to start the replace operation.  The existing target file will
be overwritten by the source file.


ΓòÉΓòÉΓòÉ 107. Help for Append ΓòÉΓòÉΓòÉ

Select Append to start the append operation.  The source file will be added
onto the end of the existing target file.


ΓòÉΓòÉΓòÉ 108. Help for Skip ΓòÉΓòÉΓòÉ

Select Skip to ignore the current source file and continue the current copy or
move operation with the next source file.


ΓòÉΓòÉΓòÉ 109. Help for Quit ΓòÉΓòÉΓòÉ

Select Quit to terminate the entire copy or move operation.


ΓòÉΓòÉΓòÉ 110. Help for Help ΓòÉΓòÉΓòÉ

Select Help to view information describing the Duplicate File Name on Target
pop-up window and its fields and buttons.


ΓòÉΓòÉΓòÉ 111. Help for Duplicate Directory Name ΓòÉΓòÉΓòÉ

The Duplicate Directory Name on Target pop-up window allows you to specify the
action to take whenever a duplicate directory situation arises after name
compression during a directory copy or move operation.

Fields:

   Source path
   Target path
   Source directory
   Target directory
   New target name

 Actions:

   Rename
   Accept
   Skip
   Quit
   Help


ΓòÉΓòÉΓòÉ 112. Help for Source Path ΓòÉΓòÉΓòÉ

SpaceMap displays the drive and parent path of the source directory in this
field.


ΓòÉΓòÉΓòÉ 113. Help for Target Path ΓòÉΓòÉΓòÉ

SpaceMap displays the drive and parent path of the target directory in this
field.


ΓòÉΓòÉΓòÉ 114. Help for Source Directory ΓòÉΓòÉΓòÉ

SpaceMap displays the source directory name in this field.


ΓòÉΓòÉΓòÉ 115. Help for Target Directory ΓòÉΓòÉΓòÉ

SpaceMap displays the target directory name in this field.


ΓòÉΓòÉΓòÉ 116. Help for New Target Directory ΓòÉΓòÉΓòÉ

Use this field to specify the new target directory name in the case where you
are going to select the Rename action.  If this new name turns out to be a
duplicate also, then you will be notified and given another chance to respond
to the original duplicate name situation.


ΓòÉΓòÉΓòÉ 117. Help for Rename ΓòÉΓòÉΓòÉ

Select Rename to start the rename operation.  The source directory will be
called by the new name on the target drive.


ΓòÉΓòÉΓòÉ 118. Help for Accept ΓòÉΓòÉΓòÉ

Select Accept to continue with the copy or move operation. The existing target
directory name will be used as the target.


ΓòÉΓòÉΓòÉ 119. Help for Skip ΓòÉΓòÉΓòÉ

Select Skip to ignore the current source directory and continue the current
copy or move operation with the next source directory.


ΓòÉΓòÉΓòÉ 120. Help for Quit ΓòÉΓòÉΓòÉ

Select Quit to terminate the entire copy or move operation.


ΓòÉΓòÉΓòÉ 121. Help for Help ΓòÉΓòÉΓòÉ

Select Help to view information describing the Duplicate Directory Name on
Target pop-up window and its fields and buttons.


ΓòÉΓòÉΓòÉ 122. Help for Move Directory Window ΓòÉΓòÉΓòÉ

The Move Directory pop-up window allows you to move the selected directory and
all of its descendents to a specified target directory.

Fields:

   Source directory
   Target directory
   If target does not exist
   What kind of files to move
   If file already exists
   If EA's not supported
   Move even system files
   Move even read-only files
   Reclaim file space

 Actions:

   Move
   Stop
   Cancel
   Help

 Note:  SpaceMap will not allow you to remove the following system files from
 the root directory of a drive:

   OS2KRNL
   OS2BOOT
   OS2LDR
   OS2LDR.MSG
   WP ROOT. SF
   EA DATA. SF


ΓòÉΓòÉΓòÉ 123. Help for Source Directory ΓòÉΓòÉΓòÉ

SpaceMap displays the drive, path, and name of the source directory in this
field.


ΓòÉΓòÉΓòÉ 124. Help for Target Directory ΓòÉΓòÉΓòÉ

Use this field to specify the drive, path, and name of the target directory.

For example:

   C:\
   C:\SALES
   C:\SALES\NOV93
   C:\SALES\NOV93\JOHNSON


ΓòÉΓòÉΓòÉ 125. Help for If Target Does Not Exist ΓòÉΓòÉΓòÉ

Use this field to specify the action to take if the target directory does not
exist.  This action also applies to child directories of the source which do
not exist on the target.

Select Create it to create the target directory before moving the contents of
the source directory into it.

Select Don't move to terminate the move operation if the primary target
directory is the one that is missing.  If the missing target directory is a
child directory, then it will be skipped over, and the operation will continue
with the next child directory.


ΓòÉΓòÉΓòÉ 126. Help for What Kind of Files To Move ΓòÉΓòÉΓòÉ

Use this field to specify the type of files that should be moved from the
source directory to the target directory.

Select Files matching View Criteria only to move only files whose
characteristics match the specified file search criteria.  Note: this is a very
powerful feature which allows you, for example, to move only .DAT files which
have not been accessed in the last 90 days.

Select All files to move the entire contents of the source directory regardless
of the current file search criteria.


ΓòÉΓòÉΓòÉ 127. Help for If File Already Exists ΓòÉΓòÉΓòÉ

Use this field to specify the action to take if a file already exists in the
target directory.  This action also applies if a file in one of the source
child directories already exists in its counterpart child directory on the
target.

Select Inquire to cause a Duplicate File Name on Target pop-up window to be
displayed whenever a duplicate file situation arises.  You can specify in this
window the action to take for the particular duplicate file involved. Actions
available include:  rename, replace, append, skip, and quit.

Select Replace to cause the duplicate file on the target to be automatically
replaced by the source file.

If a file name compression occurs and a duplicate situation arises as a result,
then Replace is automatically converted into Inquire for the rest of the files
in that directory.  The same thing happens for a file name expansion which
results in a duplicate situation.

If a directory name compression occurs and a duplicate situation arises as a
result, then Replace is automatically converted into Inquire for the rest of
directories in the current move operation.  Also, Duplicate Directory Name on
Target pop-up window is displayed.  You can specify in this window the action
to take for the particular duplicate directory involved. Actions available
include:  rename, accept, skip, and quit.

Select Append to cause the duplicate file on the source to be automatically
added on to the end of the target file.  Append follows the same rules as
Replace in cases involving file or directory name compression or expansion
which result in a duplicate situation.

Select Don't move to cause the file in question to be skipped over.  The move
operation will continue with the next file in the source directory.

If you have selected Replace or Append, then two sub-options become available
to you:

     Select Even if target System attribute is 'On' to cause the 'replace' or
     'append' action to be carried out even in cases where the duplicate target
     file is a 'system' file.

     Select Even if target Read-only attribute is 'On' to cause the 'replace'
     or 'append' action to be carried out even in cases where the duplicate
     target file is a 'read-only' file.


ΓòÉΓòÉΓòÉ 128. Help for If EA's Not Supported ΓòÉΓòÉΓòÉ

Use this field to specify the action to take if the source file has Extended
Attributes, but the target drive does not support them.

Select Move anyway to continue with the move operation. The file will be moved,
but not its Extended Attributes.

Select Don't Move to skip this file and continue the move operation with the
next file.


ΓòÉΓòÉΓòÉ 129. Help for Move Even System Files ΓòÉΓòÉΓòÉ

Use this field to indicate whether or not files should be moved even if their
System attribute is 'on'.


ΓòÉΓòÉΓòÉ 130. Help for Move Even Read-only Files ΓòÉΓòÉΓòÉ

Use this field to indicate whether or not files should be moved even if their
Read-only attribute is 'on'.


ΓòÉΓòÉΓòÉ 131. Help for Reclaim File Space ΓòÉΓòÉΓòÉ

Use this field to indicate whether or not space on the source disk drive should
be recovered (de-allocated) for the files that are moved.  If this option is
checked, then there will be more free space on the drive after the move
operation completes.  If this option is not checked, then (depending on how you
have configured your workstation environment) some or all of the space may not
be recovered.

OS/2 provides the capability to set up a DELETE directory which will receive
deleted files and retain them in case you want to restore those files at a
later time.  Normally, you will set some upper limit (say 512K) for how much
total space can be used by the DELETE directory.  If this space limit is
exceeded, one or more older files will be finally erased forever, and the new
'deleted' file will be added to the directory.

If you have a DELETE directory set up and if a deleted file is still in that
directory, then you can restore that file to its original directory and name by
using the OS/2 UNDELETE command.

Since the primary goal of SpaceMap is to allow you to increase the amount of
free space on a disk drive, most of the time you will want to leave this option
checked.  This way when you move a file to another disk drive, total free space
on the source drive will increase by the size of the file moved.  A
disadvantage to this choice is that once the file has been moved, it cannot be
un-erased on the source drive.

On the other hand, if you want to ensure recoverability of the moved file, then
uncheck this option.

Note that if you uncheck this option and move a file from one directory to
another on the same disk drive, then your total free space on that drive may
actually DECREASE.  This is because the file is now using twice as much space.
It is taking up space once in the target directory and once in the DELETE
directory.


ΓòÉΓòÉΓòÉ 132. Help for Move ΓòÉΓòÉΓòÉ

Select Move to start the move operation.


ΓòÉΓòÉΓòÉ 133. Help for Stop ΓòÉΓòÉΓòÉ

Select Stop to terminate a move operation which is in-progress.


ΓòÉΓòÉΓòÉ 134. Help for Cancel ΓòÉΓòÉΓòÉ

Select Cancel to close the pop-up window.  This will not alter whatever move
action you may or may not have taken so far.


ΓòÉΓòÉΓòÉ 135. Help for Help ΓòÉΓòÉΓòÉ

Select Help to view information describing the Move Directory pop-up window and
its fields and buttons.


ΓòÉΓòÉΓòÉ 136. Help for Erase Directory Window ΓòÉΓòÉΓòÉ

The Erase Directory pop-up window allows you to delete the selected directory
and all of its descendents.

Fields:

   Directory
   What kind of files to erase
   Erase even system files
   Erase even read-only files
   Reclaim file space

 Actions:

   Erase
   Stop
   Cancel
   Help

 Note:  SpaceMap will not allow you to remove the following system files from
 the root directory of a drive:

   OS2KRNL
   OS2BOOT
   OS2LDR
   OS2LDR.MSG
   WP ROOT. SF
   EA DATA. SF


ΓòÉΓòÉΓòÉ 137. Help for Directory ΓòÉΓòÉΓòÉ

SpaceMap displays the drive, path, and name of the directory to be erased in
this field.


ΓòÉΓòÉΓòÉ 138. Help for What Kind of Files To Erase ΓòÉΓòÉΓòÉ

Use this field to specify the type of files that should be erased from the
directory.

Select Files matching View Criteria only to erase only files whose
characteristics match the specified file search criteria.  Note: this is a very
powerful feature which allows you, for example, to erase only .DAT files which
have not been accessed in the last 90 days.

Select All files to erase the entire contents of the source directory
regardless of the current file search criteria.


ΓòÉΓòÉΓòÉ 139. Help for Erase Even System Files ΓòÉΓòÉΓòÉ

Use this field to indicate whether or not files should be erased even if their
System attribute is 'on'.


ΓòÉΓòÉΓòÉ 140. Help for Erase Even Read-only Files ΓòÉΓòÉΓòÉ

Use this field to indicate whether or not files should be erased even if their
Read-only attribute is 'on'.


ΓòÉΓòÉΓòÉ 141. Help for Reclaim File Space ΓòÉΓòÉΓòÉ

Use this field to indicate whether or not space on the source disk drive should
be recovered (de-allocated) for the files that are erased.  If this option is
checked, then there will be more free space on the drive after the erase
operation completes.  If this option is not checked, then (depending on how you
have configured your workstation environment) some or all of the space may not
be recovered.

OS/2 provides the capability to set up a DELETE directory which will receive
deleted files and retain them in case you want to restore those files at a
later time.  Normally, you will set some upper limit (say 512K) for how much
total space can be used by the DELETE directory.  If this space limit is
exceeded, one or more older files will be finally erased forever, and the new
'deleted' file will be added to the directory.

If you have a DELETE directory set up and if a deleted file is still in that
directory, then you can restore that file to its original directory and name by
using the OS/2 UNDELETE command.

Since the primary goal of SpaceMap is to allow you to increase the amount of
free space on a disk drive, most of the time you will want to leave this option
checked.  This way when you erase a file, total free space on the drive will
increase by the size of the file erased.  A disadvantage to this choice is that
once the file has been erased, it cannot be un-erased on the drive.

On the other hand, if you want to ensure recoverability of the erased file,
then uncheck this option.


ΓòÉΓòÉΓòÉ 142. Help for Erase ΓòÉΓòÉΓòÉ

Select Erase to start the erase operation.


ΓòÉΓòÉΓòÉ 143. Help for Stop ΓòÉΓòÉΓòÉ

Select Stop to terminate a erase operation which is in-progress.


ΓòÉΓòÉΓòÉ 144. Help for Cancel ΓòÉΓòÉΓòÉ

Select Cancel to close the pop-up window.  This will not alter whatever erase
action you may or may not have taken so far.


ΓòÉΓòÉΓòÉ 145. Help for Help ΓòÉΓòÉΓòÉ

Select Help to view information describing the Erase Directory pop-up window
and its fields and buttons.


ΓòÉΓòÉΓòÉ 146. Help for Criteria Window ΓòÉΓòÉΓòÉ

The Criteria pop-up window allows you to specify file search criteria that will
be used by the Scan function to filter-in and/or filter-out certain types of
files.  The window contains a notebook with several different tabs representing
the various criteria that can be specified.

Notebook tabs:

   Tab                 Description
   Include             Directory inclusion
   Sum                 Space types to sum
   Size                File size ranges
   Attributes          File attributes
   Creation            File creation dates
   Last access         File last access dates
   Last write          File last write dates
   Masks               File name patterns

 Actions:

   OK
   Defaults
   Cancel
   Help


ΓòÉΓòÉΓòÉ 147. Help for OK ΓòÉΓòÉΓòÉ

Select OK to close the pop-up window and activate the current set of criteria.
If a scan has been done and the auto-rescan option is checked, then a re-scan
will be started using the new criteria.


ΓòÉΓòÉΓòÉ 148. Help for Defaults ΓòÉΓòÉΓòÉ

Select Defaults to cause all notebook pages to reset themselves to the program
start-up default values.


ΓòÉΓòÉΓòÉ 149. Help for Cancel ΓòÉΓòÉΓòÉ

Select Cancel to close the pop-up window.  This will cause all changes you have
made to the current set of criteria to be lost.


ΓòÉΓòÉΓòÉ 150. Help for Help ΓòÉΓòÉΓòÉ

Select Help to view information describing the Criteria pop-up window and its
fields and buttons.


ΓòÉΓòÉΓòÉ 151. Help for Include Page ΓòÉΓòÉΓòÉ

The Include notebook page allows you to specify what entries to include in the
Directory List.

The Parent Directory group of fields lets you specify whether an entry will be
included in the list for the Parent Directory itself. You can also specify
whether the Bytes Allocated column of that entry should include the size of the
Parent Directory's descendents.

   Group Fields:

      Show entry
      Include descendents

 The Child Directories group of fields lets you specify whether an entry will
 be included in the list for each directory which is an immediate child of the
 Parent Directory.  You can also specify whether the Bytes Allocated column of
 that entry should include the size of the child directory's descendents.

   Group Fields:

      Show entry
      Include descendents

 Page Actions:

   Undo
   Defaults


ΓòÉΓòÉΓòÉ 152. Help for Show Entry ΓòÉΓòÉΓòÉ

Select this option to cause the Scan operation to add an entry to the Directory
List for the Parent Directory.  The Directory name for this entry will be
'<PARENT>'.

Note:  If this option is not checked, then the Include descendents option will
be disabled.


ΓòÉΓòÉΓòÉ 153. Help for Include Descendents ΓòÉΓòÉΓòÉ

Select this option to cause the Scan operation to include the size of the
descendent directories in the Bytes Allocated column for the Parent Directory
entry.

Note:  This option is the basic feature that makes SpaceMap different from
ordinary file managers and from the OS/2 'DIR' command.


ΓòÉΓòÉΓòÉ 154. Help for Show Entry ΓòÉΓòÉΓòÉ

Select this option to cause the Scan operation to add an entry to the Directory
List for each of the Parent Directory's immediate child directories.

Note:  If this option is not checked, then the Include descendents option will
be disabled.


ΓòÉΓòÉΓòÉ 155. Help for Include Descendents ΓòÉΓòÉΓòÉ

Select this option to cause the Scan operation to include the size of the
descendent directories for each child directory in the Bytes Allocated column
for child directory entries.

Note:  This option is the basic feature that makes SpaceMap different from
ordinary file managers and from the OS/2 'DIR' command.


ΓòÉΓòÉΓòÉ 156. Help for Undo ΓòÉΓòÉΓòÉ

Select Undo to cause this notebook page to reset itself to the values it had
when the View Criteria window was opened.


ΓòÉΓòÉΓòÉ 157. Help for Defaults ΓòÉΓòÉΓòÉ

Select Defaults to cause this notebook page to reset itself to the program
start-up default values.


ΓòÉΓòÉΓòÉ 158. Help for Sum Page ΓòÉΓòÉΓòÉ

The Sum notebook page allows you to specify what kind of space usage to
summarize in the Bytes Allocated column of the Directory List.

The Space Used By group of fields lets you specify what components of a file's
space usage will be summarized in the Bytes Allocated column.

   Group Fields:

      Data
      Extended attributes

 Page Actions:

   Undo
   Defaults


ΓòÉΓòÉΓòÉ 159. Help for Data ΓòÉΓòÉΓòÉ

Select this option to cause the Scan operation to include the allocated space
used by a file's contents (data) as a component in the Bytes Allocated column.


ΓòÉΓòÉΓòÉ 160. Help for Extended Attributes ΓòÉΓòÉΓòÉ

Select this option to cause the Scan operation to include the space used by a
file's Extended Attributes as a component in the Bytes Allocated column.


ΓòÉΓòÉΓòÉ 161. Help for Undo ΓòÉΓòÉΓòÉ

Select Undo to cause this notebook page to reset itself to the values it had
when the View Criteria window was opened.


ΓòÉΓòÉΓòÉ 162. Help for Defaults ΓòÉΓòÉΓòÉ

Select Defaults to cause this notebook page to reset itself to the program
start-up default values.


ΓòÉΓòÉΓòÉ 163. Help for Size Page ΓòÉΓòÉΓòÉ

The Size notebook page allows you to specify which files should be included in
the scan results based on the number of Bytes Allocated for those files.

The Minimum group of fields lets you specify the smallest acceptable file size.

   Group Fields:

      Quantity
      Unit

 The Maximum group of fields lets you specify the largest acceptable file size.

   Group Fields:

      No limit
      Quantity
      Unit

 Note:  The minimum size specified cannot be larger than the maximum size. The
 maximum cannot be smaller than the minimum.  If you accidentally violate these
 rules, SpaceMap will make the appropriate adjustments to correct the
 situation.

 Page Actions:

   Undo
   Defaults


ΓòÉΓòÉΓòÉ 164. Help for Quantity ΓòÉΓòÉΓòÉ

Use this field to specify the number for the minimum size.


ΓòÉΓòÉΓòÉ 165. Help for Unit ΓòÉΓòÉΓòÉ

Use this option to specify what unit measure to applies to the quantity field
for the minimum size.

Select Megabytes to specify that 1 unit = 1 megabyte (1,048,576) bytes.

Select Kilobytes to specify that 1 unit = 1 kilobyte (1,024) bytes.

Select Bytes to specify that 1 unit = 1 byte.


ΓòÉΓòÉΓòÉ 166. Help for No Limit ΓòÉΓòÉΓòÉ

Select this option to specify that there is no upper limit on the size of files
to accept.

If you select this option, then the Quantity and Unit fields will be disabled.


ΓòÉΓòÉΓòÉ 167. Help for Quantity ΓòÉΓòÉΓòÉ

Use this field to specify the number for the maximum size.


ΓòÉΓòÉΓòÉ 168. Help for Unit ΓòÉΓòÉΓòÉ

Use this option to specify what unit measure to applies to the quantity field
for the maximum size.

Select Megabytes to specify that 1 unit = 1 megabyte (1,048,576) bytes.

Select Kilobytes to specify that 1 unit = 1 kilobyte (1,024) bytes.

Select Bytes to specify that 1 unit = 1 byte.


ΓòÉΓòÉΓòÉ 169. Help for Undo ΓòÉΓòÉΓòÉ

Select Undo to cause this notebook page to reset itself to the values it had
when the View Criteria window was opened.


ΓòÉΓòÉΓòÉ 170. Help for Defaults ΓòÉΓòÉΓòÉ

Select Defaults to cause this notebook page to reset itself to the program
start-up default values.


ΓòÉΓòÉΓòÉ 171. Help for Attributes Page ΓòÉΓòÉΓòÉ

The Attributes notebook page allows you to specify which files should be
included in the scan results based their file attributes and type of file.

Note:  The "attributes" criteria apply only to files and not to directory
pointers.

The Type group of fields lets you specify what kind of directory entries to
accept.

   Group Fields:

      Files
      Directory Pointers

 The File Attributes group of fields lets you specify the file attributes
 settings which are acceptable.

   Group Fields:

      System
      Hidden
      Read-only
      Archive

 Page Actions:

   Undo
   Defaults


ΓòÉΓòÉΓòÉ 172. Help for Files ΓòÉΓòÉΓòÉ

Select this option to specify that files should be included in the results of
the Scan operation.

If this option is not selected, then the File Attributes group of fields will
be disabled.  For SpaceMap's search purposes, file attributes apply only to
files, not to directory pointers.


ΓòÉΓòÉΓòÉ 173. Help for Directory Pointer ΓòÉΓòÉΓòÉ

Select this option to specify that directory pointers should be included in the
results of the Scan operation.

For SpaceMap's search purposes, file attributes apply only to files, not to
directory pointers.


ΓòÉΓòÉΓòÉ 174. Help for System ΓòÉΓòÉΓòÉ

Use this option to specify what state of the System Attribute is acceptable.

Select On to accept only files whose System Attribute is in the 'on' state.

Select Off to accept only files whose System Attribute is in the 'off' state.

Select Either to accept all files regardless of the state of their System
Attribute.


ΓòÉΓòÉΓòÉ 175. Help for Hidden ΓòÉΓòÉΓòÉ

Use this option to specify what state of the Hidden Attribute is acceptable.

Select On to accept only files whose Hidden Attribute is in the 'on' state.

Select Off to accept only files whose Hidden Attribute is in the 'off' state.

Select Either to accept all files regardless of the state of their Hidden
Attribute.


ΓòÉΓòÉΓòÉ 176. Help for Read-only ΓòÉΓòÉΓòÉ

Use this option to specify what state of the Read-only Attribute is acceptable.

Select On to accept only files whose Read-only Attribute is in the 'on' state.

Select Off to accept only files whose Read-only Attribute is in the 'off'
state.

Select Either to accept all files regardless of the state of their Read-only
Attribute.


ΓòÉΓòÉΓòÉ 177. Help for Archive ΓòÉΓòÉΓòÉ

Use this option to specify what state of the Archive Attribute is acceptable.

Select On to accept only files whose Archive Attribute is in the 'on' state.

Select Off to accept only files whose Archive Attribute is in the 'off' state.

Select Either to accept all files regardless of the state of their Archive
Attribute.


ΓòÉΓòÉΓòÉ 178. Help for Undo ΓòÉΓòÉΓòÉ

Select Undo to cause this notebook page to reset itself to the values it had
when the View Criteria window was opened.


ΓòÉΓòÉΓòÉ 179. Help for Defaults ΓòÉΓòÉΓòÉ

Select Defaults to cause this notebook page to reset itself to the program
start-up default values.


ΓòÉΓòÉΓòÉ 180. Help for Date Page ΓòÉΓòÉΓòÉ

The Date notebook pages allow you to specify which files should be included in
the scan results based on a range of acceptable values for their date fields.
There is a 'date' page for each of these file dates:  Creation, Last access,
and Last write.

Note:  These three dates bear no particular relation to each other.  A file
could be created on drive C: on January 1, read on February 1, and changed on
March 1. In this case Last Access Date would be less than Last Write Date.  If
the file were then copied to Drive D: on April 1, its Creation Date(April 1)
would be greater than its Last Write Date(March 1).  Thus, if you want to find
all files which have not been touched (in any way) since a given date, you must
check both Last Access Date and Last Write Date.

Fields:

   Accept any date

 The From group of fields lets you specify the minimum date value to accept.

   Group Fields:

      The beginning
      Today minus
      Specific date

 The To group of fields lets you specify the maximum date value to accept.

   Group Fields:

      Today
      Today minus
      Specific date

 Note:  The From date specified cannot be later than the To date.  The To date
 cannot be earlier than the From date.  If you accidentally violate these
 rules, SpaceMap will make the appropriate adjustments to correct the
 situation.

 Page Actions:

   Undo
   Defaults


ΓòÉΓòÉΓòÉ 181. Help for Accept Any Date ΓòÉΓòÉΓòÉ

Select this option to specify that all files should be included in the results
of the Scan operation regardless of the value in the date field in question.

If this option is selected, then the From and To groups of fields will be
disabled.


ΓòÉΓòÉΓòÉ 182. Help for The Beginning ΓòÉΓòÉΓòÉ

Select this option to specify that any date is acceptable from January 1, 1980
until the To date value.

Note:  January 1, 1980 is considered to be "the beginning of time as we know
it" from the PC perspective.


ΓòÉΓòÉΓòÉ 183. Help for Today Minus ΓòÉΓòÉΓòÉ

Select this option to specify that any date is acceptable from today's date
(minus a fixed number of days) until the To date value.

Use the number field to specify the amount of days to be subtracted from
today's date.


ΓòÉΓòÉΓòÉ 184. Help for Specific Date ΓòÉΓòÉΓòÉ

Select this option to specify that any date is acceptable from a specified date
until the To date value.

Use the Year, Month, and Days fields to specify this minimum date.

Note:  This date defaults to January 1, 1980 until you change it. The minimum
value of this date is January 1, 1980.  The maximum value is today's date.
Also, changing the value of one of these three fields may cause SpaceMap to
automatically adjust the value of the other two in order to maintain a valid
date.

January 1, 1980 is considered to be "the beginning of time as we know it" from
the PC perspective.


ΓòÉΓòÉΓòÉ 185. Help for Today ΓòÉΓòÉΓòÉ

Select this option to specify that any date is acceptable from the From date
value until today's date.


ΓòÉΓòÉΓòÉ 186. Help for Today Minus ΓòÉΓòÉΓòÉ

Select this option to specify that any date is acceptable from the From date
value until today's date (minus a fixed number of days).

Use the number field to specify the amount of days to be subtracted from
today's date.


ΓòÉΓòÉΓòÉ 187. Help for Specific Date ΓòÉΓòÉΓòÉ

Select this option to specify that any date is acceptable from the From date
value until a specified date.

Use the Year, Month, and Days fields to specify this maximum date.

Note:  This date defaults to today's date until you change it.  The minimum
value of this date is January 1, 1980.  The maximum value is today's date.
Also, changing the value of one of these three fields may cause SpaceMap to
automatically adjust the value of the other two in order to maintain a valid
date.

January 1, 1980 is considered to be "the beginning of time as we know it" from
the PC perspective.


ΓòÉΓòÉΓòÉ 188. Help for Undo ΓòÉΓòÉΓòÉ

Select Undo to cause this notebook page to reset itself to the values it had
when the View Criteria window was opened.


ΓòÉΓòÉΓòÉ 189. Help for Defaults ΓòÉΓòÉΓòÉ

Select Defaults to cause this notebook page to reset itself to the program
start-up default values.


ΓòÉΓòÉΓòÉ 190. Help for Masks Page ΓòÉΓòÉΓòÉ

The Masks notebook page allows you to specify which files should be included in
the scan results based on whether or not their file name matches (or does not
match) certain patterns ('masks').

Note:  The "masks" criteria apply only to files and not to directory pointers.

The Include group of fields lets you specify a set of one or more masks which
if matched indicate that a file should be included in the results of the Scan
operation.

   Group Fields:

      File mask list
      File mask
      Add button
      Change button
      Delete button

 The Exclude group of fields lets you specify a set of one or more masks which
 if matched indicate that a file should be excluded from the results of the
 Scan operation.

   Group Fields:

      File mask list
      File mask
      Add button
      Change button
      Delete button

 Note:  A given file name is first matched against the set of 'include' masks.
 If there is not a match, the name is excluded.  If there is a match, the name
 is matched against the set of 'exclude' masks.  If there is a match, the name
 is excluded.  If there is not a match, the name is included.

 In other words, 'include' masks apply first, then 'exclude' masks.

 Page Actions:

   Undo
   Defaults


ΓòÉΓòÉΓòÉ 191. Help for File Mask ΓòÉΓòÉΓòÉ

Use this field to enter a new 'include' mask or to edit an existing one.


ΓòÉΓòÉΓòÉ 192. Help for Add ΓòÉΓòÉΓòÉ

Select this button to insert the current value in the File mask field into the
File mask list.  If this value is already in the list, a warning beep will
sound and the list will not be changed.


ΓòÉΓòÉΓòÉ 193. Help for Change ΓòÉΓòÉΓòÉ

Select this button to replace the selected item in the File mask list with the
current value in the File mask field.  If this new value is already in the
list, a warning beep will sound and the list will not be changed.


ΓòÉΓòÉΓòÉ 194. Help for Delete ΓòÉΓòÉΓòÉ

Select this button to remove the selected item from the File mask list.  If
this item is the last item in the list, a warning beep will sound and the list
will not be changed.


ΓòÉΓòÉΓòÉ 195. Help for File Mask List ΓòÉΓòÉΓòÉ

SpaceMap displays the list of 'include' file masks in this field.  The
currently selected item in the list also appears in the File mask field.


ΓòÉΓòÉΓòÉ 196. Help for File Mask ΓòÉΓòÉΓòÉ

Use this field to enter a new 'exclude' mask or to edit an existing one.


ΓòÉΓòÉΓòÉ 197. Help for Add ΓòÉΓòÉΓòÉ

Select this button to insert the current value in the File mask field into the
File mask list.  If this value is already in the list, a warning beep will
sound and the list will not be changed.


ΓòÉΓòÉΓòÉ 198. Help for Change ΓòÉΓòÉΓòÉ

Select this button to replace the selected item in the File mask list with the
current value in the File mask field.  If this new value is already in the
list, a warning beep will sound and the list will not be changed.


ΓòÉΓòÉΓòÉ 199. Help for Delete ΓòÉΓòÉΓòÉ

Select this button to remove the selected item from the File mask list.


ΓòÉΓòÉΓòÉ 200. Help for File Mask List ΓòÉΓòÉΓòÉ

SpaceMap displays the list of 'exclude' file masks in this field.  The
currently selected item in the list also appears in the File mask field.


ΓòÉΓòÉΓòÉ 201. Help for Undo ΓòÉΓòÉΓòÉ

Select Undo to cause this notebook page to reset itself to the values it had
when the View Criteria window was opened.


ΓòÉΓòÉΓòÉ 202. Help for Defaults ΓòÉΓòÉΓòÉ

Select Defaults to cause this notebook page to reset itself to the program
start-up default values.


ΓòÉΓòÉΓòÉ 203. Help for Configure Editor Window ΓòÉΓòÉΓòÉ

The Configure Editor pop-up window allows you to specify the editor program you
want to use when selecting Edit in the File Window

Fields:

   Title
   Path and file name
   Parameters
   Working directory

 Actions:

   Save
   Cancel
   Help


ΓòÉΓòÉΓòÉ 204. Help for Title ΓòÉΓòÉΓòÉ

Use this field to specify a title for your editor program.  This title will
appear in the OS/2 Window List window whenever you are editing a file.


ΓòÉΓòÉΓòÉ 205. Help for File Name ΓòÉΓòÉΓòÉ

Use this field to specify the drive, path, and name of the editor program.  If
the editor's directory is in the OS/2 PATH, then you need only specify the file
name without the drive and path.

For example:

   C:\OS2\APPS\EPM.EXE

   EPM.EXE


ΓòÉΓòÉΓòÉ 206. Help for Parameters ΓòÉΓòÉΓòÉ

Use this field to specify the parameters to be passed to your editor program.

Note:  If you want to include the drive, path, and name of the selected file
(the one you want to edit), then use the symbol '%f'.  You may also include
other parameters as needed.


ΓòÉΓòÉΓòÉ 207. Help for Working Directory ΓòÉΓòÉΓòÉ

Use this field to specify the drive, path, and directory name of the directory
you want to be in when SpaceMap starts your editor program.

Note:  If you want to specify the drive, path, and name of the selected
directory (the one containing the file you want to edit), then use the symbol
'%d'.


ΓòÉΓòÉΓòÉ 208. Help for Save ΓòÉΓòÉΓòÉ

Select Save to store the current editor configuration, make it the default
configuration, and close the pop-up window.  At the end of this session,
SpaceMap will write this new default editor configuration to the file
SPACEMAP.INI.


ΓòÉΓòÉΓòÉ 209. Help for Cancel ΓòÉΓòÉΓòÉ

Select Cancel to close the pop-up window.  Any changes you have made to the
editor configuration will be lost.


ΓòÉΓòÉΓòÉ 210. Help for Help ΓòÉΓòÉΓòÉ

Select Help to view information describing the Configure Editor pop-up window
and its fields and buttons.


ΓòÉΓòÉΓòÉ 211. Help for Copy Marked Files Window ΓòÉΓòÉΓòÉ

The Copy Marked Files pop-up window allows you to copy the marked files from
their current directory to a specified target directory.

Fields:

   Marked file list
   Target directory
   If target does not exist
   If file already exists
   If EA's not supported

 Actions:

   Copy
   Stop
   Cancel
   Help


ΓòÉΓòÉΓòÉ 212. Help for Marked File List ΓòÉΓòÉΓòÉ

SpaceMap displays a list of the marked files in this field.  After a file is
successfully copied, it is removed from this window.  However, the file remains
'marked' in the File Window list.


ΓòÉΓòÉΓòÉ 213. Help for Target Directory ΓòÉΓòÉΓòÉ

Use this field to specify the drive, path, and name of the target directory.

For example:

   C:\
   C:\SALES
   C:\SALES\NOV93
   C:\SALES\NOV93\JOHNSON


ΓòÉΓòÉΓòÉ 214. Help for If Target Does Not Exist ΓòÉΓòÉΓòÉ

Use this field to specify the action to take if the target directory does not
exist.

Select Create it to create the target directory before copying the marked files
into it.

Select Don't copy to terminate the copy operation if the target directory does
not exist.


ΓòÉΓòÉΓòÉ 215. Help for If File Already Exists ΓòÉΓòÉΓòÉ

Use this field to specify the action to take if a file already exists in the
target directory.

Select Inquire to cause a Duplicate File Name on Target pop-up window to be
displayed whenever a duplicate file situation arises.  You can specify in this
window the action to take for the particular duplicate file involved. Actions
available include:  rename, replace, append, skip, and quit.

Select Replace to cause the duplicate file on the target to be automatically
replaced by the source file.

If a file name compression occurs and a duplicate situation arises as a result,
then Replace is automatically converted into Inquire for the rest of the marked
files.  The same thing happens for a file name  expansion which results in a
duplicate situation.

Select Append to cause the duplicate file on the source to be automatically
added on to the end of the target file.  Append follows the same rules as
Replace  in cases involving file name compression or expansion which result in
a duplicate situation.

Select Don't copy to cause the file in question to be skipped over.  The copy
operation will continue with the next marked file.

If you have selected Replace or Append, then two sub-options become available
to you:

     Select Even if target System attribute is 'On' to cause the 'replace' or
     'append' action to be carried out even in cases where the duplicate target
     file is a 'system' file.

     Select Even if target Read-only attribute is 'On' to cause the 'replace'
     or 'append' action to be carried out even in cases where the duplicate
     target file is a 'read-only' file.


ΓòÉΓòÉΓòÉ 216. Help for If EA's Not Supported ΓòÉΓòÉΓòÉ

Use this field to specify the action to take if the source file has Extended
Attributes, but the target drive does not support them.

Select Copy anyway to continue with the copy operation. The file will be
copied, but not its Extended Attributes.

Select Don't copy to skip this file and continue the copy operation with the
next marked file.


ΓòÉΓòÉΓòÉ 217. Help for Copy ΓòÉΓòÉΓòÉ

Select Copy to start the copy operation.


ΓòÉΓòÉΓòÉ 218. Help for Stop ΓòÉΓòÉΓòÉ

Select Stop to terminate a copy operation which is in-progress.


ΓòÉΓòÉΓòÉ 219. Help for Cancel ΓòÉΓòÉΓòÉ

Select Cancel to close the pop-up window.  This will not alter whatever copy
action you may or may not have taken so far.


ΓòÉΓòÉΓòÉ 220. Help for Help ΓòÉΓòÉΓòÉ

Select Help to view information describing the Copy Marked Files pop-up window
and its fields and buttons.


ΓòÉΓòÉΓòÉ 221. Help for Duplicate File Name ΓòÉΓòÉΓòÉ

The Duplicate File Name on Target pop-up window allows you to specify the
action to take whenever a duplicate file situation arises during a file copy or
move operation.

Fields:

   Source file
   Target file
   Target file attributes
   New target name

 Actions:

   Rename
   Replace
   Append
   Skip
   Quit
   Help


ΓòÉΓòÉΓòÉ 222. Help for Source File ΓòÉΓòÉΓòÉ

SpaceMap displays the source file name in this field.


ΓòÉΓòÉΓòÉ 223. Help for Target File ΓòÉΓòÉΓòÉ

SpaceMap displays the target file name in this field.


ΓòÉΓòÉΓòÉ 224. Help for Target File Attributes ΓòÉΓòÉΓòÉ

SpaceMap displays the target file attributes in this field.  If you choose the
Replace or Append  actions, then these operations will be carried out even if
the target file attributes are System or Read-only.  This field is displayed so
that you can make the decision to override these two attributes on a
case-by-case basis.


ΓòÉΓòÉΓòÉ 225. Help for New Target File ΓòÉΓòÉΓòÉ

Use this field to specify the new target file name in the case where you are
going to select the Rename action.  If this new name turns out to be a
duplicate also, then you will be notified and given another chance to respond
to the original duplicate name situation.


ΓòÉΓòÉΓòÉ 226. Help for Rename ΓòÉΓòÉΓòÉ

Select Rename to start the rename operation.  The source file will be called by
the new name in the target directory.


ΓòÉΓòÉΓòÉ 227. Help for Replace ΓòÉΓòÉΓòÉ

Select Replace to start the replace operation.  The existing target file will
be overwritten by the source file.


ΓòÉΓòÉΓòÉ 228. Help for Append ΓòÉΓòÉΓòÉ

Select Append to start the append operation.  The source file will be added
onto the end of the existing target file.


ΓòÉΓòÉΓòÉ 229. Help for Skip ΓòÉΓòÉΓòÉ

Select Skip to ignore the current source file and continue the current copy or
move operation with the next source file.


ΓòÉΓòÉΓòÉ 230. Help for Quit ΓòÉΓòÉΓòÉ

Select Quit to terminate the entire copy or move operation.


ΓòÉΓòÉΓòÉ 231. Help for Help ΓòÉΓòÉΓòÉ

Select Help to view information describing the Duplicate File Name on Target
pop-up window and its fields and buttons.


ΓòÉΓòÉΓòÉ 232. Help for Move Marked Files Window ΓòÉΓòÉΓòÉ

The Move Marked Files pop-up window allows you to move the marked files to a
specified target directory.

Fields:

   Marked file list
   Target directory
   If target does not exist
   If file already exists
   If EA's not supported
   Move even system files
   Move even read-only files
   Reclaim file space

 Actions:

   Move
   Stop
   Cancel
   Help

 Note:  SpaceMap will not allow you to remove the following system files from
 the root directory of a drive:

   OS2KRNL
   OS2BOOT
   OS2LDR
   OS2LDR.MSG
   WP ROOT. SF
   EA DATA. SF


ΓòÉΓòÉΓòÉ 233. Help for Marked File List ΓòÉΓòÉΓòÉ

SpaceMap displays a list of the marked files in this field.  After a file is
successfully moved, it is removed from this window.  Also, the file is removed
from the File Window list.


ΓòÉΓòÉΓòÉ 234. Help for Target Directory ΓòÉΓòÉΓòÉ

Use this field to specify the drive, path, and name of the target directory.

For example:

   C:\
   C:\SALES
   C:\SALES\NOV93
   C:\SALES\NOV93\JOHNSON


ΓòÉΓòÉΓòÉ 235. Help for If Target Does Not Exist ΓòÉΓòÉΓòÉ

Use this field to specify the action to take if the target directory does not
exist.

Select Create it to create the target directory before moving the marked files
into it.

Select Don't move to terminate the move operation if the target directory does
not exist.


ΓòÉΓòÉΓòÉ 236. Help for If File Already Exists ΓòÉΓòÉΓòÉ

Use this field to specify the action to take if a file already exists in the
target directory.

Select Inquire to cause a Duplicate File Name on Target pop-up window to be
displayed whenever a duplicate file situation arises.  You can specify in this
window the action to take for the particular duplicate file involved. Actions
available include:  rename, replace, append, skip, and quit.

Select Replace to cause the duplicate file on the target to be automatically
replaced by the source file.

If a file name compression occurs and a duplicate situation arises as a result,
then Replace is automatically converted into Inquire for the rest of the marked
files.  The same thing happens for a file name expansion which results in a
duplicate situation.

Select Append to cause the duplicate file on the source to be automatically
added on to the end of the target file.  Append follows the same rules as
Replace in cases involving file name compression or expansion which result in a
duplicate situation.

Select Don't move to cause the file in question to be skipped over.  The move
operation will continue with the next marked file.

If you have selected Replace or Append, then two sub-options become available
to you:

     Select Even if target System attribute is 'On' to cause the 'replace' or
     'append' action to be carried out even in cases where the duplicate target
     file is a 'system' file.

     Select Even if target Read-only attribute is 'On' to cause the 'replace'
     or 'append' action to be carried out even in cases where the duplicate
     target file is a 'read-only' file.


ΓòÉΓòÉΓòÉ 237. Help for If EA's Not Supported ΓòÉΓòÉΓòÉ

Use this field to specify the action to take if the source file has Extended
Attributes, but the target drive does not support them.

Select Move anyway to continue with the move operation. The file will be moved,
but not its Extended Attributes.

Select Don't Move to skip this file and continue the move operation with the
next file.


ΓòÉΓòÉΓòÉ 238. Help for Move Even System Files ΓòÉΓòÉΓòÉ

Use this field to indicate whether or not files should be moved even if their
System attribute is 'on'.


ΓòÉΓòÉΓòÉ 239. Help for Move Even Read-only Files ΓòÉΓòÉΓòÉ

Use this field to indicate whether or not files should be moved even if their
Read-only attribute is 'on'.


ΓòÉΓòÉΓòÉ 240. Help for Reclaim File Space ΓòÉΓòÉΓòÉ

Use this field to indicate whether or not space on the source disk drive should
be recovered (de-allocated) for the files that are moved.  If this option is
checked, then there will be more free space on the drive after the move
operation completes.  If this option is not checked, then (depending on how you
have configured your workstation environment) some or all of the space may not
be recovered.

OS/2 provides the capability to set up a DELETE directory which will receive
deleted files and retain them in case you want to restore those files at a
later time.  Normally, you will set some upper limit (say 512K) for how much
total space can be used by the DELETE directory.  If this space limit is
exceeded, one or more older files will be finally erased forever, and the new
'deleted' file will be added to the directory.

If you have a DELETE directory set up and if a deleted file is still in that
directory, then you can restore that file to its original directory and name by
using the OS/2 UNDELETE command.

Since the primary goal of SpaceMap is to allow you to increase the amount of
free space on a disk drive, most of the time you will want to leave this option
checked.  This way when you move a file to another disk drive, total free space
on the source drive will increase by the size of the file moved.  A
disadvantage to this choice is that once the file has been moved, it cannot be
un-erased on the source drive.

On the other hand, if you want to ensure recoverability of the moved file, then
uncheck this option.

Note that if you uncheck this option and move a file from one directory to
another on the same disk drive, then your total free space on that drive may
actually DECREASE.  This is because the file is now using twice as much space.
It is taking up space once in the target directory and once in the DELETE
directory.


ΓòÉΓòÉΓòÉ 241. Help for Move ΓòÉΓòÉΓòÉ

Select Move to start the move operation.


ΓòÉΓòÉΓòÉ 242. Help for Stop ΓòÉΓòÉΓòÉ

Select Stop to terminate a move operation which is in-progress.


ΓòÉΓòÉΓòÉ 243. Help for Cancel ΓòÉΓòÉΓòÉ

Select Cancel to close the pop-up window.  This will not alter whatever move
action you may or may not have taken so far.


ΓòÉΓòÉΓòÉ 244. Help for Help ΓòÉΓòÉΓòÉ

Select Help to view information describing the Move Marked Files pop-up window
and its fields and buttons.


ΓòÉΓòÉΓòÉ 245. Help for Erase Marked Files Window ΓòÉΓòÉΓòÉ

The Erase Marked Files pop-up window allows you to delete the marked files.

Fields:

   Marked files list
   Erase even system files
   Erase even read-only files
   Reclaim file space

 Actions:

   Erase
   Stop
   Cancel
   Help

 Note:  SpaceMap will not allow you to remove the following system files from
 the root directory of a drive:

   OS2KRNL
   OS2BOOT
   OS2LDR
   OS2LDR.MSG
   WP ROOT. SF
   EA DATA. SF


ΓòÉΓòÉΓòÉ 246. Help for Marked File List ΓòÉΓòÉΓòÉ

SpaceMap displays a list of the marked files in this field.  After a file is
successfully erased, it is removed from this window.  Also, the file is removed
from the File Window list.


ΓòÉΓòÉΓòÉ 247. Help for Erase Even System Files ΓòÉΓòÉΓòÉ

Use this field to indicate whether or not files should be erased even if their
System attribute is 'on'.


ΓòÉΓòÉΓòÉ 248. Help for Erase Even Read-only Files ΓòÉΓòÉΓòÉ

Use this field to indicate whether or not files should be erased even if their
Read-only attribute is 'on'.


ΓòÉΓòÉΓòÉ 249. Help for Reclaim File Space ΓòÉΓòÉΓòÉ

Use this field to indicate whether or not space on the source disk drive should
be recovered (de-allocated) for the files that are erased.  If this option is
checked, then there will be more free space on the drive after the erase
operation completes.  If this option is not checked, then (depending on how you
have configured your workstation environment) some or all of the space may not
be recovered.

OS/2 provides the capability to set up a DELETE directory which will receive
deleted files and retain them in case you want to restore those files at a
later time.  Normally, you will set some upper limit (say 512K) for how much
total space can be used by the DELETE directory.  If this space limit is
exceeded, one or more older files will be finally erased forever, and the new
'deleted' file will be added to the directory.

If you have a DELETE directory set up and if a deleted file is still in that
directory, then you can restore that file to its original directory and name by
using the OS/2 UNDELETE command.

Since the primary goal of SpaceMap is to allow you to increase the amount of
free space on a disk drive, most of the time you will want to leave this option
checked.  This way when you erase a file, total free space on the drive will
increase by the size of the file erased.  A disadvantage to this choice is that
once the file has been erased, it cannot be un-erased on the drive.

On the other hand, if you want to ensure recoverability of the erased file,
then uncheck this option.


ΓòÉΓòÉΓòÉ 250. Help for Erase ΓòÉΓòÉΓòÉ

Select Erase to start the erase operation.


ΓòÉΓòÉΓòÉ 251. Help for Stop ΓòÉΓòÉΓòÉ

Select Stop to terminate a erase operation which is in-progress.


ΓòÉΓòÉΓòÉ 252. Help for Cancel ΓòÉΓòÉΓòÉ

Select Cancel to close the pop-up window.  This will not alter whatever erase
action you may or may not have taken so far.


ΓòÉΓòÉΓòÉ 253. Help for Help ΓòÉΓòÉΓòÉ

Select Help to view information describing the Erase Marked Files pop-up window
and its fields and buttons.


ΓòÉΓòÉΓòÉ 254. Help for Save Directory List Window ΓòÉΓòÉΓòÉ

The Save Directory List pop-up window allows you to store the contents of the
Directory List into a specified file.  The records in the save file follow the
current 'relative size' and 'sort order' rules.

Fields:

   File name
   If file already exists
   Record format
   Name field format

 Actions:

   Save
   Cancel
   Help


ΓòÉΓòÉΓòÉ 255. Help for File Name ΓòÉΓòÉΓòÉ

Use this field to specify the drive, path, and name of the file in which to
store the directory list.

By convention, you should use a name in the format "*.LST".

For example:

   C:\WORK.LST
   C:\SALES\WORK.LST
   C:\SALES\NOV93\WORK.LST


ΓòÉΓòÉΓòÉ 256. Help for If File Already Exists ΓòÉΓòÉΓòÉ

Use this field to specify the action to take if a file with this name already
exists in the specified directory.

Select Replace to cause the duplicate file to be automatically replaced by the
new file.

Select Don't save to cause the save operation to terminate if a duplicate file
name is found.


ΓòÉΓòÉΓòÉ 257. Help for Record Format ΓòÉΓòÉΓòÉ

Use this field to specify the record structure for the save file.

Select Comma delimited to cause the fields in the record to be separated by
commas.  Each string (text) field will be enclosed in double-quotes.  The order
of the fields in the record is as follows:

    1. Directory name
    2. Bytes allocated
    3. Relative size

 Select Fixed position to cause the fields in the record to be placed adjacent
 to one another.  Each field will start at a fixed position in the record and
 will have a fixed length.  The order and position of the fields in the record
 is as follows:

   Field               Positions
   Bytes allocated      1 -  10
   Relative size       11 -  16
   Directory name      17 - 270

 Note:  In cases where the relative size is less than "0.1" but greater zero,
 it is expressed as the constant "0.05".


ΓòÉΓòÉΓòÉ 258. Help for Name Field Format ΓòÉΓòÉΓòÉ

Use this field to specify the method used to generate the contents of the
Directory Name field in each record.

Select Directory name only to cause the field to contain only the name of the
directory and not its drive or path.

Select Full path name to cause the field to contain the drive, path, directory
name.


ΓòÉΓòÉΓòÉ 259. Help for Save ΓòÉΓòÉΓòÉ

Select Save to start the save operation.


ΓòÉΓòÉΓòÉ 260. Help for Cancel ΓòÉΓòÉΓòÉ

Select Cancel to close the pop-up window.  This will not alter whatever save
action you may or may not have taken so far.


ΓòÉΓòÉΓòÉ 261. Help for Help ΓòÉΓòÉΓòÉ

Select Help to view information describing the Save Directory List pop-up
window and its fields and buttons.


ΓòÉΓòÉΓòÉ 262. Help for Save File List Window ΓòÉΓòÉΓòÉ

The Save File List pop-up window allows you to store the contents of the File
List into a specified file.  The records in the save file follow the current
'sort order' rules.

Fields:

   File name
   If file already exists
   Record format
   Name field format

 Actions:

   Save
   Cancel
   Help


ΓòÉΓòÉΓòÉ 263. Help for File Name ΓòÉΓòÉΓòÉ

Use this field to specify the drive, path, and name of the file in which to
store the file list.

By convention, you should use a name in the format "*.LST".

For example:

   C:\WORK.LST
   C:\SALES\WORK.LST
   C:\SALES\NOV93\WORK.LST


ΓòÉΓòÉΓòÉ 264. Help for If File Already Exists ΓòÉΓòÉΓòÉ

Use this field to specify the action to take if a file with this name already
exists in the specified directory.

Select Replace to cause the duplicate file to be automatically replaced by the
new file.

Select Don't save to cause the save operation to terminate if a duplicate file
name is found.


ΓòÉΓòÉΓòÉ 265. Help for Record Format ΓòÉΓòÉΓòÉ

Use this field to specify the record structure for the save file.

Select Comma delimited to cause the fields in the record to be separated by
commas.  Each string (text) field will be enclosed in double-quotes.  The order
of the fields in the record is as follows:

    1. Directory name
    2. Bytes allocated
    3. Attributes
    4. Creation date
    5. Last write date
    6. Last access date

 Select Fixed position to cause the fields in the record to be placed adjacent
 to one another.  Each field will start at a fixed position in the record and
 will have a fixed length.  The order and position of the fields in the record
 is as follows:

   Field               Positions
   Bytes allocated      1 -  10
   Attributes          11 -  17
   Creation date       18 -  25
   Last write          26 -  33
   Last access         34 -  41
   File name           42 - 295


ΓòÉΓòÉΓòÉ 266. Help for Name Field Format ΓòÉΓòÉΓòÉ

Use this field to specify the method used to generate the contents of the File
Name field in each record.

Select File name only to cause the field to contain only the name of the file
and not its drive or path.

Select Full path name to cause the field to contain the drive, path, file name.


ΓòÉΓòÉΓòÉ 267. Help for Save ΓòÉΓòÉΓòÉ

Select Save to start the save operation.


ΓòÉΓòÉΓòÉ 268. Help for Cancel ΓòÉΓòÉΓòÉ

Select Cancel to close the pop-up window.  This will not alter whatever save
action you may or may not have taken so far.


ΓòÉΓòÉΓòÉ 269. Help for Help ΓòÉΓòÉΓòÉ

Select Help to view information describing the Save File List pop-up window and
its fields and buttons.


ΓòÉΓòÉΓòÉ 270. Help for Load View Window ΓòÉΓòÉΓòÉ

The Load View pop-up window allows you to restore the view settings from a
specified file containing previously saved view settings.

If a scan has been done in this session, then an automatic re-scan will be done
after the new settings have been loaded.

Fields:

   File name

 Actions:

   Load
   Cancel
   Help

 Note:  The following settings are loaded by this operation.

   Parent directory (if stored in file)
   Criteria
   Directory list size selection
   Directory list sort selection
   File list date selection
   File list sort selection


ΓòÉΓòÉΓòÉ 271. Help for File Name ΓòÉΓòÉΓòÉ

Use this field to specify the drive, path, and name of the file containing the
view settings to be loaded.

By convention, this file would have a name in the format "*.VEW".

For example:

   C:\WORK.VEW
   C:\SALES\WORK.VEW
   C:\SALES\NOV93\WORK.VEW


ΓòÉΓòÉΓòÉ 272. Help for Load ΓòÉΓòÉΓòÉ

Select Load to start the load operation.


ΓòÉΓòÉΓòÉ 273. Help for Cancel ΓòÉΓòÉΓòÉ

Select Cancel to close the pop-up window.  This will not alter whatever load
action you may or may not have taken so far.


ΓòÉΓòÉΓòÉ 274. Help for Help ΓòÉΓòÉΓòÉ

Select Help to view information describing the Load View pop-up window and its
fields and buttons.


ΓòÉΓòÉΓòÉ 275. Help for Save View Window ΓòÉΓòÉΓòÉ

The Save View pop-up window allows you to store the current view settings into
a specified file which can be re-loaded at a later time.

Fields:

   File name
   If file already exists
   Save parent name

 Actions:

   Save
   Cancel
   Help

 Note:  The following settings are saved by this operation.

   Parent directory (optional)
   Criteria
   Directory list size selection
   Directory list sort selection
   File list date selection
   File list sort selection


ΓòÉΓòÉΓòÉ 276. Help for File Name ΓòÉΓòÉΓòÉ

Use this field to specify the drive, path, and name of the file in which the
view settings will be saved.

By convention, this file should have a name in the format "*.VEW".

For example:

   C:\WORK.VEW
   C:\SALES\WORK.VEW
   C:\SALES\NOV93\WORK.VEW


ΓòÉΓòÉΓòÉ 277. Help for If File Already Exists ΓòÉΓòÉΓòÉ

Use this field to specify the action to take if a file with this name already
exists in the specified directory.

Select Replace to cause the duplicate file to be automatically replaced by the
new file.

Select Don't save to cause the save operation to terminate if a duplicate file
name is found.


ΓòÉΓòÉΓòÉ 278. Help for Save Parent Name ΓòÉΓòÉΓòÉ

Use this field to indicate whether or not the current contents of the Parent
Directory field should be saved along with the view settings.


ΓòÉΓòÉΓòÉ 279. Help for Save ΓòÉΓòÉΓòÉ

Select Save to start the save operation.


ΓòÉΓòÉΓòÉ 280. Help for Cancel ΓòÉΓòÉΓòÉ

Select Cancel to close the pop-up window.  This will not alter whatever save
action you may or may not have taken so far.


ΓòÉΓòÉΓòÉ 281. Help for Help ΓòÉΓòÉΓòÉ

Select Help to view information describing the Save View pop-up window and its
fields and buttons.


ΓòÉΓòÉΓòÉ 282. Definition of 'Allocated' ΓòÉΓòÉΓòÉ

Allocated space is the amount of disk space set aside for a given file.
Occupied space is the amount that actually contains the file's data.  A file's
occupied space is usually less than its allocated space.

Most file systems allocate space in units of a given fixed length (e.g. 512
bytes for HPFS).  If a file is copied from one disk drive to another, the
number of occupied bytes will stay the same.  However, the number of allocated
bytes could change since the two drives may have been formatted for two
different file systems.

Note:  the OS/2 'DIR' command reports the space occupied by a file.  You run
out of space on a drive when there is no space left to allocate, not just
occupy.  For this reason, SpaceMap is a more accurate gauge of space usage than
is DIR.


ΓòÉΓòÉΓòÉ 283. Definition of 'Directory Pointer' ΓòÉΓòÉΓòÉ

Directory pointers are special files which do not contain user data, but rather
system information used to locate the parent and child directories of the
current directory.

Two special directory pointers are '..' (the pointer to the parent directory)
and '.' (the pointer to the current directory itself).  Otherwise directory
pointers point to immediate child directories.


ΓòÉΓòÉΓòÉ 284. Definition of 'Extended Attributes' ΓòÉΓòÉΓòÉ

Extended Attributes are additional information about a file that is not part of
the actual contents of the file.  All files have certain regular attributes
such as size, last write date, etc.  Extended attributes are additional
characteristics of the file such as history, program associations, types, etc.

On HPFS-formatted disk drives, the Extended Attributes for each file are stored
in special areas of the disk drive near the location of the actual data in the
file.  On FAT-formatted disk drives, the Extended Attributes for all files on
the disk are stored together in a single file in the root directory.  This name
of this file is "EA DATA. SF".

When SpaceMap is scanning a FAT-formatted file system, it reports space usage
for each file's Extended Attributes as part of the file size itself rather than
as part of the size of the "EA DATA. SF" file.

The OS/2 Workplace Shell uses extended attributes to store much of the
information it keeps about the objects on the desktop.


ΓòÉΓòÉΓòÉ 285. Definition of 'Name Compression' ΓòÉΓòÉΓòÉ

Name compression is an action taken by SpaceMap to translate a file or
directory name from an HPFS format into a format acceptable to the FAT file
system.

HPFS allows file and directory names to be up to 254 characters long and allows
blanks and many special characters to be included.

FAT restricts file and directory names to the so-called "8.3" format and does
not allows imbedded blanks nor certain special characters.

Whenever SpaceMap is asked to copy or move a file or directory from an HPFS
disk drive to a FAT disk drive, it translates the file (or directory) name from
the long HPFS format into the shorter 8.3 FAT format.

Sometimes this may result in two files or directories which have different
names on the HPFS drive being compressed to the same 8.3 name on the FAT drive.
When this situation arises, SpaceMap will ask you what action you would like to
take and will offer several options.

If the target FAT drive supports Extended Attributes, then SpaceMap places the
original HPFS long name into a standard extended attribute called ".LONGNAME".
This action occurs only for files.  SpaceMap does not store the original long
name for directories.


ΓòÉΓòÉΓòÉ 286. Definition of 'Name Expansion' ΓòÉΓòÉΓòÉ

Name expansion is an action taken by SpaceMap to translate a file or directory
name from a FAT format into an HPFS format.

FAT restricts file and directory names to the so-called "8.3" format and does
not allows imbedded blanks nor certain special characters.

HPFS allows file and directory names to be up to 254 characters long and allows
blanks and many special characters to be included.

Whenever SpaceMap is asked to copy or move a file from a FAT disk drive to an
HPFS disk drive, it tries to translate the file name from the shorter 8.3 FAT
format into the longer HPFS format.  This can only be done if the source file
has an extended attribute called ".LONGNAME".  The file's original long HPFS
name (before is was copied or moved to the FAT drive) is stored in this
extended attribute.

Sometimes this may result in two files which have different names on the FAT
drive being expanded to the same long name on the HPFS drive.  When this
situation arises, SpaceMap will ask you what action you would like to take and
will offer several options.

The ".LONGNAME" extended attribute is not copied to the new target file since
it is not needed there.

If the source file on the FAT drive does not have a ".LONGNAME" extended
attribute, then the 8.3 FAT file name is used for the target name.

SpaceMap performs name expansion only for files, not for directories.


ΓòÉΓòÉΓòÉ 287. Definition of 'System Attribute' ΓòÉΓòÉΓòÉ

A System Attribute is a regular file attribute which indicates whether or not a
file is part of the OS/2 system software.  In most cases you would not want to
move or erase a system file since this might affect the operation of the OS/2
system itself.

System files cannot be seen using the OS/2 'DIR' command, but are visible using
SpaceMap.


ΓòÉΓòÉΓòÉ 288. Definition of 'Hidden Attribute' ΓòÉΓòÉΓòÉ

A Hidden Attribute is a regular file attribute which indicates whether or not a
file is to be seen using the OS/2 'DIR' command.

Hidden files are visible using SpaceMap.

Note:  Files with the 'System' attribute are implicitly hidden even if their
'Hidden' attribute is 'off'.


ΓòÉΓòÉΓòÉ 289. Definition of 'Read-only Attribute' ΓòÉΓòÉΓòÉ

A Read-only Attribute is a regular file attribute which indicates that a file's
contents can be read by a program, but cannot be changed in any way.


ΓòÉΓòÉΓòÉ 290. Definition of 'Archive Attribute' ΓòÉΓòÉΓòÉ

An Archive Attribute is a regular file attribute which indicates that a file's
contents have been changed since the last time the file was backed-up.

This attribute is used by backup programs to determine which files to process
when the user requests backup only for files that have changed since the last
time the backup program was run..


ΓòÉΓòÉΓòÉ 291. Definition of 'File Mask' ΓòÉΓòÉΓòÉ

A File Mask is a string of characters which define a certain pattern for file
names.  A mask has the same length and can use the same characters as a real
file name.  There are two additional characters used in a mask which represent
virtual characters.

The symbol '?' means accept any character at this particular position in a file
name.

The symbol '*' means accept any characters from this point to either the next
'.' symbol or to the end of the name (which ever comes first).

The mask '*.*' means accept any file name.

In order for a file name to match a mask, its characters must match the
characters in the mask position for position (except for those matching a
virtual character).

For Example:

   "TEST???.DAT"
   "TEST*.DAT"
   "TEST.??T"
   "TEST.*"
   "TEST????.*"


ΓòÉΓòÉΓòÉ 292. Definition of 'HPFS' ΓòÉΓòÉΓòÉ

HPFS ('High Performance File System') is a method of formatting and managing a
disk drive.  HPFS was introduced with OS/2 and is primarily an OS/2-only file
system.  It offers features such as long file names (up to 254 characters),
high speed access, and extended attributes.

Extended attributes were designed for HPFS, but can also be used via emulation
techniques on other file systems such as FAT.


ΓòÉΓòÉΓòÉ 293. Definition of 'FAT' ΓòÉΓòÉΓòÉ

FAT ('File Allocation Table') is a method of formatting and managing a disk
drive.  FAT was introduced with DOS and is primarily a DOS-only file system.
It supports an 8.3 format file and directory name standard.  FAT is currently
the most popular PC file system and is used for formatting all PC floppy disk
drives in addition to most hard disk drives.

OS/2 supports both creation and access for FAT drives.

Although extended attributes were designed for HPFS, OS/2 supports their use on
FAT drives via a special file called "EA DATA. SF" located in the root
directory.


ΓòÉΓòÉΓòÉ 294. Definition of 'CD=ROM' ΓòÉΓòÉΓòÉ

CD-ROM ('Compact Disk - Read-only Memory') is a method of formatting and
managing a disk drive.  CD-ROM drives are, by definition, read-only.  They
resemble FAT drives in format.  CD-ROM drives are usually removeable and have
very large capacities.

SpaceMap treats CD-ROM drives just like FAT drives, except that it does not
allow a CD-ROM drive to be the target of a copy, move, or erase operation.