RemoveLLCRoutingID

Type

SwitchKit API message

Overview

This message will remove an individual RoutingID from the LLC but leave the connection to the card and all other RoutingID’s established even after the last RoutingID is removed. However, if an attempt is made to remove the last RoutingID before removing the connection, the LLC will log a message stating that the devices have been orphaned and will then remove the RoutingID. At this point the LLC maintains communications with the card pair but the socket pair is reported as being down so that applications will not attempt to send/receive messages to it. After a pair of devices have been orphaned (all RoutingID’s have been removed), routing and communications for an application can be re-established without establishing a new connection by configuring a new RoutingID for that card IP pair using the AddLLCCard message.

Sent by

Application

C Structure

typedef struct {

BaseFields Base;

int RoutingID;

unsigned short CardType;

UBYTE reserved23[4];

} SK_RemoveLLCRoutingID;

 

C Structure Response

typedef struct {

BaseFields Base;

int Status;

int RoutingID;

UBYTE Reserved1;

UBYTE reserved26[5];

} SK_RemoveLLCRoutingIDAck;

C++ Class

class SKC_RemoveLLCRoutingID : public SKC_ToolkitMessage {

public:

SKC_RemoveLLCRoutingID(int sz = 0);

~SKC_RemoveLLCRoutingID();

SK_DECLARE_CLASS(SKC_RemoveLLCRoutingID,SKC_ToolkitMessage)

 

virtual MsgStruct *getStructPtr();

virtual const MsgStruct *getStructPtr() const;

virtual int getTag() const;

 

int getRoutingID() const;

void setRoutingID(int x);

unsigned short getCardType() const;

void setCardType(unsigned short x);

C++ Class Response

class SKC_RemoveLLCRoutingIDAck : public SKC_ToolkitAck {

public:

SKC_RemoveLLCRoutingIDAck(int sz = 0);

~SKC_RemoveLLCRoutingIDAck();

SK_DECLARE_CLASS(SKC_RemoveLLCRoutingIDAck,SKC_ToolkitAck)

 

virtual MsgStruct *getStructPtr();

virtual const MsgStruct *getStructPtr() const;

virtual int getTag() const;

 

int getStatus() const;

void setStatus(int x);

int getRoutingID() const;

void setRoutingID(int x);

UBYTE getReserved1() const;

void setReserved1(UBYTE x);

 

 

RemoveLLCRoutingIDAck

The LLC will acknowledge the RemoveLLCRoutingIDAck with a RemoveLLCRoutingAck message.

 

RemoveLLCRoutingIDAck ( Status= <**Response Value>

RoutingID= <Unique ID for Card Pair>,

Reserved1= <Not currently used>);

 

Status Field

Possible Response Values found in the Status field of an RemoveLLCRoutingIDAck Message.

**Response Values

Action

SK_SUCCESS

The RoutingID was successfully removed.

SK_NOT_PRESENT

The RoutingID was not found.

SK_NO_MESSAGE

Invalid message parameter found while processing request.

 

 

RoutingID Macros

To avoid duplicate values, the routing ID for each type of sub-component card must be derived using that cards corresponding get_RoutingID macro. Macros will be defined within SK_API.h so that they are globally accessible.

Macros available for deriving RoutingID’s

CardType

Function

SK_SS7TCAP_BOARD (0x03)

getSS7TCAP_RoutingID(int stackid(0-255));