Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ DCE_SVC_INTRO(3dce) — DCE 3.1

Media Vault

Software Library

Restoration Projects

Artifacts Sought

DCE_SVC_INTRO(3dce)  —  Subroutines

Name

DCE_SVC_INTRO - Introduction to the DCE serviceability macros

Description

The DCE_SVC_DEFINE_HANDLE macro is used to create a serviceability handle.  This can be useful in a library that has no explicit initialization routine in which a call to dce_svc_register() could be added.  The remaining macros can be compiled out of production code, or left in to aid diagnostics, depending on whether or not DCE_DEBUG (normally found in dce/dce.h) is defined. 

The DCE Serviceability Macros

The serviceability macros are as follows, listed in alphabetical order:

DCE_SVC_DEBUG()
Used to generate debugging output.

DCE_SVC_DEBUG_ATLEAST()
Can be used to test the debug level of a subcomponent for a specified handle.  Tests whether the debug level is at least at the specified level.

DCE_SVC_DEBUG_IS()
Can be used to test the debug level of a subcomponent for a specified handle.  Tests for an exact match with the specified level.

DCE_SVC_DEFINE_HANDLE()
Registers a serviceability message table.

DCE_SVC_LOG()
Generates debugging output based on a message defined in an application’s sams file. 

Files

dce/service.idl

dce/dce_svc.h

Related Information

Books: OSF DCE Application Development Guide

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026