Assign EXS Host/Slave 0x006E

SwitchKit Name

AssignEXSHostSlave

Type

EXS API and SwitchKit API message

Description

Use this message to establish a relationship between a host node and a slave node in a CSP system. You can route this message through any node.

If you indicate the same node as both the host node and the slave node, the CSP returns the response status 0xFC (Invalid Logical Node ID).

NOTE: Do not use this message to establish a node as a host node. A node becomes a host node when any API message is sent to it through a direct TCP connection.

Sent by

Host

SwitchKit Code

Configuration

AssignEXSHostSlave(

Node = integer,

HostNode = integer,

SlaveNode = integer);

C Structure

typedef struct {

BaseFields Base;

UBYTE HostNode;

UBYTE SlaveNode;

} XL_AssignEXSHostSlave;

C Structure Response

typedef struct {

BaseFields Base;

unsigned short Status;

unsigned short Span;

UBYTE Channel;

} XL_AssignEXSHostSlaveAck;

C++ Class

class XLC_AssignEXSHostSlave : public XLC_OutboundMessage {

public:

UBYTE getHostNode() const;

void setHostNode(UBYTE x);

UBYTE getSlaveNode() const;

void setSlaveNode(UBYTE x);

};

C++ Class Response

class XLC_AssignEXSHostSlaveAck : public XLC_AcknowledgeMessage {

public:

unsigned short getStatus() const;

void setStatus(unsigned short x);

unsigned short getSpan() const;

void setSpan(unsigned short x);

UBYTE getChannel() const;

void setChannel(UBYTE x);

};

 

EXS API Hex Format

MESSAGE (White)

RESPONSE (Gray)

Byte

Field Description

Byte

Field Description

0

Frame (0xFE)

0

Frame (0xFE)

1, 2

Length (0xNNNN)

1, 2

Length (0x0007)

3, 4

Message Type (0x006E)

3, 4

Message Type (0x006E)

5

Reserved (0x00)

5

Reserved (0x00)

6

Sequence Number

6

Same Sequence Number

7

Logical Node ID (Host Node)

7

Logical Node ID (Host Node)

:

AIB

 

Address Method

0x00 - Individual AEs

8, 9

Response Status MSB, LSB

If the value of this field is anything other than a Positive Acknowledgment (0x10), the system inserts the Logical Node AIB after this field.

Number of AEs to follow

AE

0x0E EXS Host-Slave Node

:

Checksum

:

Only if Response Status field is not 0x10:

AE
0x0E EXS Host-Slave Node

:

Checksum