home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-387-Vol-3of3.iso / o / os2_util.zip / SUBSTP.ZIP / SUBSTP.DOC < prev   
Text File  |  1992-03-07  |  9KB  |  195 lines
  1. SUBST for OS/2, Version 0.01, Sat  03-07-1992
  2. ---------------------------------------------
  3.  
  4. Bugfixes:
  5.  
  6.     - Version 0.00 would only allow a dozen or so files to be opened at
  7.       the same time.  This caused problems with programs such as
  8.       QuickHelp,  which leaves open many files.  This version will allow
  9.       approximately 500 files to be open at the same time.
  10.  
  11.     - Long file names were not supported for all APIs (oops!).    This
  12.       has been fixed.
  13.  
  14. Features:
  15.  
  16.     - OS/2 2.00 support.  Only beta version 6.304 of OS/2 2.00 has
  17.       been tested.
  18.  
  19. Packing list:
  20.  
  21.     Substp.doc     - This document
  22.     sub_120.LZH  - Subst IFS kit for OS/2 1.2, 1.3.
  23.     sub_200.LZH  - Subst IFS kit for OS/2 2.00
  24.     qdisk.exe     - A simple command line utility which tells you which
  25.            file system is attached to each drive letter.
  26.  
  27.  
  28. SUBST for OS/2, Version 0.00, Tue  04-30-1991
  29. ---------------------------------------------
  30.  
  31. This program was written as an exercise to learn about IFS's
  32. (Installable File Systems).  It provides the same function as the
  33. old DOS command: SUBST.   It is not a considered a completed
  34. product,  and may not be of the same quality as other A:WARE Inc.
  35. products.  Although it is the property of A:WARE Inc,  there is no
  36. charge for the use of this program.
  37.  
  38. The program is broken into four parts:
  39.  
  40. SUBSTFSD.IFS  -- The FSD (File System Driver) which must be
  41.                  installed in CONFIG.SYS with the IFS= statement.
  42.  
  43. USUBST.DLL    -- This is provided to conform to the IFS
  44.                  specification.  Each FSD is supposed to supply a
  45.                  DLL that is named "U<file system name>.DLL",  to
  46.                  support CHKDSK, FORMAT, etc.  UHPFS.DLL and
  47.                  ULAN.DLL are other examples.
  48.  
  49.                  USUBST.DLL simply prints a message saying that "The
  50.                  SUBST file system does not support the XXXXX
  51.                  command."   It is not a required part of the SUBST
  52.                  system.  You can loose it if you want. :-).
  53.  
  54. SUBSTHST.EXE  -- The file system host program,  which must be
  55.                  running at all times to use SUBSTituted drives.  It
  56.                  can be started in one of three ways:
  57.  
  58.                  1) RUN=SUBSTHST.EXE in config.sys
  59.                  2) DETACH SUBSTHST
  60.                  3) START SUBSTHST
  61.  
  62.                  The third method will allow you to see any messages
  63.                  the program may display.  Starting it with the /v
  64.                  (verbose) switch causes it to print out a LOT of
  65.                  information (this also causes it to run more
  66.                  slowly).   If you experience a problem,  running it
  67.                  with the /v switch may help discover where the
  68.                  problem is.
  69.  
  70.                  This program may be terminated at any time (with
  71.                  ^C, for example) and restarted.  When it
  72.                  terminates, it automatically detaches all of the
  73.                  drives attached to it.
  74.  
  75. SUBSTP.EXE   -- The program you use to do the substitutions
  76.                 (attaches).  It has the same syntax as the DOS SUBST
  77.                 command:
  78.  
  79. ┌─────────────────────────────────────────────────────────────────────────────┐
  80. │substp [[drive1: drive2:path]|[drive1: /d]]                                  │
  81. │                                                                             │
  82. │Temporarily substitutes a drive letter for another drive letter and          │
  83. │directory path. While a substitution is in effect, MS OS/2 regards any       │
  84. │reference to drive1 as a reference to drive2:path.                           │
  85. │                                                                             │
  86. │Parameters   Description                                                     │
  87. │ ─────────────────────────────────────────────────────────────────────────── │
  88. │drive1:      Specifies the drive letter you want to substitute for a         │
  89. │             directory on drive2.                                            │
  90. │                                                                             │
  91. │drive2:path  Specifies the drive and path of the directory for which you     │
  92. │             want to substitute drive1.                                      │
  93. │                                                                             │
  94. │/d           Deletes an existing substitution. You must specify drive1 to    │
  95. │             identify which substitution is to be deleted, but you must not  │
  96. │             specify drive2:path with the /d option.                         │
  97. │                                                                             │
  98. │Comments                                                                     │
  99. │                                                                             │
  100. │If you type subst by itself, the utility displays the substitutions          │
  101. │currently in effect.                                                         │
  102. │                                                                             │
  103. │The following utilities do not work on a drive you have substituted for a    │
  104. │directory on another drive:                                                  │
  105. │                                                                             │
  106. │    backup                                                                   │
  107. │    chkdsk                                                                   │
  108. │    diskcomp                                                                 │
  109. │    diskcopy                                                                 │
  110. │    fdisk                                                                    │
  111. │    format                                                                   │
  112. │    label                                                                    │
  113. │    recover                                                                  │
  114. │    restore                                                                  │
  115. └─────────────────────────────────────────────────────────────────────────────┘
  116.  
  117. Caveats:
  118. --------
  119.  
  120. DosFindNotifyFirst(),  DosFindNotifyNext() and DosFindNotifyClose()
  121. are not supported.   These functions are not yet documented by IBM
  122. or MS,  but perhaps they will be soon.
  123.  
  124. Direct disk access via DosDevIOCtl() is not supported.  It doesn't
  125. really make sense to support it.
  126.  
  127. A SUBSTed drive has all of the properties and limitations of a LAN
  128. drive;  in fact,  OS/2 thinks it is a "remote" drive.
  129.  
  130. Do not try to use a drive letter that is already being used by the
  131. DOS BOX subst command.  This will probably cause a system crash.
  132. Instead,  use only this program -- although the DOS BOX can't run
  133. SUBSTP.EXE,  it DOES have access to all of the drives SUBSTed by an
  134. OS/2 session.
  135.  
  136. DISCLAIMER
  137. ----------
  138. The Program is supplied "AS IS" without any warranty of any kind,
  139. either expressed or  implied,  including, but not limited to, the
  140. implied warranties of merchantabilty and fitness for a particular
  141. purpose.
  142.  
  143. In  no  event  shall A:WARE INC be liable for any damages, either
  144. direct or  consequential,  caused by the use, or inability to use,
  145. this program, even  if A:WARE INC has been advised of the
  146. possibility of such damages.
  147.  
  148. WARRANTY
  149. --------
  150. This program has no warranty.  It is a completely unsupported
  151. product.  Bug reports/suggestions will be listened to,  but not
  152. necessarily acted upon.
  153.  
  154.                         --------
  155.  
  156. The FSD code runs in "kernel protect mode" (ring 0).  If there is a
  157. bug in it,  you'll get the dreaded register dump and "The system
  158. detected an internal processing error at xxxx:yyyy.  The system is
  159. stopped".   Only one code segment is used by this FSD,  so it will
  160. be easy to find out if this program is to blame if your system
  161. crashes.   If the CS register is equal to the value that
  162. SUBSTHST.EXE displays when it is first started,  then SUBSTFSD.IFS
  163. caused the crash.  Note that the CS value is displayed in the
  164. register dump,  NOT in the 'xxxx' in the message "The system
  165. detected an internal processing error at xxxx:yyyy."
  166.  
  167. Neither of the two *.EXE programs supplied are capable of crashing
  168. the system,  since they run at Ring 3.
  169.  
  170. Performance
  171. -----------
  172. Using a SUBSTed drive is slower than using one that isn't.  For most
  173. programs,  you probably won't notice.  If you were to write a bench
  174. test that very rapidly opened and closed a file 500 times,  then you
  175. might notice the difference.
  176.  
  177.                         --------
  178.  
  179. Copyright (C) 1991 A:WARE Inc.
  180.  
  181. A:WARE Inc. develops custom OS/2 applications,  device drivers,  and
  182. utilities.
  183.  
  184. Peter Fitzsimmons
  185. A:WARE Inc.
  186. P.O. Box 670
  187. Adelaide St Postal Stn.
  188. Toronto, Canada
  189. M5C 2J8.
  190.  
  191. Voice: (416)858-3222
  192. FidoNet: 1:250/628
  193. BBS: RT-LAB (416)867-9663
  194.  
  195.