!***START
!	TO GENERATE THE FIND PROGRAM USE THE COMMAND FILE FINDBUILD.COM
! 
!FIND.HLP - PERAZZOLI 23-JUN-1978
FIND - SEARCH DIRECTORIES FOR FILES

FIND is a VAX ODS-2 utility which allows searching of directories and
subdirectories with wild characters, time constraints on files, and
other features not available in PIP.
An output file from FIND is easily edited and can be read by the
command stream to make repititive runs with different files very easy.
The format of the command line is:
     $MCR FIND      search-string
 
 
The FIND command searches the specified device (SYS$DISK is the default)
for all entries which match the search string.  The search string permits
wild characters in both the directory name and in the file name.
*SEARCH-LIST
A valid search string is of the form
 "DISK:[s-string.s-string.s-string]s-string.s-string;version"
where s-string is composed of the characters A-Z,0-9,?,#  
or the wild card designator "*",
with the following
meaning.  A character A-Z or 0-9 says that a match will only occur if that
character position matches, with the "?" being a wild character (all
characters match it).  The "#" character instructs the searching for all
characters following it to start from the end of the string, so the
s-string of "#12" would match everything which ends with a "12".
Also when searching directories, no search is made for matching directories
unless a "*", "?" or "#" appearing in the level, so [D#.COM] would try
to find all files in all directories which start with a "D" and have a
subdirectory of COM, while [D.COM] would only examine [D.COM].  However
in names and extensions "D.D" is the same as "D#.D#".
The version may be a number of a "*" with the default being the "*", also
an explicit version number overrides the /HIGHVERSION switch.
*EXAMPLES
1.  $MCR FIND Z
All files in the default directory which start with a Z will be listed.
2.  $MCR FIND ?Z.X
All files in the default directory which have a Z as the second character
and have an extension which begins with an X will be listed.
3.  $MCR FIND Z#X.#R
All files in the default directory which start with a Z end with an Z and
have an extension which ends with an R will be listed.
4.  $MCR FIND [.COM]
All files in the default directory in the subdirectory COM will be printed
5.  $MCR FIND [.*]
All files in all first level subdirectories of the default directory
will be listed.
6.  $MCR FIND [D#.*.OBJ]/AFTER/HIGH
The highest version of all files created after today in all directories
which start with a D and have a sub-sub level of OBJ will be listed.
7.  $MCR FIND D/NOT
All files which do not start with a D in the default directory will be listed.
*
*
*
*
*
*SWITCHES:
/OUTPUT
Requests that the resulting output from the command be written to a file
rather than the current SYS$OUTPUT device.
/AFTER=time
Requests only those files which were created after a specified time should
be listed. The time format for both /AFTER and /BEFORE is DD-MMM-YYYY HH:MM:SS.
To get all files after 2 PM on the current day use /AFTER=-- 14:00:00,
notice that a space is required before the time.
/BEFORE=time
Requests only those files which were created before a specific time should
be listed. The time format is the same as the /AFTER command. Note that
 /AFTER and /BEFORE can be used simultaneously to bracket a time period.
/HIGHVERSION=n
Reqests that only the highest n (default is 1) versions be listed.
/NOT
Request that only the files which do not match the name part of the 
search string are to be printed, all other qualifiers are in effect so /NOT
will work with /HIGH and times.

!***END
