clh(1) CLIX clh(1)
NAME
clh - Runs Intergraph network clearinghouse interface
SYNOPSIS
clh [[-adur] object]
clh [-v|-bcp [arg]] -l object
FLAGS
-a Adds object to the owned directory as an alias for the nodename
of the local machine.
-d Deletes object from the owned directory.
-u Updates object in the owned directory for nodes in the current
Local Area Network (LAN) and to all LANs it is scoped to (see
clh(4)).
-r Copies all entries in the heard directory on the machine object
to the heard directory on the local machine.
-l Looks up object in the local clearinghouse. The clearinghouse
searches the local, heard, and owned directories in respective
order, and displays the first occurrence of object.
-v Displays the entire contents of the object database entry.
-b [arg] Looks up all nodenames associated with the specified network
address of arg. The object parameter must be an address. The
xns_atn_table and tcp_atn_table files must exist in the
/usr/lib/nodes/local directory for address-to-node translation.
-p [arg] Displays the property arg as found in the object database
entry. A property arg is required with this flag. (See clh(4)
for information on the properties in the clearinghouse entry.)
-c [arg] Looks up the address of object on the machine arg. The arg
parameter is required with this flag. The xns_atn_table and
tcp_atn_table files in the /usr/lib/nodes/local directory must
exist for address-to-node translation.
DESCRIPTION
The clh command provides a user interface for modifying and examining the
Intergraph network clearinghouse database. The Intergraph clearinghouse
is a network-wide utility that allows you to share address and nodename
information with all Intergraph nodes on the network.
2/94 - Intergraph Corporation 1
clh(1) CLIX clh(1)
If command-line arguments are not given, clh provides a menu-driven
interface.
The owned, local, and heard directories are subdirectories of
/usr/lib/nodes.
EXAMPLES
1. To add the object akanod to the owned directory as an alias for the
local nodename, enter:
clh -a akanod
2. To delete the object akanod from the owned directory, enter:
clh -d akanod
3. To update the object akanod in the owned directory to the current
Local Area Network (LAN) and to all LANs it is scoped to, enter:
clh -u akanod
4. To copy all entries in the heard directory on the machine not_me to
the heard directory on the local machine, enter:
clh -r not_me
5. To look up the object not_me in the local clearinghouse, listing all
properties and values of the node, enter:
clh -vl not_me
6. To look up the nodename associated with the network address 08-00-36-
aa-bb-cc, enter:
clh -b -l 08-00-36-aa-bb-cc
The xns_atn_table and tcp_atn_table files in /usr/lib/nodes/local must
exist for address-to-node translation.
7. To look up the value of the tcp_address property in the object akanod,
enter:
clh -p tcp_address -l akanod
2 Intergraph Corporation - 2/94
clh(1) CLIX clh(1)
8. To look up the object not_me on the machine yomach, enter:
clh -c yomach -l not_me
The xns_atn_table and tcp_atn_table files in /usr/lib/nodes/local must
exist on yomach for remote lookup.
FILES
/usr/lib/nodes/owned Well-known nodename and aliases.
/usr/lib/nodes/local Local files used by the clearinghouse.
/usr/lib/nodes/heard All heard objects from the network.
DIAGNOSTICS
INC_CL, Unable to open/close clearinghouse database
An error was encountered trying to open or close the file
associated with the object being accessed. Check the file
permissions of the object.
INC_CL, Unable to add distinguished object; object exists
The object name specified already exists in the clearinghouse
database. Either change the name of the object to be added, or
delete the existing object before adding the new one.
INC_CL, No match on this object/alias; check name specified
The object specified with the look up command does not exist.
Check to ensure you have spelled the name correctly. Also check to
ensure the object exists in the clearinghouse by entering the
following:
clh lookup objectname
If the object exists but the clearinghouse cannot find it, the
clearinghouse being reviewed needs to be updated.
INC_CL, Failure to open object in clearinghouse owned directory
An error was encountered trying to open object in the owned
directory. Check the file permissions of the object.
INC_CL, Can't add object, template not found
The clearinghouse database does not contain a template file in the
local directory. The system manager must set up the template file
in the local directory.
INC_CL, Request to remote lan failed
Request for lookup information failed for remote lan specified. If
a particular node or address was specified, try another node on the
2/94 - Intergraph Corporation 3
clh(1) CLIX clh(1)
lan. If only a lan number was specified, try a particular node on
the lan. Also, ensure the specified node on the remote lan has the
xns_atn_table and tcp_atn_table files in its /usr/lib/nodes/local
directory.
INC_CL, Specified property not found
The specified property does not exist in the database entry for the
object specified. The property may be added through the
clearinghouse menu interface.
EXIT VALUES
Exit values are not valid.
RELATED INFORMATION
Files: clh(4)
CLIX Programming Guide, XNSINGR User's Guide
4 Intergraph Corporation - 2/94