 
| NetDrive for OS/2 Version 1.0.1

  (C) COPYRIGHT Blueprint Software Works, Inc. 2000.  ALL RIGHTS RESERVED.

  1. INTRODUCTION
  2. USING NetDrive for OS/2
| 2.1. INSTALLATION, UPGRADE AND SYSTEM REQUIREMENTS
  2.2. USING A RESOURCE
  2.3. UTILITIES
  2.4. REXX LIBRARY
  2.5. SUPPORTED RESOURCES
  2.6. NOTES, RESTRICTIONS AND KNOWN BUGS
  3. ORDERING AND SUPPORT

  
  1. INTRODUCTION
  
  NetDrive for OS/2 is a virtual file system which allows to create a
  virtual volume and mount various resources to the volume.
  Current version of NetDrive for OS/2 supports local, network and FTP
  resources.
  
  2. USING NetDrive for OS/2
  
  2.1. INSTALLATION, UPGRADE AND SYSTEM REQUIREMENTS

  Note: NetDrive will be fully functional for 1 month then it will 
  not allow to write to resources. 
  Please see chapter 3. ORDERING AND SUPPORT for information about
  NetDrive registration.

  System Requirements:
  
    * OS/2 Warp Connect v3.0, Warp 4, Warp Server for e-business v4.5
    * MPTS and TCP/IP
    * High or medium speed Internet connection with cable modems, 
      ADSL, etc. for FTP resources
      
  The NetDrive for OS/2 installation package contains the following files:

| ndreg.cmd      - registration script
  doc\readme     - brief information on NetDrive for OS/2
  doc\version    - revision history of NetDrive for OS/2
  doc\netdrive.txt - this file
  doc\ndrexx.txt - NetDrive REXX API description
  ndctl.exe      - control program
  ndctl.cfg      - control program configuration file
  ndfs.ifs       - file system driver
  ndcalls.dll    - interface dll 
  ndcheck.exe    - utility for testing if ndctl is running
  ndwait.exe     - utility for waiting ndctl to run
  ndattach.exe   - utility for attaching drive letter
  nddetach.exe   - utility for detaching drive letter
  ndcreatemp.exe - creates a mountpoint
  nddeletemp.exe - deletes a mountpoint
  ndmount.exe    - utility for mounting a resource
  ndautomnt.exe  - utility for mounting a bunch of resources
  ndunmount.exe  - utility to unmount a resource
  ndgetm.exe     - utility to get mountdata for a mount point
  ndquery.exe    - utility to get some statistics
  ndrefresh.exe  - utility to refresh a mountpoint resource
  doc\samples\attach.cmd - example attaching drive
  doc\samples\detach.cmd - example detaching drive
  doc\samples\local.cmd  - example of mounting disk C:
  doc\samples\hobbes.cmd - example of mounting hobbes.nmsu.edu ftp server
  doc\samples\rexxtest.cmd - example REXX script
  doc\samples\mnt - sample file for ndautomnt utility

  \toolkit       - user's toolkit, sources of utilities
    
  * Installation instructions:
  ____________________________
  
  Copy all files from the distribution package to a directory ( e.g. C:\NDFS ).

  Add the following lines to the CONFIG.SYS:
 
  IFS=C:\NDFS\NDFS.IFS
  RUN=C:\NDFS\NDCTL.EXE

  Add C:\NDFS to LIBPATH and PATH statements.

  Reboot.
  
