PreviousNext

dce_svc_routing(3dce)

Specifies routing of serviceability messages

Synopsis

#include <dce/dce.h>
#include <dce/svcremote.h>

void dce_svc_routing(

unsigned char *where,
error_status_t *status);

Parameters

Input

where
A three-field routing string, as described in svcroute(5).

Output

status
Returns the status code from this operation. The status code is a value that indicates whether the routine completed successfully and if not, why not.

Description
The dce_svc_routing( ) routine specifies how normal (non-debug) serviceability messages are routed. The where parameter is a three-field routing string, as described in svcroute(5). For convenience, the first field of the routing specifier (which indicates the message severity type to which the routing is to be applied) may be an * (asterisk) to indicate that all messages, whatever their severity, should be routed as specified.

If the routine is called before the component is registered (with the dce_svc_register( ) routine), the routing is stored until it is needed. In case of error, the status parameter is filled in with an error code.

Errors

The following describes a partial list of errors that might be returned. Refer to the OSF DCE Problem Determination Guide for complete descriptions of all error messages.

See dce_svc_register(3dce).

Files

dce/service.idl