You are here: CSP API Reference > 1 EXS & SwitchKit API Messages > 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
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) |
: |
Address Method 0x00 - Individual AEs |
8, 9 |
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 |
|||
: |
Checksum |
: |
Only if Response Status field is not 0x10: |
: |
Checksum |