| * Upgrade instructions:
| _______________________
|  
| If you have a version of NetDrive for OS/2 installed then
| in order to install new version you have to proceed with the 
| following steps:
|  
| 1) rem out the following lines in config.sys:
|  
| IFS=C:\NDFS\NDFS.IFS
| RUN=C:\NDFS\NDCTL.EXE
|  
| Now these lines must look as follows:  
|  
| REM IFS=C:\NDFS\NDFS.IFS
| REM RUN=C:\NDFS\NDCTL.EXE
|  
| 2) reboot the system
|  
| 3) replace old NetDrive's files with new ones
|
| 4) restore lines in config.sys:
|  
| IFS=C:\NDFS\NDFS.IFS
| RUN=C:\NDFS\NDCTL.EXE
|  
| 5) reboot the system
  
  2.2. USING A RESOURCE
  
  In order to use NetDrive for OS/2 both NDFS.IFS and NDCTL.EXE must
  be loaded.
  
  The following steps must be performed to use a resource:
  
  a) create a NDFS volume. This is done by ndattach utility.
     Example: ndattach.exe s:
     
  b) create a mount point which the resource will be mounted to.
     Example: ndcreatemp.exe s:\localc
     
  c) mount the resource to the created mountpoint.
     Example: ndmount.exe local s:\localc c:\ r
              this example mounts local drive c:\ to the 
              s:\localc mountpoint in ReadOnly mode.
     Now the c:\ can be used as s:\local.
     
  d) unmount the resource by ndunmount utility.
     Example: ndunmount.exe s:\localc 0
     
  e) delete the mountpoint.
     Example: nddeletemp.exe s:\localc
     
  f) delete the NDFS volume.
     Example: nddetach s:
  
  2.3. UTILITIES
  
  ndcheck.exe    
  ___________
  
  The utility tests if ndctl is running.
  It sets ERRORLEVEL to 0 if NDCTL is up and running and to 1 otherwise.
  
  Syntax:
  
      ndcheck.exe [period retries]
      
      it queries NDFS.IFS every 'period' seconds 'retries' times
      for NDCTL.EXE state. By default period = 10 (in seconds), 
      retries = 0 that means infinity.
  
      
  ndwait.exe     
  __________
  
  The utility waits ndctl to run.
  
  It sets ERRORLEVEL to 0 if NDCTL is up and running when wait time expires 
  and to 1 otherwise.
  
  Syntax:
  
      ndwait.exe [wait_time retries]
      
      it queries NDFS.IFS every 'wait_time' seconds 'retries' times
      for NDCTL.EXE state. By default wait_time = 10 (in seconds), 
      retries = 3. ( retries = 0 means infinity).
  
  
  ndattach.exe   
  ____________
  
  The utility creates a NDFS volume and assigns a drive letter to it.
  
  It sets ERRORLEVEL to 0 if the volume was successfully created
  and to returned error code otherwise.
  
  Syntax:
  
       ndattach.exe S:
       
       where 'S' is the drive letter to be created.

  
  nddetach.exe   
  ____________
  
  The utility destroys the NDFS volume.
  
  It sets ERRORLEVEL to 0 if the volume was successfully destroyed
  and to returned error code otherwise.
  
  Syntax:
  
       nddetach.exe S:
       
       where 'S' is the drive letter to be detached.

  
  ndcreatemp.exe 
  ______________
  
  The utility creates a mountpoint on an existing NDFS volume.
  
  It sets ERRORLEVEL to 0 if the mountpoint was successfully created
  and to returned error code otherwise.
  
  Syntax:
  
        ndcreatemp.exe path
        
        where path is the mount point to be created.
      
  Example:
    
        ndcreatemp.exe S:\Hobbes
        
  
  nddeletemp.exe 
  ______________
  
  The utility deletes a mountpoint on an existing NDFS volume.
  
  It sets ERRORLEVEL to 0 if the mountpoint was successfully deleted
  and to returned error code otherwise.
  
  Syntax:
  
        nddeletemp.exe path
        
        where path is the mount point to be deleted.
      
  Example:
    
        nddeletemp.exe S:\Hobbes
        
  
  ndmount.exe
  ___________
  
  The utility mounts a resource to a mountpoint on an existing NDFS volume.
  
  It sets ERRORLEVEL to 0 if the resource was successfully mounted
  and to returned error code otherwise.
  
  Syntax:

      ndmount type mountpoint resource flag

      type - type of the resource, see 2.5. SUPPORTED RESOURCES for info on 
             resource types
      mountpoint - the mount point that the resource has to be mounted to,
                   the mount point must exists already.
      resource - resource description, see 2.5. SUPPORTED RESOURCES for 
                 info on resource descriptions
      flag - 'ro' or 'r' for read only access, 'rw' or 'w' for 
             read write access
  
  
  ndautomnt.exe
  _____________
  
  The utility mounts a lot of resources on an existing NDFS drive.
  Resources to be mounted must be described in a text file.
  The file format is as follows:
  
      mountpoint type resource flag
  
  Where 
      mountpoint - the mount point that the resource has to be mounted to,
                   the mount point will be automatically created if it does
                   not exists.
                   Note: mount point must be created level by level.
                         i.e. s:\mp1 must be created before s:\mp1\mp2
      type - type of the resource, see 2.5. SUPPORTED RESOURCES for info on 
             resource types
      resource - resource description, see 2.5. SUPPORTED RESOURCES for 
                 info on resource descriptions
      flag - 'ro' or 'r' for read only access, 'rw' or 'w' for 
             read write access
        
   Example of a line in the file:
       s:\hobbes ftp hobbes.nmsu.edu w
       
   Example of using the utility:
       ndautomnt.exe mnt
       where 'mnt' is the name of the file with mount information.
  
  
  ndunmount.exe  
  _____________
  
  The utility unmounts a resource from a mountpoint.
  
  It sets ERRORLEVEL to 0 if the resource was successfully unmounted
  and to returned error code otherwise.
  
  Syntax:

       ndunmount.exe mountpoint index
       
       where index is the index of resource to be unmounted 
             (0 for all resources)
             
  
  ndgetm.exe     
  __________
  
  The utility to get information about a mount point
  
  It sets ERRORLEVEL to 0 if the information was successfully retrieved
  and to returned error code otherwise.
  
  Syntax:

      ndgetm.exe mountpoint
  
  
  ndquery.exe    
  ___________
  
  The utility gets some statistics from NDFS.IFS.
  
  It sets ERRORLEVEL to 0 if the information was successfully retrieved
  and to returned error code otherwise.
  
  Syntax:
  
