home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Share Gallery 1
/
share_gal_1.zip
/
share_gal_1
/
UT
/
UT190.ZIP
/
PATH-MAN.ZIP
/
PATH-MAN.DOC
< prev
next >
Wrap
Text File
|
1991-05-24
|
14KB
|
335 lines
Ç ────────────────────────────────────────────
Ç ┼┐────────────────────────────────────────────
╔╬╗ ┴
╨║╨ ┐
╔╩╗ ┴
╨ ╨
▒▒▒▒▒▒▒▒▄ ▒▒▄ ▒▒▒▒▒▒▒▒▄ ▒▒▄ ▒▒▄ ▒▒▄ ▒▒▄ ▒▒▄ ▒▒▄ ▒▒▄
▒▒█▀▀▀▒▒█ ▒▒▒▒▄ ▒▒█▀▀▀ ▒▒█ ▒▒█ ▒▒▒▄ ▒▒▒█ ▒▒▒▒▄ ▒▒▒▄ ▒▒█
▒▒▒▒▒▒▒▒█ ▒▒█▀▒▒▄ ▒▒█ ▒▒▒▒▒▒▒▒█ ▒▒▒▒▒▒▄ ▒▒▒█ ▒▒▒█ ▒▒█▀▒▒▄ ▒▒█▒▒▄▒▒█
▒▒█▀▀▀▀▀▀ ▒▒▒▒▒▒█ ▒▒█ ▒▒█▀▀▀▒▒█ ▀▀▀▀▀▀ ▒▒█▒▒▄▒▒█ ▒▒▒▒▒▒█ ▒▒█ ▀▒▒▒█
▒▒█ ▒▒█▀▀▀▒▒▄ ▒▒█ ▒▒█ ▒▒█ ▒▒█▒▒█▒▒█ ▒▒█▀▀▀▒▒▄ ▒▒█ ▒▒█
▀▀ ▀▀ ▀▀ ▀▀ ▀▀ ▀▀ ▀▀ ▀▀ ▀▀ ▀▀ ▀▀ ▀▀ ▀▀
Welcome to PATH-MAN, a utility program to deter-
mine if a file is located on a PATH directory!
PATH-MAN is a utility that searches the directory path elements of the
PATH statement for a given file. The search file name may include DOS
wildcard characters. The ERRORLEVEL variable is set, based on the
results of this search, to allow more user friendly batch files - a graceful exit
can be made when needed data files or programs are missing. Optionally,
the path element on which the search file is located may be displayed.
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
P A T H - M A N U T I L I T Y M A N U A L
PATH-MAN Version 1.10
Released May 24, 1991
▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
Copyright (C) 1991
by Micrometric
All rights reserved.
PATH-MAN is distributed as SHAREWARE and, as such, may be copied
and shared on a private non-commercial basis with others in its unmodified
form. Liability is limited to replacing the software for registered users.
There is no liability for any damage or loss caused by this software, directly
or indirectly.
┌───────┐
┌────┴──┐ │
│ ┌────┴──┐ │
│ │ │ │ Member, Association of Shareware Professionals
│ │ o ├─┘
└──┤ │ │
└───────┘
Please send comments, manual corrections and enhancement suggestions to:
David Groome
Micrometric
98 Dade Avenue
Sarasota, FL 34232
Voice/FAX (813) 377-2515
REGISTRATION SERIAL NUMBER
┌──────────────────────────────────────────────────────────┐
│ │
│ │
│ │
│ │
│ │
│ │
│ │
│ │
│ │
│ │
└──────────────────────────────────────────────────────────┘
PKZIP, PKUNZIP and PKSFX are trademarks of PKWARE, Inc.
MS-DOS is a registered trademark of the Microsoft Corporation.
IBM PC, XT, AT and PC-DOS are registered trademarks of the IBM Corporation.
TABLE OF CONTENTS
INTRODUCTION. . . . . . . . . . . . . . . . . . . . . 5
Major Features. . . . . . . . . . . . . . . . . . 5
System Requirements . . . . . . . . . . . . . . . 5
Manual Format . . . . . . . . . . . . . . . . . . 5
Page layout . . . . . . . . . . . . . . . . . 5
Brackets and parentheses. . . . . . . . . . . 6
Computer key conventions. . . . . . . . . . . 6
Action steps. . . . . . . . . . . . . . . . . 6
■■■■-MAN programs . . . . . . . . . . . . . . 6
Shareware distributed documentation manual. . 6
Shareware . . . . . . . . . . . . . . . . . . . . 7
INSTALLING THE SYSTEM . . . . . . . . . . . . . . . 9
RUNNING PATH-MAN . . . . . . . . . . . . . . . . . . 11
FileName. . . . . . . . . . . . . . . . . . . . . 11
Option. . . . . . . . . . . . . . . . . . . . . . 11
Operation . . . . . . . . . . . . . . . . . . . . 12
ERRORLEVEL. . . . . . . . . . . . . . . . . . . . 12
Shareware message . . . . . . . . . . . . . . . . 12
Examples. . . . . . . . . . . . . . . . . . . . . 13
INTRODUCTION
PATH-MAN is a utility that searches the directory path elements of the
PATH statement for a given file. The search file name may include DOS
wildcard characters. The ERRORLEVEL variable is set, based on the
results of this search, to allow more user friendly batch files - a graceful exit
can be made when needed data files or programs are missing. Optionally,
the path element on which the search file is located may be displayed.
Major Features
■ Searches the directory path elements of the current PATH statement
for a given file.
■ Sets the ERRORLEVEL variable, based on the results of this search,
to allow more user friendly batch files - a graceful exit can be made
when needed data files or programs are missing.
■ Optional display of the first path element on which the search file
name is found.
■ DOS wildcard characters of * and ? may be used in the search file
name.
■ Small size and fast operation.
System Requirements
PATH-MAN will run on an IBM PC, XT, AT or true compatibles. It has
been tested with PC-DOS/MS-DOS operating systems, version 3.0 through
version 5.0.
Manual Format
This manual is divided into several introductory chapters followed by chap-
ters for operating PATH-MAN. The format of these chapters and the infor-
mation presented therein has been standardized using the following conven-
tions.
Page layout - Each page has a header detailing the chapter and the pro-
gram version covered. A footer displays the manual page number.Brackets and parentheses - Brackets, [...], are used in the manual and in the
help screens to specify what should be entered in response to the current
prompt. If a character string is to be entered, the type of character is not-
ed, such as ALPHA, NUMERIC, ANY, etc. Parentheses, (..), are used for
comments.
Computer key conventions - Keys specified in the manual text that are not
in entry brackets are shown as reversed, such as ■ESCAPE■. All key referenc-
es are in capital letters for clarity.
Action steps - Some procedures may require selection from a menu of op-
tions, inputting data or following a sequence of steps. Most manual sections
will first give an overview of the function or task under discussion and then
detail the various action operating procedures. In order to make this manu-
al easier to use a symbol, ■ , marks the beginning of each of these action
operating procedures.
■■■■-MAN programs - The general group of shareware programs by Mic-
rometric is referred to by the name ■■■■-MAN. It may also be used in
reference to a specific program in that group.
Shareware distributed documentation manual - The documentation file in-
cluded on the shareware distribution diskette contains the same information
as the printed and bound manual supplied as part of registration with three
exceptions, the result of the word processor, formatting and printer used.
The first is that the page headers and footers are NOT present in the
shareware version (If LASR-MAN is used to print the documentation, use
of its page header option will supply the page numbers). The second is that
all of the control display characters (ASCII 1-31) and the reverse print
keyboard codes are NOT shown properly. Finally, bolding, underlining and
special symbols are NOT present.Shareware
PATH-MAN is being distributed as SHAREWARE. The SHAREWARE
concept allows users to examine a program on a trial basis at no (or mini-
mal) charge before purchasing it. In addition, by decreasing marketing costs,
professional quality software may be distributed for a fraction of the cost
of a comparable commercial product. Regardless of whether you register
the program, please help distribute PATH-MAN by sharing unmodified
copies of it and its files with others. If you find PATH-MAN of value, you
must register your program use. This will provide you with:
* A 7" x 8 1/2" printed and bound manual.
* PATH-MAN phone or mail support for one year.
* Notification of the next PATH-MAN release.
* Sincere thanks for your support of the SHAREWARE concept.
Program Registration . . . . . . . . . . . . . . . . . .$10.
Latest Version Diskette. . . . . . . . . . . . . . . . .$10.
Package (All the above). . . . . . . . . . . . . . . . .$15.
ADDRESS: Micrometric
98 Dade Avenue
Sarasota, FL 34232
PHONE: Voice/FAX (813) 377-2515
For ease in program registration, the INST-MAN program may be used to
generate an order form.
This program is produced by a member of the Association of Shareware
Professionals (ASP). ASP wants to make sure that the shareware principal
works for you. If you are unable to resolve a shareware-related problem
with an ASP member by contacting the member directly, ASP may be able
to help. The ASP Ombudsman can help you resolve a dispute or problem
with an ASP member, but does not provide technical support for members'
products. Please write to the ASP Ombudsman at 545 Grover Road, Musk-
egon, MI 49442-9427, or send a Compuserve message via easyplex to ASP
Ombudsman 70007,3536.
INSTALLING THE SYSTEM
For the procedures to install PATH-MAN and to print this documentation,
see the README file on the shareware distribution diskette.
FOR PROPER OPERATION, ALL REQUIRED PATH-MAN
FILES *MUST* BE PLACED ON PATH REFERENCED SUB-
DIRECTORIES!
RUNNING PATH-MAN
The syntax to execute the PATH-MAN utility program is:
PATH-MAN FileName[option]
A space MUST be present after the program name and before the
FileName parameter. A space MUST NOT be placed between the
FileName and the option, if it is present.
FileName
The file name to be found follows the standard DOS conventions, with a
maximum of eight characters for the file name and three characters for the
extension with a '.' separator. The DOS wildcard characters of ? and * may
be used. If no extension is specified, the match will only be on name with
all extension matching.
Option
If the FileName is followed by a '?' character, the program will display the
search results. If a matching file is found, a message with the path of the
FIRST matching file is displayed. If no matching file is found, a message
with the FileName searched for is displayed. In both cases the ERROR-
LEVEL value is also displayed.
NOTE: A '?' at the end of the FileName[option] is always treated as an
option rather that a DOS wildcard '?'.Operation
PATH-MAN searches the path directory elements referenced in the PATH
statement in the order in which they appear. For example, with the PATH
statement -
PATH=[D1:Path1][D2:Path2][...]
the path element D1:Path1 is searched first followed by D2:Path2. If a
match is found, the search is terminated and the ERRORLEVEL variable
is set.
ERRORLEVEL
The ERRORLEVEL variable is set based on the results of the search for
FileName.
If a match to FileName is found on any of the path directory elements of
the PATH statement, ERRORLEVEL is set to the ordinal number of the
Dx:Pathx path on which the file is found. This number may range from one
to the number of elements in the PATH statement.
If PATH-MAN is not present or FileName is NOT found on any of the
path directory elements of the PATH statement, ERRORLEVEL is set to
0.
NOTE: PATH-MAN's use of the ERRORLEVEL variable is the inverse
of many (if not most) programs: a zero ERRORLEVEL is bad
and a non-zero value is good. The main reasons for this is to as-
sure that PATH-MAN.COM is present and allow the path element
number to be passed to the batch file.
Shareware message
A shareware message may be randomly displayed at the end of PATH-
MAN. Pressing any key will exit the program. By registering your use of
PATH-MAN, you will be able to use the registration serial number to
suppress this shareware message display.Examples
For the purpose of these examples, assume that only files PATH-MAN.CO-
M, XYZ.COM and ABC.COM are on PATH directories.
Batch file code segment examples -
File found -
...
PATH-MAN ABC.COM
[errorlevel set to 1]
IF ERRORLEVEL 1 GOTO RUN
ECHO PROGRAM ABC.COM IS MISSING!
GOTO EXIT
...
:RUN
[batch file branches to this point]
...
:EXIT
File not found -
...
PATH-MAN CBA.COM
[errorlevel set to 0]
IF ERRORLEVEL 1 GOTO RUN
[batch file continues here]
ECHO PROGRAM CBA.COM IS MISSING!
GOTO EXIT
...
:EXIT
Command line code examples -
For - PATH-MAN XYZ.COM?
a display of - Found═[path]\XYZ.COM
ERRORLEVEL═1
For - PATH-MAN XYZ.*?
a display of - Found═[path]\XYZ.COM
ERRORLEVEL═1
For - PATH-MAN XYZ.A*?
a display of - Not Found═XYZ.A*
ERRORLEVEL═1