TABLE OF CONTENTS

	1. Installing Hidden Object Locator
	2. Main Screen
	3. Changing Parameters
	4. Configuring
	5. Discovering a name
	6. Locating Hidden Objects
	7. Using the Logfile
	8. SNMP Trap information



----------------------------------------------------------------------------

1. Installing Hidden Object Locator

   To install the hidden object locator copy HOBJLOC.NLM to the SYS:SYSTEM 
directory of a 4.1x file server.  

   Note: the tree that you want to search must be on the file server that 
you copy HOBJLOC.NLM to.

   After copying the NLM, type LOAD HOBJLOC.NLM at the console prompt.

   If you see a message saying, "Loader cannot find public symbol: SACTrap",
it means that you have not loaded SNMP.NLM.  You can simply load SNMP.NLM
to resolve this error, but if you want to receive traps you must configure
your server and workstation.  See your SNMP reference manual for more
information on configuring SNMP.


----------------------------------------------------------------------------

2. Main Screen

   The following is a picture of the main screen for the HOBJLOC.NLM.  
Other sections will refer to this screen.

ЙНННННННННННННННННННННННННННННННННННННННННННННННННННННННННННННННННННННН»
є Context: O=Novell                                                    є
єBegin At: [Root]                                                      є
є    User: Admin                                                       є
є  Search: OU=Mktg.O=Novell                                            є
єДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДє
є                                                                      є
є                                                                      є
є                                                                      є
є                                                                      є
є                                                                      є
є                                                                      є
є								       є
ИННННННННННННННННННННННННННННННННННННННННННННННННННННННННННННННННННННННј
                    ЙНННННННННННННННННННН»
                    є       Options      є
                    МНННННННННННННННННННН№
                    є іChange Parameters є
                    є іConfigure         є
                    є іDiscover Name     є
                    є іStart Locating    є
                    є іView/Clear Logfileє
                    ИННННННННННННННННННННј


----------------------------------------------------------------------------
3. Changing Parameters


   Choosing the Change Parameters option from the main menu allows you to 
change your context and starting location in the DS tree.  The following
is a menu that will be displayed when you choose this option.


                    ЙННННННННННННННННННННННН»
                    є        Options        є
                    МННННННННННННННННННННННН№
                    є іChange Context       є
                    є іChange Start Locationє
                    ИНННННННННННННННННННННННј


The context is displayed on the first line in the main screen portal 
and will look similar to:

	Context: O=Novell

The Start Location is displayed on the second line in the main screen 
portal and will look similar to:
	
	Begin At: [Root]


   By default the context is set to the servers context and the start 
location is set to [Root].


   Choosing either of these options presents an edit box that will allow 
you to change the chosen parameter.


   NOTE: The Start Location must be specified using a fully distinguished
name. For example:

	OU=Marketing.OU=Non_Engineering.O=Novell

is acceptable, whereas:

	Marketing.Non_Engineering.Novell

is not.  This only applies to the start location.

----------------------------------------------------------------------------
4. Configuring

   Choosing the Configure option from the main menu allows you to change
the following variables:

   Editor 
      - StartAtBottom (default=YES)

   Log Files 
      - Purge After   (default=20 days)

   SNMP
      - EnterpriseID  (default=1.3.6.1.4.1.23.2.7777)
      - VarBindID     (default=1.3.6.1.4.1.23.2.7777.1)


You can configure the editor to start at the top or at the bottom.  The 
default is to start at the bottom.

You can configure Log Files to purge (delete) old log files after a 
specified number of days.  This allows you the ability to keep old 
Log Files from encumbering your hard drive.

You can configure SNMP to send traps to any specified enterprise ID. You
can also change your variable binding. If you change the SNMP variables
then you must unload and reload HOBJLOC.NLM for them to take effect.  
For information on SNMP IDs you should consult your SNMP administrator 
or your reference manual.

----------------------------------------------------------------------------
5. Discovering a name

   Choosing the Discover Name option from the main menu allows you to 
discover the name of any hidden objects directly under a specified container.
When you choose this option two prompts will appear.  One prompt will
ask for a container object and the other prompt will ask for the name 
of the user that may have hidden objects in the specified container.

   For example, to see all the objects hidden from user admin you would
type:

	Container: Novell
	User: Admin.network_division.Novell

Note: The container and user name are based on the context shown on the
first line in the main portal screen.

Note: You can obtain containers with hidden objects by using the 
Start Locating option from the main menu (See section 6).

----------------------------------------------------------------------------
6. Locating Hidden Objects

   Choosing the Start Locating option from the main menu allows you to begin