|     ndquery.exe [level]
|      
|         where level = 0 ( default ) for information about IFS
|               level = 1 for information about Control Program
  
  
  ndrefresh.exe  
  _____________
  
  The utility sends refresh command to a resource mounted in mountpoint.
  The resource will be accessed and new information on its contents will
  be retrieved.
  
  It sets ERRORLEVEL to 0 if the operation was successfully completed
  and to returned error code otherwise.
  
  Syntax:
  
       ndrefresh path
       
           where path is the directory to be refreshed
  
  
  2.4. REXX LIBRARY

  NetDrive for OS/2 uses a REXX interface. See ndrexx.txt and rexxtest.cmd
  for more information on using REXX scripts with NetDrive.
  
  2.5. SUPPORTED RESOURCES
  
  Current version of NetDrive for OS/2 supports LOCAL and FTP resources.
  
  A LOCAL resource is a resource that can be accessed via standard OS/2
  commands and utilities. LOCAL resources are: local directories (e.g. C:\), 
  network resources that can be accessed via UNC (e.g. \\server\resource ).
  The resource description, that used as parameter for mount utilities,
  is the name of the directory or network resource.
  
  
  FTP resource is a directory on a FTP server.
  The resource description has the following format:
|     server[;type=d;passive=d;timeout=d;retries=d;dircache=d;storesize=d]
      where
          server = [user[:password]@]address[:port][/[directory]]
          type = type of server, see below
          passive = passive ftp mode 1 - on (default) or 0 - off
          timeout = seconds (default value = 600 seconds)
          retries = number (default value = 5)
          dircache = 0 - nocache, 1 - cache all requests (default), 
                     2 - cache only nonglobal, i.e. without * or ?, 
                         searches
|         storesize = the maximum size of the data packet that will be send 
|                     to ftp server during upload (default value is 16 Kbytes)
          
| Supported FTP servers:
  
|  type   description
|     0   NetDrive will try to autodetect remote system (default )
|     1   OS2 FTPD
|     2   OS2 Hethmon FTPD
|     3   a Generic UNIX
|     4   UNIX ULTRIX
|     5   UNIX Freeport
|     6   UNIX Banyan Vines
|     7   DEC VMS
|     8   PC/TCP
|     9   IBM VM
|    10   Novell Netware
|    11   Novell Netware (Hellsoft)
|    12   Novell LAN WorkPlace (DOS)
|    13   Microsoft Windows NT
|    14   Macintosh
|    15   Macintosh (Peter's)
|    16   Novell Netware 4.1x
|    17   Chameleon FTP Server
|    18   VMS Wollogong
|    19   VMS MultiNet
|    20   Windows NT on DEC Alpha

  
  External plugins by third party developers will be in
  NetDrive for OS/2 version 2.0.

  Extended attributes are supported for LOCAL resources.

  
  2.6. NOTES, RESTRICTIONS AND KNOWN BUGS

  a) The NDFS volume contains a tree of mount points. The root directory
  of the volume is the root mount point, which exists permanently. Any mount
  point can contain none, one or a few child mount points. One or more
  resources can be mounted to any mount point. A resource can be mounted
  to root mount point only if this is enabled by MountToRoot variable in
  ndctl.cfg.

  b) If a resource has been mounted to the root mountpoint and the NDFS 
  drive was opened in WPS then the WP ROOT. SF file will be created 
  on the resource.
  
  c) Not all FTP servers are supported. Autodetection of a FTP server
  type could fail in some cases. FTP firewalls and proxies are not
  supported in this version. Case sensitivity FTP servers might not work
  correctly.
  
  d) Sometimes uppercased files or a directory on an OS/2 network resource 
  has cause problems.
  
  e) Copying a file to win95 network resource might not work properly.
  
| f) In order to use NetDrive with Linux's proftpd-1.20rc2 server 
|    one need to specify the following parameters type=3;passive=0
|    ( Thanks to Arne Blankerts )

  
  3. ORDERING AND SUPPORT

      NetDrive for OS/2 is distributed by BMT Micro, Inc.
      You may fill out and print the order form text (ORDER.FRM) 
      and mail or fax it to BMT.
      
|     After ordering NetDrive for OS/2 you will receive a RELEASE serial 
|     number. You have to run ndreg.cmd from NetDrive's directory and
|     follow instructions on the screen.

      The latest version of the application is available from BMT Micro at
      http://www.bmtmicro.com/catalog/netdrive.html

      Please send NetDrive's questions, bug reports and suggestions to
      
      netdrive@bmtmicro.net

***************************** [End of file] ********************************
