PreviousNext

Fields of a Serviceability Message

When executed, the program will print a message similar to the following:

1994-04-05-20:13:34.500+00:00I----- PID#9467 NOTICE hel main hello_svc.c 47 0xa444e208

Hello World

This message is made up of the following fields:

time inaccuracy process_ID severity component subcomponent src_file src_line thread_ID text

Where the field names have the following meanings:

time
The time that the message was written, in ISO format:

CCYY-MM-DD-hh:mm:ss.fff[+|-]II:ii

Where the digit groups represent:

CCYY Century and year

MM
Month

DD
Day

hh
Hour

mm
Minutes

ss
Seconds

fff
Fractions of second

II:ii
Time inaccuracy expressed in hours and minutes

The final groups represent a time differential factor (expressed in hours and minutes), followed by an inaccuracy component. For further information on time format, see Introduction to the Distributed Time Service API.

process_ID
The process ID of the program that wrote the message (PID#9467 in the example). If dce_svc_set_progname( ) had been called to establish the application's program name, that name would appear in this field instead of the process ID. See Basic Server Calls for further information.

severity
The severity level of the message (NOTICE in the example).

component
The component name of the program that wrote the message (hel in the example).

subcomponent
The subcomponent that wrote the message (main in the example; note that this program has only one subcomponent).

src_file
The name of the C source file in which the dce_svc_printf( ) call was executed.

src_line
The line number, in the source file, at which the dce_svc_printf( ) call is located.

thread_ID
The thread ID of the thread that wrote the message, expressed as a hexadecimal number (0xa444e208 in the example).

text
The text of the message (Hello World in the example).