You are here: CSP API Reference > 1 EXS & SwitchKit API Messages > Become Active 0x00A1

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

Host

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 | Status MSB, LSB
10 | Checksum

See Signaling System Number Seven.
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.
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.
Most Significant Bit
Least Significant Bit