Program:       MAPNEXT.EXE

Version:       1.23

Distribution:  Unlimited [no system impact]

Source:        \\cwb-a\user2\build\nov_util\mapnext

Libraries:     NW4SDK(mapping)  NW3SDK(environment services)

Author:        Richard Letts	<R.J.Letts@salford.ac.uk>

URL:	ftp://ftp.salford.ac.uk/network/utils/mapnext.zip

Description:
     Map root the next free (unmapped) network drive to the path specified
     the search no starts from the last drive letter avilable.

     Can optionally map the drive letter as a search drive.

     Does not attempt to log the user into a fileserver

     Sets an environment variable specifying what letter has been mapped
     errorlevel set on exit:
          0 - success
          1 - Out of environment space
          2 - no free drive available for mapping
          3 - path invalid
          4 - some other error [bad arguments]

Usage:
     mapnext [options] <variable-name> <Netware Path>

     options:
          -d   debugging output [lots!] [only available in debug version]
          -v   produces verbose output [path mapped, and drive letter]
          -s   produces a search mapping

Example Usage:
1) mapnext mail X:ccmail2.0

     equivalent to
          map root i:=apps:\ccmail2.0
          set mail=I

     [if I: is the next unmapped network drive]

2) mapnext -s mail X:ccmail2.0

     equivalent to
          map root ins s1:=apps:\ccmail2.0
          set mail=I

     [if I: is the next unmapped network drive]


Notes:
     This software is compatible with the following software versions. If it
does not work on your machine please inform the author by email. To determine
the software versions you are using use the 'version' utility.  There is 
more than one version of 3.32 of NETX so send the output of version!

LSL.COM
    Link Support Layer v2.06 (931202)
NE2000.COM
    NE2000 Ethernet MLID  v1.54 (931123)
IPXODI.COM
    IPX/SPX Protocol  v2.12 (931007)
VLM.EXE
    NetWare virtual loadable module manager  v1.10 (931209)
    AUTO.VLM     - NetWare auto-reconnect module  v1.10 (931209)
    BIND.VLM     - NetWare bindery protocol module  v1.10 (931209)
    CONN.VLM     - NetWare connection table manager  v1.10 (931209)
    FIO.VLM      - NetWare file input-output module  v1.10 (931209)
    GENERAL.VLM  - NetWare general purpose function module v1.10 (931209)
    IPXNCP.VLM   - NetWare IPX transport module  v1.10 (931209)
    NDS.VLM      - NetWare directory services protocol module  v1.10 (931209)
    NETX.VLM     - NetWare workstation shell module  v4.10 (931209)
    NWP.VLM      - NetWare protocol multiplexor module  v1.10 (931209)
    PRINT.VLM    - NetWare printer redirection module  v1.10 (931209)
    REDIR.VLM    - NetWare DOS redirector module  v1.10 (931209)
    RSA.VLM      - NetWare RSA authentication module  v1.10 (931209)
    SECURITY.VLM - NetWare security enhancement module  v1.10 (931209)
    TRAN.VLM     - NetWare transport multiplexor module  v1.10 (931209)

NETX.EXE
   Version NetWare Workstation Shell  v3.32 (931117) PTF 
   Version NetWare Workstation Shell  v3.32 (930217) 

CHANGE LOG
----------
VERSION        Comments
1.23           Fixed stack overflow on NETX.EXE machines

1.20           search drive mapping added
               Debug version [dmapnext] available in the soure directory
               this is 3-4 times the size of the non-debug version, and MUCH
               slower.

1.10           reversed search order from 'A -> Z' to 'Z -> A'
               I tend to map f,g,h,i by hand, occasionally likely to zap
               a network path. this makes the mapped drive less likely to
               be altered by the user

1.00           Initial Version


CAVEATS
-------

The environment variable will be updated, but the drive not mapped if the
volume dismounts or there is a network fault between setting the variable and
mapping the drive.

The drive may be mapped, but the PATH not set if you run out of environment
space for the enlarged path [-s option only].

