You are here: CSP API Reference > 1 EXS & SwitchKit API Messages > Assign EXS Host/Slave 0x006E

Assign EXS Host/Slave 0x006E

SwitchKit Name

AssignEXSHostSlave

Type

EXS API and SwitchKit API message

Description

Assign EXS Host/Slave 0x006E

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

A computer, attached to the Excel platform through an RS-232 or Ethernet link, from which you run the telecommunications application that controls the Excel platform.
Range of channels provided by T1 or E1 transmission service. A physical span is a group of channels taking up a single physical wire. A logical span is a group of channels taking up less than a single logical wire, or carried over more than one physical wire.
A group of data bits in a specific format, with a flag at each end to indicate the beginning and the end of the frame.
See Address Information Block.
Most Significant Bit
Least Significant Bit