Name

dce_svc_debug_set_levels − Sets the debugging level for a component

Synopsis

#include <dce/dce.h>
#include <dce/svcremote.h> void dce_svc_debug_set_levels(
unsigned char ∗where,
error_status_t ∗status);

Parameters

Input

whereA multifield string consisting of the component name separated by a colon from a comma-separated list of subcomponent/level pairs, as described in svcroute(5dce). 

Output

statusReturns 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_debug_set_levels() routine sets serviceability debugging message level(s) for a component.  The where parameter is a multifield string consisting of the component name separated by a colon from a comma-separated list of subcomponent/level pairs, as described in svcroute(5dce).  The subcomponents are specified by codes defined in the component’s sams file; the levels are specified by single digits (1 through 9). 

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

To set both the debug level and routing for a component, use the dce_svc_debug_routing() routine. 

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). 

Related Information

Functions: dce_svc_debug_routing(3dce). 

Files: svcroute(5dce).