PreviousNext

log modify

Sets message routing specifications for one or more specified servers. Remember that routing is always set on a per-server basis and is recorded in the log object for each server. The syntax is:

log modify {RPC_server_namespace_entry | string_binding_to_server}
-change
{routing_specifications | debug_routing_specifications}

The -change option specifies the serviceability routing or debug routing specifications that you want to change. There is a fixed, well-known set of routing defaults. You can change these defaults, but you cannot add new routings or remove existing routings. Routing is always set on a per-server basis and is recorded in the log object for each server. This operation returns an empty string on success.

Description
Serviceability and debug messages can be written to any of the normal output destinations. You can specify routing for serviceability and debug messages in any of the following ways:

· Through the dcecp log object, if the server supports the remote serviceability interface

· By the contents of the dce-local-path/svc/routing routing file

· By the contents of an environment variable

For a complete discussion of the ways in which you can specify routings for serviceability and debug messages, refer to the svcroute(5dce) reference page.

Privileges Required
The privileges are determined by what the server allows for permissions.

Examples

dcecp> log modify /.:/tserver -change {{FATAL TEXTFILE /dev/console} \
{ERROR TEXTFILE /tmp/timop_errors.5.100} {NOTICE BINFILE /tmp/timop_log%ld }}
dcecp>