locating objects that are hidden from a specified user.  When you choose 
this option an edit box will appear prompting for a user and password.  

Note: The user name is based on the context shown on the first line in the 
main portal screen.

After you enter the user name and password the NLM will begin locating objects
from the location displayed next to the Begin At: prompt on the main portal
screen.  To change the Begin At location see section 3 Changing Parameters.

   If the NLM finds any hidden objects, they will be displayed on the main
screen and logged to today's logfile.  They will also be sent via an SNMP
Trap.  The information displayed, logged and sent via SNMP trap can then
be used with the Discover Name option (See section 5) to Discover the 
name of the hidden object.  Also, a server name is given that the NLM 
must be run on to reveal the name of the hidden object.

Note: If the object exists on the server that the NLM is running on it 
will automatically discover the name.


----------------------------------------------------------------------------
7. Using the Logfile

   Choosing View/Clear Logfile from the main menu will bring up a list
box similar to the following:



                ЙННННННННННННННННННННННННННННННННННННННННННН»
                є                 View Logfile              є
                МННННННННННННННННННННННННННННННННННННННННННН№
                є іHL951208.LOG (Fri. December 08, 1995     є
                є іHL951211.LOG (Mon. December 11, 1995     є
                є іHL951212.LOG (Tue. December 12, 1995	    є
                є іHL951213.LOG (Wed. December 13, 1995	    є
                є іHL951214.LOG (Thu. December 14, 1995	    є
                є іHL951215.LOG (Fri. December 15, 1995	    є
                є іHL951216.LOG (Sat. December 16, 1995	    є
                є і                                         є
                є і                                         є
                є і                                         є
                є і                                         є
                є і                                         є
                є і                                         є
                є і                                         є
                є і                                         є
                ИНННННННННННННННННННННННННННННННННННННННННННј



   Choosing one of the days listed will allow you to view the contents of
the logfile for that day.  The last one listed should be the most recent
logfile.

   To delete a logfile position the highlighted bar on one of the days 
listed and press the delete key.  A prompt will be displayed asking to
verify that you really want to delete the log file.
   
Note: If the logfile has today's date on it the logfile will be cleared, but
not deleted.


   When you are view a logfile the following keys are operational:


   key		      action

HOME        - Takes you to the beginning of the logfile.
END         - Takes you to the end of the logfile.
PAGE-UP     - Takes you up one page.  If you are at the beginning it beeps.
PAGE-DOWN   - Takes you down one page.  If you are at the end it beeps.
UP-ARROW    - Takes you up one line.  If you are at the beginning it beeps.
DOWN-ARROW  - Takes you down one line.  If you are at the end it beeps.
RIGHT-ARROW - Moves the cursor one to the right. 
LEFT-ARROW  - Moves the cursor one to the left. 
CTL-RIGHT-ARROW	- Moves the cursor ten spaces to the right.
CTL-LEFT-ARROW  - Moves the cursor ten spaces to the left.


----------------------------------------------------------------------------
8. SNMP Trap Information

   The following is information relating to the SNMP traps sent by 
HOBJLOC.NLM.


Variable bindings are defined by using the VarBindID from the Configure
option on the main menu (See Section 4 Configuring) and adding the following
number to the specific variable.


The Number of hidden Objects

	VarBindID.1

A Container Object
	
	VarBindID.2

A Server Name

	VarBindID.3

A Directory Services Object

	VarBindID.4

The rights a user does not have to an object

	VarBindID.5


---

The specific types are as follows:

------------------
SPECIFIC TYPE 1
------------------

   VarBindID.4 (Object Name (ie. User Name) - Octet String)
   VarBindID.1 (Number of Hidden objects - Integer)
   VarBindID.2 (Container - Octet String)
   VarBindID.3 (Server Name - Octet String)



A message similar to the following could be displayed:

   User <VarBindID.4> has <VarBindID.1> hidden objects 
in container <VarBindID.2> on server <VarBindID.3>


------------------
SPECIFIC TYPE 2
------------------

   VarBindID.4 (Object Name - Octet String)
   VarBindID.5 (Rights - Octet String)
   VarBindID.4 (Object Name - Octet String)


A message similar to the following could be displayed:

   Object <VarBindID.4> does not have <VarBindID.5> rights 
to object <VarBindID.4>

------------------
SPECIFIC TYPE 3
------------------

   VarBindID.4 (Object Name - Octet String)
   VarBindID.3 (Server Name - Octet String)

A message similar to the following could be displayed:

   Object <VarBindID.4> does not exist on this server. 
Try server <VarBindID.3>