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
Become Active 0x00A1
For EXS API
Use this message to initiate a switchover in an CSP with a redundant CSP Matrix Series 3 Card or SS7 card. You must send this message to the standby CSP Matrix Series 3 Card 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 CSP Matrix Series 3 Card or active SS7 card, it has no effect on the CSP.
Dialogic recommends sending this message from the Matrix host to initiate a switchover to the standby CSP Matrix Series 3 Card 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 CSP Matrix Series 3 Card.
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 |