home *** CD-ROM | disk | FTP | other *** search
/ PC Media 3 / PC MEDIA CD03.iso / share / udos / path112 / path_man.doc < prev    next >
Encoding:
Text File  |  1992-07-30  |  32.9 KB  |  919 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.                  Ç    ──────────────────────────────────────────── 
  7.                Ç ┼┐════════════════════════════════════════════   
  8.               ╔╬╗ ┴                                               
  9.               ╨║╨ ┐                                               
  10.               ╔╩╗ ┴                                               
  11.               ╨ ╨                                                 
  12.  
  13.  
  14.  
  15.  
  16.   ▒▒▒▒▒▒▒▒▄    ▒▒▄   ▒▒▒▒▒▒▒▒▄ ▒▒▄   ▒▒▄         ▒▒▄   ▒▒▄    ▒▒▄    ▒▒▄   ▒▒▄
  17.   ▒▒█▀▀▀▒▒█   ▒▒▒▒▄     ▒▒█▀▀▀ ▒▒█   ▒▒█         ▒▒▒▄ ▒▒▒█   ▒▒▒▒▄   ▒▒▒▄  ▒▒█
  18.   ▒▒▒▒▒▒▒▒█  ▒▒█▀▒▒▄    ▒▒█    ▒▒▒▒▒▒▒▒█ ▒▒▒▒▒▒▄ ▒▒▒█ ▒▒▒█  ▒▒█▀▒▒▄  ▒▒█▒▒▄▒▒█
  19.   ▒▒█▀▀▀▀▀▀  ▒▒▒▒▒▒█    ▒▒█    ▒▒█▀▀▀▒▒█  ▀▀▀▀▀▀ ▒▒█▒▒▄▒▒█  ▒▒▒▒▒▒█  ▒▒█ ▀▒▒▒█
  20.   ▒▒█       ▒▒█▀▀▀▒▒▄   ▒▒█    ▒▒█   ▒▒█         ▒▒█▒▒█▒▒█ ▒▒█▀▀▀▒▒▄ ▒▒█   ▒▒█
  21.    ▀▀        ▀▀    ▀▀    ▀▀     ▀▀    ▀▀          ▀▀ ▀▀ ▀▀  ▀▀    ▀▀  ▀▀    ▀▀
  22.  
  23.  
  24.   Welcome to PATH-MAN, a utility program to determine if a file is located on a
  25.                                  PATH directory!
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.                  ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  41.  
  42.                               U S E R   M A N U A L
  43.  
  44.                                    Version 1.1
  45.  
  46.                              Release    May 24, 1991
  47.  
  48.                  ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
  49.  
  50.                        Copyright 1991-1992 by Micrometric.
  51.                               All rights reserved.
  52.  
  53. PATH-MAN is distributed as SHAREWARE and, as such, may be copied and shared on a
  54. private  non-commercial basis with others  in its unmodified  form. Liability is
  55. limited to  replacing the software  for registered users. There  is no liability
  56. for any damage or loss caused by this software, directly or indirectly.
  57.                ┌────────────────────────────────────────────────┐ 
  58.                │             ┌───────┐                          │█
  59.                │        ┌────┴──┐    │                (R)       │█
  60.                │      ──│       │O   │───────────────────       │█
  61.                │        │  ┌────┴╨─┐ │  Association of          │█
  62.                │        │  │       │─┘  Shareware               │█
  63.                │        └──│   O   │    Professionals           │█
  64.                │      ─────│   ║   │─────────────────────       │█
  65.                │           └───╨───┘    MEMBER                  │█
  66.                └────────────────────────────────────────────────┘█
  67.                 ██████████████████████████████████████████████████
  68.  
  69. If you have problems with this program, or want to send comments, manual correc-
  70. tions, or enhancement suggestions, you may call or mail them to:
  71.  
  72.           Micrometric
  73.           98 Dade Avenue
  74.           Sarasota, FLorida  34232-1609  USA
  75.  
  76.           Tech Support  . .   (813) 377-2515
  77.           FAX . . . . . . .   (813) 377-2091
  78.           Support BBS . . .   (813) 371-2490
  79.  
  80. The Micrometric Software Support BBS provides availability and technical support
  81. for  the Micrometric ■■■■-MAN series  of shareware programs.  First time callers
  82. have  access to the  board and  can leave  messages or  download replies/current
  83. shareware  releases. Registered  users may  also download  the latest  Beta test
  84. software releases, when available.
  85.  
  86. Additionally,  you can  send routed  E-Mail via  the RIME(tm)  network to  David
  87. Groome at the  ->ACTION node in the ASP, Laser, Batch, Common, or Shareware con-
  88. ferences. I also check CompuServe (71631,744), but only on an infrequent basis.
  89.  
  90. PKZIP, PKUNZIP and PKSFX are trademarks of PKWARE, Inc.
  91. MS-DOS is a registered trademark of the Microsoft Corporation. 
  92. IBM PC, XT, AT and PC-DOS are registered trademarks of the IBM Corporation.
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106. 2
  107.  
  108.  
  109.                                                                TABLE OF CONTENTS
  110.  
  111.  
  112. INTRODUCTION  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .    5
  113.    Major Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . .    5
  114.    System Requirements  . . . . . . . . . . . . . . . . . . . . . . . . . .    5
  115.    Manual Format  . . . . . . . . . . . . . . . . . . . . . . . . . . . . .    5
  116.       Page layout . . . . . . . . . . . . . . . . . . . . . . . . . . . . .    5
  117.       Brackets and parentheses  . . . . . . . . . . . . . . . . . . . . . .    5
  118.       Computer key conventions  . . . . . . . . . . . . . . . . . . . . . .    5
  119.       Action steps  . . . . . . . . . . . . . . . . . . . . . . . . . . . .    5
  120.       ■■■■-MAN programs . . . . . . . . . . . . . . . . . . . . . . . . . .    5
  121.       Shareware distributed documentation manual  . . . . . . . . . . . . .    6
  122.    Shareware  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .    6
  123.  
  124. INSTALLING THE SYSTEM   . . . . . . . . . . . . . . . . . . . . . . . . . .    9
  125.    From a Diskette Vendor . . . . . . . . . . . . . . . . . . . . . . . . .    9
  126.    From a BBS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .    9
  127.    Registered Version . . . . . . . . . . . . . . . . . . . . . . . . . . .    9
  128.  
  129. RUNNING PATH-MAN  . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   15
  130.    FileName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   15
  131.    Option . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   15
  132.    Operation  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   15
  133.    ERRORLEVEL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   15
  134.    Shareware message  . . . . . . . . . . . . . . . . . . . . . . . . . . .   16
  135.    Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   16
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.                                                                                3
  165.  
  166.            TABLE OF CONTENTS                          PATH-MAN Version 1.1
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222. 4
  223.  
  224.  
  225.                                                                     INTRODUCTION
  226.  
  227. PATH-MAN  is a  utility that searches  the directory  path elements  of the PATH
  228. statement for a given file. The search  file name may include DOS wildcard char-
  229. acters. The ERRORLEVEL variable is set, based on the results of this  search, to
  230. allow more user  friendly batch files - a graceful exit  can be made when needed
  231. data files  or programs are missing.  Optionally, the path element  on which the
  232. search file is located may be displayed. 
  233.  
  234. Major Features  
  235.  
  236. *  Searches  the directory  path elements  of the current  PATH statement  for a
  237.    given file.
  238. *  Sets the ERRORLEVEL variable, based  on the results of this search,  to allow
  239.    more user friendly batch files - a graceful exit can be made when needed data
  240.    files or programs are missing.
  241. *  Optional display of the  first path element on which the  search file name is
  242.    found.
  243. *  DOS wildcard characters of * and ? may be used in the search file name.
  244. *  Small size and fast operation.
  245.  
  246. System Requirements  
  247.  
  248. PATH-MAN will run on an  IBM PC, XT, AT or true compatibles. It  has been tested
  249. with PC-DOS/MS-DOS operating systems, version 3.0 through version 5.0.
  250.  
  251. Manual Format  
  252.  
  253. This manual is divided  into several introductory chapters followed  by chapters
  254. for operating PATH-MAN. The  format of these chapters  and the information  pre-
  255. sented therein has been standardized using the following conventions.
  256.  
  257. Page layout - Each page has a header detailing  the chapter and the program ver-
  258. sion covered. A footer displays the manual page number.
  259.  
  260. Brackets and  parentheses - Brackets, [...], are  used in the manual  and in the
  261. help  screens to  specify what  should  be entered  in response  to the  current
  262. prompt.  If a character string is to be entered, the type of character is noted,
  263. such as ALPHA, NUMERIC, ANY, etc. Parentheses, (..), are used for comments.
  264.  
  265. Computer key  conventions - Keys  specified in the  manual text that are  not in
  266. entry  brackets are shown as reversed, such  as  ESCAPE . All key references are
  267. in capital letters for clarity.
  268.  
  269. Action steps -  Some procedures may  require selection from  a menu of  options,
  270. inputting data or following a sequence of steps. Most manual sections will first
  271. give  an overview of the  function or task under discussion  and then detail the
  272. various action operating procedures. In order to make this manual  easier to use
  273. a symbol, -> , marks the beginning of each of these action operating procedures.
  274.  
  275. ■■■■-MAN programs  - The general group  of shareware programs  by Micrometric is
  276. referred to by the name ■■■■-MAN. It may also be used in reference to a specific
  277. program in that group.
  278.  
  279.  
  280.                                                                                5
  281.  
  282.            INTRODUCTION                               PATH-MAN Version 1.1
  283.  
  284. Shareware  distributed documentation manual - The documentation file included on
  285. the shareware distribution diskette contains the same information as the printed
  286. and bound manual,  supplied as part  of registration,  with two exceptions,  the
  287. result of  the word processor, formatting,  and printer used. The  first is that
  288. all of  the control display characters  (ASCII 1-31) and the  reverse print key-
  289. board codes are NOT  shown properly. Finally, bolding, underlining,  and special
  290. symbols are NOT present.
  291.  
  292. Shareware  
  293.  
  294. PATH-MAN is being distributed  as SHAREWARE. The SHAREWARE concept  allows users
  295. to examine a program  on a trial basis, at  no (or minimal) charge,  before pur-
  296. chasing  it. In addition,  by decreasing  marketing costs,  professional quality
  297. software may be distributed for a fraction  of the cost of a comparable  commer-
  298. cial  product. Regardless of whether you  register the program, please help dis-
  299. tribute PATH-MAN by sharing unmodified copies of it and its files with others.
  300.  
  301. You are hereby granted the right  to use the PATH-MAN program for a  thirty (30)
  302. day  evaluation period. If  you find PATH-MAN  of value, and continue  to use it
  303. after  this evaluation period,  YOU MUST  REGISTER YOUR  PROGRAM USE.  This will
  304. provide you with:
  305.  
  306.    *  A 7" x 8 1/2" printed and bound manual.
  307.    *  PATH-MAN phone or mail support for one year.
  308.    *  Notification of the next PATH-MAN release.
  309.    *  Ability to suppress the  shareware registration reminder message displayed
  310.       at the end of the program.
  311.    *  An installation/update/registration branding program.
  312.    *  Sincere thanks for your support of the SHAREWARE concept.
  313.  
  314. A Single System Program Registration  entitles the user to unlimited use  of the
  315. PATH-MAN program on a single computer. 
  316.  
  317. A Site  License Program Registration entitles  the user to unlimited  use of the
  318. PATH-MAN program on  all computers,  including networks, at  a single  corporate
  319. location.
  320.  
  321. Program Registration, Single System . . . . . $15.
  322.   Includes latest version diskette and manual
  323. Program Registration, Site License  . . . .  $150.
  324.   Includes latest version diskette and manual
  325. Latest Version Diskette only  . . . . . . . . $10.
  326. Shipping - Surface (for outside of USA/Canada only)$5.
  327. Shipping - Air (for outside of USA/Canada only) $10.
  328. COD and credit card orders, add 5%.
  329. Florida residents, add 7% sales tax.
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338. 6
  339.  
  340.            PATH-MAN Version 1.1                               INTRODUCTION
  341.  
  342. ADDRESS:  Micrometric
  343.           98 Dade Avenue
  344.           Sarasota, FLorida 34232-1609 USA
  345.  
  346. PHONE:    Tech Support  . .   (813) 377-2515
  347.           FAX . . . . . . .   (813) 377-2091
  348.           Support BBS . . .   (813) 371-2490
  349.           Order Line  . . .   (800) 929-0184
  350.  
  351. For ease in program registration, a registration order form is included with the
  352. distribution files.
  353.  
  354. This program is produced by a member of the Association of Shareware Profession-
  355. als (ASP). ASP wants to make sure that the shareware principal works for you. If
  356. you are  unable to  resolve a  shareware-related problem with  an ASP  member by
  357. contacting the member directly,  ASP may be able to help.  The ASP Ombudsman can
  358. help you  resolve a dispute or problem with an  ASP member, but does not provide
  359. technical support for members'  products. Please write to  the ASP Ombudsman  at
  360. 545 Grover Road, Muskegon, MI 49442-9427, send a CompuServe message via easyplex
  361. to ASP Ombudsman 70007,3536, or by FAX to the ASP FAX number: (616) 788-2765. In
  362. communications with the Ombudsman  please include a telephone number  and/or FAX
  363. if available.
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.                                                                                7
  397.  
  398.            INTRODUCTION                               PATH-MAN Version 1.1
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454. 8
  455.  
  456.  
  457.                                                          INSTALLING THE SYSTEM  
  458.  
  459. From a Diskette Vendor  
  460.  
  461. If  the PATH-MAN program  has been obtained  from a diskette  vendor, you should
  462. follow  any of their instruction on unpacking/installing the programs (if indeed
  463. they have separate instructions.) The  program, and its files, is  normally sup-
  464. plied  as a self extracting  file whose name is "PATH@xxx.EXE"  (xxx is the ver-
  465. sion, such as "PATH@100").
  466.  
  467. This file  should first be copied to a directory  on your hard disk. This direc-
  468. tory may be a new  one, such as one  named "PATH", and created specifically  for
  469. PATH-MAN, or a  current one, such as  "UTILITY", that has  other programs/files.
  470. For information on creating a separate directory, see your DOS manual.
  471.  
  472.  NOTE    FOR BEST OPERATION, ALL  REQUIRED PATH-MAN FILES *SHOULD* BE  PLACED ON
  473.          PATH REFERENCED SUBDIRECTORIES!
  474.  
  475. Once the file is copied  to the desired hard  disk directory, at the DOS  prompt
  476. change to  this  drive directory,  and then  type  the EXE  file  name (such  as
  477. "PATH@100") and press  ENTER . This will unpack all of the PATH-MAN files.
  478.  
  479. From a BBS  
  480.  
  481. If the PATH-MAN file  was downloaded from a  Bulletin Board, it should  first be
  482. copied to a directory as  defined above, and then unpacked, using  whatever pro-
  483. gram is specified by the  Bulletin Board. It is normally distributed with a name
  484. of "PATH@vvv.ZIP" (vvv is the version) or "PATHMN.ZIP".
  485.  
  486. Registered Version  
  487.  
  488. Registered users should use the program "INSTALL", that  is supplied upon regis-
  489. tration. This program will create a registration file which will,  in turn, sup-
  490. press the shareware registration reminders.
  491.  
  492. -> To install PATH-MAN on your hard disk, follow the steps detailed below:
  493.  
  494.    1. Place the PATH-MAN distribution diskette in your floppy diskette drive.
  495.  
  496.    2. At the DOS prompt, change to  the drive in which the distribution diskette
  497.       is located. For example, if the diskette  was placed in drive A, type   A 
  498.        :  and press  ENTER .
  499.  
  500.    3. Type  I   N   S   T   A   L   L  and press  ENTER . The  installation pro-
  501.       gram will then be loaded, and its display should be as shown below.
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.                                                                                9
  513.  
  514.            INSTALLING THE SYSTEM                      PATH-MAN Version 1.1
  515.  
  516. ╒═╡ INSTallation MANagement Program/One System   Started at═>07-31-92 03:00 ╞═╕ 
  517. │░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│ 
  518. │░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│ 
  519. │░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│ 
  520. │░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│ 
  521. │░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│ 
  522. │░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│ 
  523. │░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│ 
  524. │░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│ 
  525. │░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│ 
  526. │░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│ 
  527. │░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│ 
  528. │░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│ 
  529. │░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│ 
  530. │░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│ 
  531. │░     ░░▄    ░░▄   ░░▄░░░░░░░░▄░░░░░░░░▄         ░░▄   ░░▄   ░░▄   ░░▄   ░░▄░│ 
  532. │░  Ç═ ░░█    ░░░▄  ░░█░░█▀▀▀▀▀▀ ▀▀░░█▀▀▀   ░░▄   ░░░▄ ░░░█  ░░░░▄  ░░░▄  ░░█░│ 
  533. │░ ┌┼┐ ░░█    ░░█░░▄░░█░░░░░░░░▄   ░░█     ░░░█   ░░░█ ░░░█ ░░█▀░░▄ ░░█░░▄░░█░│ 
  534. │░ ┌┴┐ ░░█    ░░█ ▀░░░█ ▀▀▀▀▀░░█   ░░█      ░░█   ░░█░░▄░░█ ░░░░░░█ ░░█ ▀░░░█░│ 
  535. │░═┴═┴═░░█    ░░█   ░░█░░░░░░░░█   ░░█     ░░░░▄  ░░█░░█░░█░░█▀▀▀░░▄░░█   ░░█░│ 
  536. │░      ▀▀     ▀▀    ▀▀ ▀▀▀▀▀▀▀▀    ▀▀      ▀▀▀▀   ▀▀ ▀▀ ▀▀ ▀▀    ▀▀ ▀▀    ▀▀░│ 
  537. ╘╡ INSTALL/1 Version 3.00 Copyright 1990-92 Micrometric, All Rights Reserved ╞╛ 
  538. F1>Help│ESC>Exit│ENTER/[char]>Select│  HomeEnd│                                 
  539.  
  540.     NOTE    Context sensitive help is available from this point in the installa-
  541.             tion program on, by pressing the  F1  key. 
  542.  
  543.    4. If a color video card is detected, the following prompt will be displayed.
  544.                     ┌──────────────────────────────────────┐
  545.                     │ ╔═╡ Color Monitor Card Detected ╞═╗  │
  546.                     │ ║ Use the color display           ║█ │
  547.                     │ ║ Force a monochrome display      ║█ │
  548.                     │ ╚═════════════════════════════════╝█ │
  549.                     │  ███████████████████████████████████ │
  550.                     └──────────────────────────────────────┘
  551.  
  552.       -> If your system has a color monitor, press  U .
  553.       -> If your system has a monochrome or LCD display, press  F .
  554.  
  555.    5. A selection list of all path referenced directories is next displayed.
  556.  
  557.     NOTE    FOR BEST OPERATION, ALL  REQUIRED PATH-MAN FILES *SHOULD* BE  PLACED
  558.             ON PATH REFERENCED SUBDIRECTORIES!
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570. 10
  571.  
  572.            PATH-MAN Version 1.1                      INSTALLING THE SYSTEM
  573.  
  574.                  ┌────────────────────────────────────────────┐
  575.                  │ ┌─┤ Select the INSTALLATION DIRECTORY ├─┐  │
  576.                  │ │ C:\BAT                                │█ │
  577.                  │ │ C:\DOS-500                            │█ │
  578.                  │ │ C:\UTILITY                            │█ │
  579.                  │ │ C:\ZIP                                │█ │
  580.                  │ │ C:\                                   │█ │
  581.                  │ │ User Defined Drive-Directory Path     │█ │
  582.                  │ └───────────────────────────────────────┘█ │
  583.                  │  █████████████████████████████████████████ │
  584.                  └────────────────────────────────────────────┘
  585.  
  586.       -> To cancel the installation program at this point, press  ESCAPE .
  587.       -> To select one  of the path referenced  directories on which to  install
  588.          PATH-MAN, move the highlight bar to the desired one and press  ENTER .
  589.       -> To  specify  a  non-path  referenced  directory  on  which  to  install
  590.          PATH-MAN, press  U  and then press  ENTER . A data entry window for the
  591.          installation path will then be displayed, as shown below (with an exam-
  592.          ple path already entered).  Enter the desired drive and  directory path
  593.          on which to install PATH-MAN,  using the control keys described on  the
  594.          bottom help line.
  595.    ┌────────────────────────────────────────────────────────────────────────┐
  596.    │ ┌─┤ Enter Path ├────────────────────────────────────────────────────┐  │
  597.    │ │ C:\PATH.......................................................... │█ │
  598.    │ └───────────────────────────────────────────────────────────────────┘█ │
  599.    │  █████████████████████████████████████████████████████████████████████ │
  600.    └────────────────────────────────────────────────────────────────────────┘
  601.  
  602.          -> To cancel defining the path, press  ESCAPE . The program will return
  603.             to directory selection.
  604.          -> To  accept the path  as entered  and edited,  press  ENTER .  If the
  605.             specified directory does not  currently exist, the following message
  606.             will be displayed.
  607.      ┌────────────────────────────────────────────────────────────────────┐
  608.      │ ┌─┤ MESSAGE ├───────────────────────────────────────────────────┐  │
  609.      │ │ The drive-directory path as entered DOES NOT currently exist. │█ │
  610.      │ │ This directory WILL NOW BE created.                           │█ │
  611.      │ └───────────────────────────────────────────────────────────────┘█ │
  612.      │  █████████████████████████████████████████████████████████████████ │
  613.      └────────────────────────────────────────────────────────────────────┘
  614.  
  615.             -> To cancel creation of this directory, press  ESCAPE .
  616.             -> To create the  specified directory, press  ENTER .  If the speci-
  617.                fied drive  is invalid or the  requested installation directory's
  618.                parent  does not exist, an error message will be displayed. Press
  619.                any key, and then re-edit the installation path.
  620.  
  621.    6. If more than one system is available for installation, a SYSTEM TO INSTALL
  622.       selection menu will be displayed, as shown below.
  623.  
  624.  
  625.  
  626.  
  627.  
  628.                                                                               11
  629.  
  630.            INSTALLING THE SYSTEM                      PATH-MAN Version 1.1
  631.  
  632.      ┌─────────────────────────────────────────────────────────────────────┐
  633.      │ ╔═══╡ Select the SYSTEM TO INSTALL ╞═════════════════════════════╗  │
  634.      │ ║ ENVI-MAN  Environment data summary, environ. space remaining   ║█ │
  635.      │ ║ FILE-MAN  Menu driven DOS file manager, directory tree         ║█ │
  636.      │ ║ LASR-MAN  Print text files on a laser printer, 36 print styles ║█ │
  637.      │ ║ MENU-MAN  Display custom user selection menus from batch files ║█ │
  638.      │ ║ PATH-MAN  Determines if a file is on a PATH directory          ║█ │
  639.      │ ╚════════════════════════════════════════════════════════════════╝█ │
  640.      │  ██████████████████████████████████████████████████████████████████ │
  641.      └─────────────────────────────────────────────────────────────────────┘
  642.  
  643.       -> To terminate the installation program at this point, press  ESCAPE .
  644.       -> To select the  SYSTEM TO INSTALL, press its highlighted  letter or move
  645.          the highlight bar to in with the arrow keys and press  ENTER .
  646.  
  647.    7. A list of all PATH-MAN files is next displayed, along with an INSTALLATION
  648.       FUNCTION menu. The normal sequence of operations is to first "Install" the
  649.       PATH-MAN program and files, and then "Brand" the system with your name and
  650.       serial number.
  651.          ┌─────────────────────────────────────────────────────────────┐
  652.          │ ╒═╡ Select the INSTALLATION FUNCTION ╞═══════════════════╕  │
  653.          │ │ Install system     Brand system       eXit             │█ │
  654.          │ ╘════════════════════════════════════════════════════════╛█ │
  655.          │  ██████████████████████████████████████████████████████████ │
  656.          └─────────────────────────────────────────────────────────────┘
  657.  
  658. ┌──────────────────────────────────────────────────────────────────────────────┐
  659. │╒═╡ File Name   Status  Hard Disk Path/File Description    PATH-MAN FILES ╞═╕ │
  660. ││ System═>PATH-MAN      Determines if a file is on a PATH directory         │█│
  661. ││ PATH-MAN.COM  PROCESS Utility program                                     │█│
  662. ││ YYYY.YYY      PROCESS Other files                                         │█│
  663. │╘═╡ INSTALLATION PATH═>C:\PATH ╞════════════════════════════════════════════╛█│
  664. │ █████████████████████████████████████████████████████████████████████████████│
  665. └──────────────────────────────────────────────────────────────────────────────┘
  666.  
  667.       -> To install PATH-MAN on the hard  disk, insure that the highlight bar is
  668.          on the "INSTALL SYSTEM" FUNCTION and press  ENTER . Each of the file(s)
  669.          will be copied to the selected installation drive-directory. 
  670.  
  671.           NOTE    A  happy face symbol after any of  the system's file names de-
  672.                   notes that this  file is already on the hard  disk. During in-
  673.                   stallation it  will be  replaced, on  the  directory where  it
  674.                   currently resides, not the INSTALLATION DRIVE-DIRECTORY PATH.
  675.  
  676.          When all files have been copied to the hard  disk, a copy complete mes-
  677.          sage is displayed.
  678.  
  679.  
  680.  
  681.  
  682.  
  683.  
  684.  
  685.  
  686. 12
  687.  
  688.            PATH-MAN Version 1.1                      INSTALLING THE SYSTEM
  689.  
  690.         ┌───────────────────────────────────────────────────────────────┐
  691.         │ ┌─┤ MESSAGE ├──────────────────────────────────────────────┐  │
  692.         │ │ FILE COPY COMPLETED.                                     │█ │
  693.         │ │ All of the required BOOK-IT! files are on the hard disk. │█ │
  694.         │ │ ═══> BOOK-IT! IS READY TO RUN. <═══                      │█ │
  695.         │ └──────────────────────────────────────────────────────────┘█ │
  696.         │  ████████████████████████████████████████████████████████████ │
  697.         └───────────────────────────────────────────────────────────────┘
  698.  
  699.          -> To cancel the installation at this point, press  ESCAPE .
  700.          -> To  continue with the installation,  press any other  key. The high-
  701.             light bar will then be on the "BRAND SYSTEM" FUNCTION.
  702.  
  703.    8. -> To brand  the system with your  name and serial number,  move the high-
  704.          light bar to the "BRAND SYSTEM" FUNCTION and press  ENTER . A REGISTRA-
  705.          TION INFORMATION data entry  window will be displayed, as  shown below,
  706.          with sample data already entered. 
  707.  
  708.           NOTE    This  step is REQUIRED for PATH-MAN to be registered. Also, if
  709.                   you  move the  PATH-MAN files  to another  drive-directory you
  710.                   will need to "BRAND" the system again.
  711.  
  712.          Enter your company and/or  your name, and then the  system registration
  713.          number. Your  registration number is located  on the back of  the front
  714.          cover of this manual.
  715.                   ┌──────────────────────────────────────────┐
  716.                   │ ┌─┤ REGISTRATION INFORMATION ├────────┐  │
  717.                   │ │ Name ABC COMPANY, George Jones      │█ │
  718.                   │ │ Registration number 12345678        │█ │
  719.                   │ └─────────────────────────────────────┘█ │
  720.                   │  ███████████████████████████████████████ │
  721.                   └──────────────────────────────────────────┘
  722.  
  723.          -> To accept either  the name  or registration number  after entry  and
  724.             editing, press  ENTER . A message will be displayed after the regis-
  725.             tration number  is entered. It's  contents are dependent  on whether
  726.             the registration number is valid. Both messages are shown below.
  727.                 ┌───────────────────────────────────────────────┐
  728.                 │ ┌─┤ MESSAGE ├──────────────────────────────┐  │
  729.                 │ │ BOOK-IT! serial number entered is VALID. │█ │
  730.                 │ └──────────────────────────────────────────┘█ │
  731.                 │  ████████████████████████████████████████████ │
  732.                 └───────────────────────────────────────────────┘
  733.  
  734.                ┌─────────────────────────────────────────────────┐
  735.                │ ┌─┤ MESSAGE ├────────────────────────────────┐  │
  736.                │ │ BOOK-IT! serial number entered is INVALID! │█ │
  737.                │ │ Please try again.                          │█ │
  738.                │ └────────────────────────────────────────────┘█ │
  739.                │  ██████████████████████████████████████████████ │
  740.                └─────────────────────────────────────────────────┘
  741.  
  742.  
  743.  
  744.                                                                               13
  745.  
  746.            INSTALLING THE SYSTEM                      PATH-MAN Version 1.1
  747.  
  748.             -> To  continue with the installation program, press any key. If the
  749.                registration number was valid,  the "EXIT" option is highlighted.
  750.                If it was invalid, select the "BRAND SYSTEM" option again.
  751.  
  752.    9. -> To exit from the  installation program, move  the highlight bar to  the
  753.          "EXIT"  FUNCTION and  press  ENTER .  If the  system has  been properly
  754.          branded, the program will exit,  and PATH-MAN is ready for use.  If the
  755.          system has  not been branded, an  error message is displayed,  as shown
  756.          below.
  757.        ┌─────────────────────────────────────────────────────────────────┐
  758.        │ ┌─┤ MESSAGE ├────────────────────────────────────────────────┐  │
  759.        │ │ This system has not been 'BRANDED'.                        │█ │
  760.        │ │ In order to be registered, it must first be 'BRANDED'!     │█ │
  761.        │ │ To exit without BRANDING, press ESCAPE.                    │█ │
  762.        │ │ To continue with the INSTALL program, press any other key. │█ │
  763.        │ └────────────────────────────────────────────────────────────┘█ │
  764.        │  ██████████████████████████████████████████████████████████████ │
  765.        └─────────────────────────────────────────────────────────────────┘
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.  
  797.  
  798.  
  799.  
  800.  
  801.  
  802. 14
  803.  
  804.  
  805.                                                                RUNNING PATH-MAN 
  806.  
  807. The syntax to execute the PATH-MAN utility program is: 
  808.  
  809.    PATH-MAN FileName[option]
  810.  
  811. A space MUST be present after  the program name and before the  FileName parame-
  812. ter. A space MUST  NOT be placed between the  FileName and the option, if  it is
  813. present.
  814.  
  815. FileName  
  816.  
  817. The file name  to be found follows the standard DOS  conventions, with a maximum
  818. of  eight characters for  the file name  and three characters  for the extension
  819. with a '.' separator. The DOS wildcard characters  of ? and * may be used. If no
  820. extension is specified, the match will be on name with all extensions matching.
  821.  
  822. Option  
  823.  
  824. If  the FileName is  followed by a  '?' character, the program  will display the
  825. search  results. If  a matching file  is found, a  message with the  path of the
  826. FIRST matching file is  displayed. If no matching file is  found, a message with
  827. the FileName  searched for is displayed.  In both cases the  ERRORLEVEL value is
  828. also displayed.
  829.  
  830. NOTE: A '?' at the  end of the FileName[option] is  always treated as an  option
  831.       rather that a DOS wildcard '?'.
  832.  
  833. Operation  
  834.  
  835. PATH-MAN searches the path  directory elements referenced in the  PATH statement
  836. in the order in which they appear. For example, with the PATH statement -
  837.  
  838.    PATH=[D1:Path1][D2:Path2][...]
  839.  
  840. the path element D1:Path1 is searched first followed by D2:Path2. If  a match is
  841. found, the search is terminated and the ERRORLEVEL variable is set.
  842.  
  843. ERRORLEVEL  
  844.  
  845. The ERRORLEVEL variable is set based on the results of the search for FileName. 
  846.  
  847. If  a match to FileName  is found on  any of the path  directory elements of the
  848. PATH statement, ERRORLEVEL is set to the ordinal number of the Dx:Pathx  path on
  849. which the file is  found. This number may range  from one to the number  of ele-
  850. ments in the PATH statement.
  851.  
  852. If PATH-MAN is not present or FileName is NOT found on any of the path directory
  853. elements of the PATH statement, ERRORLEVEL is set to 0.
  854.  
  855. NOTE: PATH-MAN's  use of the ERRORLEVEL variable is  the inverse of many (if not
  856.       most) programs: a zero ERRORLEVEL is bad and a non-zero value is good. The
  857.       main reasons  for this is to assure that PATH-MAN.COM is present and allow
  858.       the path element number to be passed to the batch file.
  859.  
  860.                                                                               15
  861.  
  862.            RUNNING PATH-MAN                           PATH-MAN Version 1.1
  863.  
  864. Shareware message  
  865.  
  866. A shareware message  may be randomly displayed at the  end of PATH-MAN. Pressing
  867. any key will exit the program. By registering your  use of PATH-MAN, you will be
  868. able to use the  registration serial number  to suppress this shareware  message
  869. display.
  870.  
  871. Examples  
  872.  
  873. For the purpose of these examples, assume that only files  PATH-MAN.COM, XYZ.COM
  874. and ABC.COM are on PATH directories.
  875.  
  876. Batch file code segment examples -
  877.  
  878.    File found -
  879.          ...
  880.          PATH-MAN ABC.COM
  881.             [errorlevel set to 1]
  882.          IF ERRORLEVEL 1 GOTO RUN
  883.          ECHO PROGRAM ABC.COM IS MISSING!
  884.          GOTO EXIT
  885.          ...
  886.          :RUN
  887.             [batch file branches to this point]
  888.          ...
  889.          :EXIT
  890.  
  891.  
  892.    File not found -
  893.          ...
  894.          PATH-MAN CBA.COM
  895.             [errorlevel set to 0]
  896.          IF ERRORLEVEL 1 GOTO RUN
  897.             [batch file continues here]
  898.          ECHO PROGRAM CBA.COM IS MISSING!
  899.          GOTO EXIT
  900.          ...
  901.          :EXIT
  902.  
  903. Command line code examples -
  904.  
  905.          For -          PATH-MAN XYZ.COM?
  906.          a display of -    Found═>[path]\XYZ.COM
  907.                         ERRORLEVEL═>1
  908.  
  909.          For -          PATH-MAN XYZ.*?
  910.          a display of -    Found═>[path]\XYZ.COM
  911.                         ERRORLEVEL═>1
  912.  
  913.          For -          PATH-MAN XYZ.A*?
  914.          a display of -    Not Found═>XYZ.A*
  915.                         ERRORLEVEL═>1
  916.  
  917.  
  918. 16
  919.