OSF DCE Administration Guide--Core Components

OSF DCE Administration Guide—Core Components
• By the contents of a routing file
• By the contents of an environment variable
• By command-line flags (usually -w), if supported by the server
Note: Each of the methods accepts the string syntax form for serviceability
routing specifications. In addition, dcecp allows you to use Tcl (Tool
Commmand Language) syntax, which is easier to use when writing scripts.
Routing a message actually consists of specifying two things:
• How the message should be processed (that is, the form in which it should be put)
• Where the message should be sent (its destination)
The two specifications are sometimes closely interrelated, and sometimes specifying a
certain destination implies that the message must be put into a certain form. This fact
allows certain combinations to be abbreviated.
The ways to route serviceability messages are described separately in the following
sections.
9.4.2.1 Using the dcecp log Object
The dcecp log object represents the current state of routing for DCE serviceability
messages for a given server. The log object supports both serviceability routing and
debug routing.
The log object exports a number of operations. The following operations are useful for
serviceability message routing:
• The log list operation returns a list of the components registered by the server. The
-comp option allows you to also return a list of the subcomponents for one or more
named components.
• The log show operation returns a list describing the current serviceability routing
specifications for a server.
• The log modify operation sets message routing specifications for one or more
specified servers.
For a complete description of the dcecp log object and the syntax for its supported
operations, refer to the log(8dce) reference page.
The remainder of this section describes only the log modify operation and how to use it
to establish routings for serviceability messages. Remember that routing is always set
on a per-server basis and is recorded in the log object for each server.
The syntax for the log modify operation is
log modify {string_binding_to_server | RPC_server_namespace_entry }\
{-change serviceability_routing_specifications}
9− 10 Tandem Computers Incorporated 124243