You are here: CSP API Reference > 1 EXS & SwitchKit API Messages > 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)); |