You are here: CSP API Reference > 1 EXS & SwitchKit API Messages > Virtual Card Configure 0x00E0

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.

Range of channels provided by T1 or E1 transmission service. A physical span is a group of channels taking up a single physical wire. A logical span is a group of channels taking up less than a single logical wire, or carried over more than one physical wire.
A computer, attached to the Excel platform through an RS-232 or Ethernet link, from which you run the telecommunications application that controls the Excel platform.
A group of data bits in a specific format, with a flag at each end to indicate the beginning and the end of the frame.
Most Significant Bit
Least Significant Bit
Positive acknowledgment to a message