Group and Channel annotations

This topic describes the group and channel annotations supported by Streamline.

The group and channel set of macros enables you to break down threads into multiple channels of activity and assign each channel to a group. A number identifies each group and channel, and each one has a name for display in the Timeline view and the Log view. Groups and channels are defined per thread. Therefore although each channel number must be unique within the thread, channels in different threads can have the same number.

Channels and groups are defined per thread. This means that if the same channel number is used on different threads they are separate channels. A channel can belong to only one group per thread. This means channel 1 cannot be part of both group 1 and group 2 on the same thread.

Annotation macros

ANNOTATE_CHANNEL(channel, string)

Add a string annotation and assign it to a channel. The channel parameter is the channel number.

ANNOTATE_CHANNEL_COLOR(channel, color, string)

Add a string annotation with a display colour, and assign it to a channel.

ANNOTATE_CHANNEL_END(channel)

Terminate the annotation in the given channel.

ANNOTATE_NAME_CHANNEL(channel, group, string)

Define a channel and attach it to an existing group. The channel number, channel, must be unique within the thread.

ANNOTATE_NAME_GROUP(group, string)

Define an annotation group. The group identifier (group) must be unique within the thread.