Product License Download 0x0079

SwitchKit Name

ProductLicenseDownload

Type

EXS API and SwitchKit API message

Description

This message is used to download one software key. Regardless of how a software or hardware module has been locked, you unlock all functionality with this message.

This message provides the mechanism for a host application to send the software feature or hardware upgrade license codes to the Excel platform. In a multi-node system, any node will accept and recognize these software feature licenses.

NOTES: For SwitchKit, when resetting a card such as, a T_ONE, E-ONE or J-ONE, a ProductLicenseDownload message is sent by SwitchManager so that the licensed hardware is available after a card reset. If the licensed card is permanently removed and the corresponding ProductLicenseDownload is not removed from the configuration, then any subsequent resets of matching card types will cause the ProductLicenseDownload to be NACKed.

Sent by

Host

Example Message (Socket Log Output for SwitchKit)

The following socket log output/example message enables SIP software.

00 19 00 79 00 00 ff 01 02 24 10 30 38 42 50 43 4b 4b 48 49 42 32 34 54 50 4f 4b

SwitchKit Code

Configuration

ProductLicenseDownload (

Node = integer,

ICBCount = integer,

ICBData = byte array);

C Structure

typedef struct {

UBYTE ICBCount;

UBYTE ICBData[252];

} XL_ProductLicenseDownload;

C Structure Response

typedef struct {

unsigned short Status;

UBYTE Slot;

} XL_ProductLicenseDownloadAck;

C++ Class

class XLC_ProductLicenseDownload : public XLC_OutboundMessage {

public:

UBYTE getICBCount() const;

void setICBCount(UBYTE x);

const UBYTE *getICBData() const;

UBYTE *getICBData();

void setICBData(UBYTE *x);

};

C++ Class Response

class XLC_ProductLicenseDownloadAck : public XLC_AcknowledgeMessage {

public:

unsigned short getStatus() const;

void setStatus(unsigned short x);

UBYTE getSlot() const;

void setSlot(UBYTE x);

};

EXS API Hex Format