You are here: CSP API Reference > 1 EXS & SwitchKit API Messages > 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
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 |
|
10 |
Checksum |