NOVELL TECHNICAL INFORMATION DOCUMENT

TITLE:  Readme and File for CHTREE1.EXE
TID #:  2924776
README FOR:  chtree1.exe

NOVELL PRODUCTS and VERSIONS:
NetWare 4.2

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.  8/20/2004
readme change only 



-----------------------------------------------------------------
DISCLAIMER
THE ORIGIN OF THIS INFORMATION MAY BE INTERNAL OR EXTERNAL TO 
NOVELL.  NOVELL MAKES ALL REASONABLE EFFORTS 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.
-----------------------------------------------------------------


INSTALLATION INSTRUCTIONS:

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


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.

Novell Product and Version: 
NetWare 4.11
intraNetWare 4.11 
NetWare 4.2

Self-Extracting File Name: chtree1.exe

Files Included          Size         Date          Time
..\
   CHTREE1.TXT   (This file)
    CHTREE.EXE        163001    6-16-1997    9:15:58 am



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