You are here: CSP API Reference > 1 EXS & SwitchKit API Messages > Clear System Software 0x000C

Clear System Software 0x000C

SwitchKit Name

ClearSystemSoftware

Type

EXS API and SwitchKit API message

Description

Clear System Software 0x000C

NOTE: This message is for use in a lab environment only. You must not send this message to a live system.

This message clears the system software stored in memory on the CSP Matrix Series 3 Card. Use this message immediately before you send a new load to the CSP Matrix Series 3 Card. To stop the running system software, push the Reset button or send a Reset Matrix message.

System software is copied into maintained storage. Upon reset or boot, software is copied from maintained storage to RAM for execution. When the host sends this message, the copy in maintained storage is cleared, but the RAM is unaffected.

If a card resets after you send this message, the card will not retrieve a software load from maintained storage and will not come back into service.

Redundant Matrix Cards

In a redundant system, sending this message to the active CSP Matrix Series 3 Card clears both CSP Matrix Series 3 Card. After sending this message to the active CSP Matrix Series 3 Card, you must send a Reset Matrix message to both CSP Matrix Series 3 Card.

Sent by

Host

Related API Message

Reset Matrix 0x009D (ResetMatrix)

SwitchKit Code

C Structure

typedef struct {

} XL_ClearSystemSoftware;

C++ Class

class XLC_ClearSystemSoftware : public XLC_OutboundMessage {

public:

};

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 (0x000C) | 3, 4 | Message Type (0x000C)
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

Random Access Memory
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