Overview
C API (Core)
typedef UINT32 DetailLevel;
D_CRIT
D_WARN
D_INFO
D_VERB
D_1
D_2
D_3
D_4
D_5

The output detail level allows the user to control how verbose they want console output to be. See brahms_outputMessage for usage.

Interface

The detail level can be set at the Command Line of the BRAHMS executable. The default detail level is D_INFO, so D_INFO and lower detail level messages are shown if no Command Line switch is used.

Detail levels

The first category of detail levels, "user information", consists of messages that the user may want to see during usage (system development), rather than development (component or framework development). D_CRIT and D_WARN messages are highlighted, other messages are not. None of these messages indicate a fatal error - in case of a fatal error the component should return an error code instead. Semantically, then, all of these messages are informational, with varying levels of likelihood that they require attention.

The second category is "debug messages", messages that the user may want to see during development. Generally, these will be used to quickly and conveniently narrow down the conditions that are required to generate either a particular abort or a particular unexpected code branch.

Example

C Source Code (against Core)
brahms_outputMessage(hCaller, "Hello World", D_INFO);