You are here: CSP API Reference > 1 EXS & SwitchKit API Messages > Become Active 0x00A1
SwitchKit Name
ActivateMatrix
Type
EXS API and SwitchKit API message
Description
For EXS API
Use this message to initiate a switchover in an Excel platform with a redundant Matrix Controller or SS7 card. You must send this message to the standby Matrix Controller from the matrix host or send this message to the standby SS7 card from the SS7 local host. If you send this message to the active Matrix Controller or active SS7 card, it has no effect on the Excel platform.
Excel recommends sending this message from the Matrix host to initiate a switchover to the standby Matrix Controller or sending this message from the SS7 local host to initiate a switchover to the standby SS7 card.
For SwitchKit API
ActivateMatrix() initiates a Matrix switchover regardless of what parameters are passed in. With EXS SwitchKit you must send a function call to sk_activateExnetMatrix(). You cannot send the message directly to the standby Matrix Controller.
EXS SwitchKit API does not support sending this message from the host to the standby SS7 card.
Sent by
EXS API Hex Format
MESSAGE (White) |
RESPONSE (Gray) |
||
Byte |
Field Description |
Byte |
Field Description |
0 |
Frame (0xFE) |
0 |
Frame (0xFE) |
1, 2 |
Length (0x0005) |
1, 2 |
Length (0x0007) |
3, 4 |
Message Type (0x00A1) |
3, 4 |
Message Type (0x00A1) |
5 |
Reserved (0x00) |
5 |
Reserved (0x00) |
6 |
Sequence Number |
6 |
Same Sequence Number |
7 |
Logical Node ID |
7 |
Logical Node ID |
8 |
Checksum |
8, 9 |
|
10 |
Checksum |