You are here: CSP API Reference > 1 EXS & SwitchKit API Messages > 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
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
|
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.
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)
|
||
: |
Checksum |
Response Data
The response data varies depending upon the value of the fields in the message.