You are here: CSP API Reference > 1 EXS & SwitchKit API Messages > AllocateChannel

AllocateChannel

Type

SwitchKit API message

Description

Use the SK_AllocateChannel message to manually allocate a channel outside of the standard automatic allocation functions (for example, sk_watchChannelGroup() and sk_requestOutseizedChannel()). Regardless of the channel groups that the channel is in, the LLC tries to allocate the channel specified by Span and Channel to the calling application. On success, the return Status value contains 0x00. If the channel is already allocated to another application, Status contains SK_NO_CHANNELS.

Sent by

Application

C Structure

typedef struct {

unsigned short Span;

UBYTE Channel;

} SK_AllocateChannel;

C Structure Response

typedef struct {

int Status;

} SK_AllocateChannelAck;

C++ Class

class SKC_AllocateChannel : public SKC_ToolkitMessage {

public:

unsigned short getSpan() const;

void setSpan(unsigned short x);

UBYTE getChannel() const;

void setChannel(UBYTE x);

};

C++ Class Response

class SKC_AllocateChannelAck : public SKC_ToolkitAck {

public:

int getStatus() const;

void setStatus(int x);

};

Range of channels provided by T1 or E1 transmission service. A physical span is a group of channels taking up a single physical wire. A logical span is a group of channels taking up less than a single logical wire, or carried over more than one physical wire.