NOVELL TECHNICAL INFORMATION DOCUMENT

TITLE:  Readme and File for CHTREE1.EXE
README FOR:  CHTREE1.EXE

NOVELL PRODUCTS and VERSIONS:
NetWare 4.11
DS NetWare 4.11
IntranetWare
DS NetWare IW 4.11

ABSTRACT:

CHTree changes the current tree and displays all authenticated trees.

 NOTE: This utility was created to help system administrators and is provided
free of charge as a courtesy.  It is not a Novell supported product.  Problems
or questions regarding this product can be reported via e-mail to
NTSUTIL@NOVELL.COM. 



 -----------------------------------------------------------------
 DISCLAIMER
 THE ORIGIN OF THIS INFORMATION MAY BE INTERNAL OR EXTERNAL TO NOVELL.  NOVELL
MAKES EVERY EFFORT WITHIN ITS MEANS TO VERIFY THIS INFORMATION.  HOWEVER, THE
INFORMATION PROVIDED IN THIS DOCUMENT IS FOR YOUR INFORMATION ONLY.  NOVELL
MAKES NO EXPLICIT OR IMPLIED CLAIMS TO THE VALIDITY OF THIS INFORMATION.
 -----------------------------------------------------------------


ISSUE: 

========================================
 Usage:
 _____________________________________________

 CHTREE [tree name] | [/?]

 Displays all authenticated trees.  The current tree is marked by *. Changes
the current tree to [tree name] if specified.

 Directory Services operations can only be performed on the current tree.  This
utility programmatically switches the Current tree, meaning CHTree can be used
in a batch file to do operations on multiple trees.

 For example, consider the following DOS batch file:

 REM ***** Begin BATCH file *****
 REM List all users in the ACME_INC tree from the corp container and below.
 CHTREE ACME_INC
 CX .corp
 NLIST user /s
 REM List all user in the TEST tree from the corp container and below.
 CHTREE TEST
 CX .corp
 NLIST user /s
 REM ***** End BATCH file *****


 Or consider a batch file to compare rights of users between two trees:

 REM ***** Begin BATCH file *****
 REM Show how Bob got rights to Lisa in the ACME tree and write to FILE1.
 CHTREE ACME_INC
 DSRIGHTS .bob.corp lisa > FILE1
 REM Show how Bob got rights to Lisa in the TEST tree and write to FILE2.
 CHTREE TEST
 DSRIGHTS .bob.corp lisa > FILE2
 REM ***** End BATCH file *****


 ========================================
 Known Issues:
 _____________________________________________

 Issue
 CHTree will NOT authenticate you to a new tree.  It only switches the current
tree to one of the already authenticated trees.
 

 ========================================
 Frequently Asked Questions:
 _____________________________________________

 Q:  I cannot authenticate to multiple trees.

 A:  You must have a client that support multiple trees.  For example, Client
32 for DOS/Windows, NT, or Windows 95.

 Q: When the tree names are displayed, one tree name has an asterisk (*).  What
does the asterisk mean?

 A:  The asterisk (*) indicates the current tree.

Self-Extracting File Name: chtree1.exe

Files Included     Size     Date      Time

..\
     CHTREE1.TXT     (This file)
      CHTREE.EXE          163001         6-16-97      9:15:58 am
     CHTREE1.TXT            3552          5-2-97      2:10:52 pm


Installation Instructions:

Copy CHTREE.EXE to the SYS:\PUBLIC directory on your server.



 -----------------------------------------------------------------
 Any trademarks referenced in this document are the property of their
respective owners.  Consult your product manuals for complete trademark
information.
 -----------------------------------------------------------------