You are here: CSP API Reference > 1 EXS & SwitchKit API Messages > Product License Query 0x007A
SwitchKit Name
ProductLicenseQuery
Type
EXS API and SwitchKit API message
Description
This message is used to provide information about product licenses that are currently installed on the Excel platform.
Sent by
SwitchKit Code
C Structure
typedef struct {
} XL_ProductLicenseQuery;
C Structure Response
typedef struct {
unsigned short Status;
UBYTE NumLicenses;
UBYTE Data[250];
} XL_ProductLicenseQueryAck;
C++ Class
class XLC_ProductLicenseQuery : public XLC_OutboundMessage {
public:
};
C++ Class Response
class XLC_ProductLicenseQueryAck : public XLC_AcknowledgeMessage {
public:
unsigned short getStatus() const;
void setStatus(unsigned short x);
UBYTE getNumLicenses() const;
void setNumLicenses(UBYTE x);
const UBYTE *getData() const;
UBYTE *getData();
void setData(UBYTE *x);
};
EXS API Hex Format
MESSAGE |
RESPONSE |
||
Byte |
Field Description |
Byte |
Field Description |
0 |
Frame (0xFE) |
0 |
Frame (0xFE) |
1, 2 |
Length (0x0005) |
1, 2 |
Length (0xNNNN) |
3, 4 |
Message Type (0x007A) |
3, 4 |
Message Type (0x007A) |
5 |
Reserved (0x00) |
5 |
Reserved (0x00) |
6 |
Sequence Number |
6 |
Same Sequence Number |
7 |
Logical Node ID |
7 |
Logical Node ID |
8 |
Checksum |
||
|
Response continued below. |
||
8, 9 |
Status MSB: 0x4D If the MSB of the Status field is 0x4D (NACK), the LSB indicates the NACK reason.
Status LSB: 0x01 Software Key Format Not Valid The first two bytes of the Product License field are not defined key types,
0x02 Data Decrypted Not Valid A serial number decrypted from a Product License cannot be matched
0x03 Product License - Insufficient Licensed Resources
0x3D Product License - Invalid ICB Data
0x74 Invalid Card Type
0xAA Insufficient Hardware |
||
10 |
Number of Licenses to follow |
||
11 |
Data[0] The data varies by the Entity being queried. The entity can be determined by Key Type.
Hardware Upgrades Data[0-1] Card Serial Number Data[2] Slot Number Data[3] Number of Entities Data[4-5] Key Type Data[6-19] Encrypted Key
Software Upgrades Data[0-1] Chassis Serial Number Data[2] Slot Number Data[3] Number of Entities Data[4-5] Key Type Data[6-19] Encrypted Key |
||
: |
Checksum |