*****************************************************************************
HOME.EXE
(c) 1993 Marc E. Mosko, All Rights Reserved.

This program is provided "as is" and is not guaranteed to work in your
specific environment or for your specific purpose.

This program may not be sold.

This program is provided as shareware, and may be redistrubuted only if
this README file accompanies the executable code.

This program and README file may not be altered or modified.  The executable
program may not be decompiled.

To register your copy, contact Marc E. Mosko on Compuserve at 76231,3176 or
via the internet at mmosko@netcom.com.
*****************************************************************************

Purpose:
HOME.EXE will lookup a users HOME DIRECTORY property from NetWare's NDS
database and optionally map a drive to that value.  It can be called from
login scripts.

Installation:
This program requires Novell NetWare Directory Services (NetWare 4.x) and
Novell Virtual Loadable Module (VLM) client software.

HOME.EXE should be placed in the SYS:PUBLIC directory and flagged RO SH.  If
it is used from a login script, you should map a search drive to PUBLIC
before calling HOME.

HOME will call Novell's MAP.EXE command, so MAP must be in the search path.

Usage:
HOME [driveletter [/r]] /q
        /q will invoke quite mode.
        /r will make the drive mapping a ROOT drive mapping.
        driveletter is the DOS letter to use.  It must include a ":".

If calling from a login script, the following syntax is suggested:
        #HOME H: /R > NUL

This will map the user's Home Directory to drive H as a root mapping and
pipe all output to the NULL device.  The user will not see any output
from the HOME program.

If you wish to see a result from the MAP command, use the following:
        #HOME H: /R /Q

The choice of drive letter and the root mapping, of course, are left to
your discretion.

Support:
All support is provided through electronic mail:
        Compuserve 76231,3176
        internet   mmosko@netcom.com

Common problems:
MAIN: Error returned from InitUnicode (-491)
        HOME.EXE cannot find the Unicode tables required to execute.  The
        program probably was not installed correctly in the PUBLIC directory
        or the NLS subdirectory does not exist under PUBLIC.

NWDSERR: No such attribute (-603)
        The user object does not have a HOME DIRECTORY property defined.
        This error is generated when the VOLUME is not defined.
        Use NETADMIN or NWADMIN to specify a VOLUME object.

NWDSERR: No such entry (-601)
        HOME.EXE cannot read the user's NDS object.  There are two main
        causes for this:
        (1) You're not logged in.
        (2) The user does not have the Read property right to the
            HOME DIRECTORY property.  By default, all users will have
            Read to thier [All Properties] property, which includes
            the HOME DIRECTORY property.
