You are here: SwitchKit® Development Environment Programmer’s Guide > 3 Channel Management > sk_associateChannelGroup()

sk_associateChannelGroup()

Description

The sk_associateChannelGroup() function is used to manage the physical channels mapping to logical channel groups. When the automatic configuration facilities in EXS SwitchManager are used, this function is not needed. If a group does not exist, sk_associateChannel
Group() automatically creates the group. The function call is cumulative, so if you want to build a non-contiguous set of channels, just issue multiple sk_associateChannelGroup() function calls. This function is also available as sk_associateChannelGroupOnConnection() and skts_associateChannelGroup().

Syntax

int sk_associateChannelGroup(char *aChannelGroup, int aStartSpan, int aStartChannel, int anEndSpan, int anEndChannel);

int sk_associateChannelGroupOnConnection(char *aChannelGroup, int aStartSpan, int aStartChannel, int anEndSpan, int anEndChannel, int aConID);

Threadsafe Syntax

int skts_associateChannelGroupOnConnection(char *aChannelGroup, int aStartSpan, int aStartChannel, int anEndSpan, int anEndChannel, int aConID);

Parameters

The function parameters are shown in the table below.

Argument | Description
--- | ---
aChannelGroup | Identifies the channel group.
aStartSpan | Identifies the first span in the group.
aStartChannel | Identifies the first chan in the group.
anEndSpan | Identifies the last span in the group.
anEndChannel | Identifies the last chan in the group.
aConID | A connection identifier specified at connection creation time and used to indicate which LLC an application wishes to communicate with.

Return Values

Possible return values for this function:

SK_LOST_LLC | This return value indicates that your application lost contact with the LLC.