Virtual Card Configure 0x00E0

SwitchKit Name

VitualSlotConfig

Type

EXS API and SwitchKit API message

Description

Virtual Card Configure 0x00E0

Use this message when configuring virtual spans to simulate the adding and removing of cards that do not exist in the system. The slot numbers you configure with this message are used when configuring the virtual spans. You must send this message prior to the Assign Logical Span ID message.

NOTE: De-assigning all spans using the Assign Logical Span ID (0x00A8) message will clean up all virtual slots which acts as if the virtual cards were removed.

Related Messages

Virtual Span Configure

Sent by

Host

Example Message

The following example configures virtual slot 40 on board type 80, virtual VDAC card.

 

00 0d 00 E0 00 00 ff 00 00 01 01 01 02 40 80

SwitchKit Code

Configuration

VirtualSlotConfig (

Node = integer,

ConfigType = integer,

Data = byte array);

C Structure

typedef struct {

BaseFields Base;

UBYTE ConfigType;

UBYTE Data[222];

} XL_VirtualSlotConfig;

C++ Class

class XLC_VirtualSlotConfig : public XLC_OutboundMessage {

public:

UBYTE getConfigType() const;

void setConfigType(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 (0x00E0)

3, 4

Message Type (0x00E0)

5

Reserved (0x00)

5

Reserved (0x00)

6

Sequence Number

6

Same Sequence Number

7

Logical Node ID

7

Logical Node ID

8, 9

:

AE

0x00 00 Null

 

8, 9

 

Status MSB (0x00)

Status LSB:

0x01 Virtual Card Already Assigned.

The slot has already been assigned a virtual card.

 

0x02 Slot Already Exists.

The slot already contains a physical card.

 

0x03 No Available Timeslots

Hardware has no more timeslots available.

 

0x10 Positive ACK

Everything validated and action was initiated.

 

0x61 Invalid Slot Number.
Slot Number is not 0x40-0x5F.

 

0x74 Invalid Card Type

Slot has an incorrect type specified.

 

0x7F Software Module Locked

System has not been configured with a Product License for Virtual Spans.

 

10

Checksum

 

:

Configure Type

0x01 Use TLVs

:

Number of TLVs to follow

:

Data (TLVs)

 

0x01 Add Virtual Card

0x02 Remove Virtual Card

:

Checksum

Response Data

The response data varies depending upon the value of the fields in the message.