System Resource Usage Query 0x008E

SwitchKit Name

SystemResourceUtilQuery

Type

EXS API and SwitchKit API message

Description

Use this message to query the utilization status of the following cards:

T-ONE, E-ONE, SS7 Series 3, SS7 PQ, DSP, and Matrix Controller.

Sent by

Host

Sample Message

In the following sample, the host sends the System Resource Usage Query to the Excel platform to query the Resource Usage for a Card. Following is the response from the Excel platform.

Host-to-Excel platform

 

00 10 00 8e 00 00 ff 02 00 01 01 01 09 04 00 01 02 03

 

Excel platform-to-Host Response

 

00 5f 00 8e 00 00 ff 00 10 02 00 01 01 01 09 04 00 26 03 01

02 00 02 48 c0 00 00 01 c0 03 00 02 63 00 00 00 00 00

05 00 05 9e 00 00 03 28 00 05 00 08 8c 00 00 00 06 00

01 01 00 02 08 00 00 01 a0 01 00 2d 19 03 1a 00 00 01

a0 07 00 2d 19 02 00 32 04 00 4b 05 00 4b 06 01 00 07

33 4b 32 03 00

SwitchKit Code

C Structure

typedef struct {

UBYTE QueryType;

UBYTE Slot;

UBYTE NumOfResources;

UBYTE Data[221];

} XL_SystemResourceUtilQuery;

C Structure Response

typedef struct {

unsigned short Status;

UBYTE QueryType;

UBYTE Data[250];

} XL_SystemResourceUtilQueryAck;

C++ Class

class XLC_SystemResourceUtilQuery : public XLC_OutboundMessage {

public:

UBYTE getQueryType() const;

void setQueryType(UBYTE x);

UBYTE getSlot() const;

void setSlot(UBYTE x);

UBYTE getNumOfResources() const;

void setNumOfResources(UBYTE x);

const UBYTE *getData() const;

UBYTE *getData();

void setData(UBYTE *x);

};

C++ Class Response

class XLC_SystemResourceUtilQueryAck : public XLC_AcknowledgeMessage {

public:

unsigned short getStatus() const;

void setStatus(unsigned short x);

UBYTE getQueryType() const;

void setQueryType(UBYTE x);

const UBYTE *getData() const;

UBYTE *getData();

void setData(UBYTE *x);

};

 

EXS API Hex Format

MESSAGE (White)

RESPONSE (Gray)

Byte

Field Description

Byte

Field Description

0

Frame (0xFE)

0

Frame (0xFE)

1, 2

Length (0xNNNN)

1, 2

Length (0xNNNN)

3, 4

Message Type (0x008E)

3, 4

Message Type (0x008E)

5

Reserved (0x00)

5

Reserved (0x00)

6

Sequence Number

6

Same Sequence Number

7

Logical Node ID

7

Logical Node ID

8

Query Type

0x01 Conferencing Resources

0x02 Resource Usage for a Card

8, 9

Status MSB, LSB

NOTE: The following fields apply only if the Query Type field is 0x02

9

:

AIB

Address Method

0x00 - Individual AEs

Number of AEs to follow

AEs

0x01 Slot

:

Number of Resources

:

Resource ID 1

0x00 Memory
0x01 MCB
0x02 CPU Usage Level 1
0x03 CPU Usage Level 2

:

Checksum

10 . . .

Data (continued below)

 

0x01 Conferencing Resources

Data[0,1] Timeslots in use (MSB,LSB)

Data[2,3] Timeslots available (MSB,LSB)

Data[4,5] Percent used (0-100)

0x02 Resource Usage for a Card

 

AIB (Individual AEs)

0x01 Slot

 

0x00 Resource ID: Memory

Data[0] Length

Data[1] Number of regions configured on the card

Data[2] Number of partitions configured on the card

Data[3] Region ID of Nth region

Data[4-7] Size of the region in bytes

Data[8-11] Number of bytes used from the region

Data[12] Partition ID of Nth partition

Data[13-14] Size of the partition in bytes

Data[15-20] Used bytes of partition

 

0x01 Resource ID: MCB

Data[0] Length

Data[1] Message buffer usage

 

0x02 Resource ID: CPU Usage Level 1

Data[0] Length

Data[1-4] Time in milliseconds covering this report

Data[5] Number of tasks reported (0x01)

Data[6] Logical task ID (idle task only 0x00)

Data[7] Percentage of time usage for task (integer part)

Data[8] Percentage of time usage for task (decimal part)

 

0x03 Resource ID: CPU Usage Level 2

Data[0] Length

Data[1-4] Time in milliseconds covering this report

Data[5] Number of tasks reported (the following repeats for each task)

Data[6] Logical task ID

Data[7] Percentage of time usage for task (integer part)

Data[8] Percentage of time usage for task (decimal part)

15

Checksum