You are here: SwitchKit® Development Environment - Installation and Maintenance Guide  > 7 Device Connectivity > AddLLCNode

AddLLCNode

 

Use SK_AddLLCNode at the initial configuration of your system and to dynamically add a node while LLC is running.

Description

The node must already have software downloaded through TFTP. Sending SK_AddLLCNode for a node that needs software will fail.

If you are using the floating IP address functionality for the CSP Matrix Series 3 cards, you should use the fixed IP addresses for the CSP Matrix Series 3 cards in the AddLLCNode() message. If you don't, the LLC will inaccurately reflect the state of the switch.

Sent by

SwitchManager

Type

SwitchKit API message

Add the Node

To add a node, you must send a configuration file with SwitchManager. The configuration file should contain at least the following information:

AddLLCNode (matrix1="10.10.55.10", matrix2="10.10.55.11", RequestedNode=0x08);

If you are adding a node with a single CSP Matrix Series 3 card and you use the Matrix2 argument in your message, be sure to enter the 0-length string as its value.

Arguments

The following table shows the arguments you can change:

Argument

Description

Action

Specifies if a node gets added (0 = default), updated (1), or deleted (2).

Matrix1

A text field corresponding to the IP address of the primary CSP Matrix Series 3 card.

Matrix2

A text field corresponding to the IP address of the secondary CSP Matrix Series 3 card, if it exists. If there is only one CSP Matrix Series 3 card in the node, this field must be set to "", that is, the 0-length string.

NodeType

Needs to be specified only for ISDN and H.323 device server nodes. In those cases, NodeType should be: SK_LSS_DS_SYSTEM or 0x10. Otherwise, it will default to the appropriate NodeType.

RequestedNode

RequestedNode is the logical node ID requested to be assigned to the new node. The API will attempt to assign this node:

• If there is no node ID currently on the node;

• If it is currently assigned a different node ID.

It is not a guarantee that this node will be assigned. In particular, the node ID might already be in use on the ring. If so, AddLLCNode will fail, and no connection will be established with the node. If the LLC is already connected to a node with the specified logical node ID, the AddLLCNode is considered an update, if treated accordingly.

Configuration

AddLLCNode (

Node = integer,

ConnectionID = integer,

Matrix1 = string,

Matrix2 = string,

RequestedNode = integer,

Action = integer);

C Structure

typedef struct {

char Matrix1[30];

char Matrix2[30];

int RequestedNode;

//int PhysicalNode; reserved for internal use only

//unsigned short NodeType; reserved

//unsigned short CallControlNode; reserved

UBYTE Action;

} SK_AddLLCNode;

C Structure Response

typedef struct {

int Status;

int ActualNode;

UBYTE DownloadStatus;

} SK_AddLLCNodeAck;

C++ Class

class SKC_AddLLCNode : public SKC_ToolkitMessage {

public:

const char *getMatrix1() const;

void setMatrix1(const char *x);

const char *getMatrix2() const;

void setMatrix2(const char *x);

int getRequestedNode() const;

void setRequestedNode(int x);

//int getPhysicalNode() const; reserved

//void setPhysicalNode(int x); reserved

//unsigned short getNodeType() const; reserved

//void setNodeType(unsigned short x); reserved

//unsigned short getCallControlNode() const; res.

//void setCallControlNode(unsigned short x); res.

UBYTE getAction() const;

void setAction(UBYTE x);

};

C++ Class Response

class SKC_AddLLCNodeAck : public SKC_ToolkitAck {

public:

int getStatus() const;

void setStatus(int x);

int getActualNode() const;

void setActualNode(int x);

UBYTE getDownloadStatus() const;

void setDownloadStatus(UBYTE x);

};