You are here: CSP API Reference > 1 EXS & SwitchKit API Messages > PPL Configure 0x00D7

PPL Configure 0x00D7

SwitchKit Name

PPLConfig

Type

EXS API and SwitchKit API message

Description

PPL Configure 0x00D7

This message is used to assign configuration data to a PPL component. Most PPL components have 200 bytes per channel available for data.

NOTE: ANSI and ITU L3P CIC components have 600 bytes per channel.

Sent by

Host

SwitchKit Code

Configuration

PPLConfig (

Node = integer,

StartSpan = integer,

StartChannel = integer,

EndSpan = integer,

Range = StartSpan:StartChan - EndSpan:EndChan,

EndChannel = integer,

Span = integer,

Channel = integer,

Subrate = integer,

StackID = integer,

LinkID = integer,

Destination = integer,

Route = integer,

SSLGroupID = integer,

SSLProfileID = integer,

SSLServiceNumber = integer,

V5ID = integer,

RouterHandle = integer,

ComponentID = integer,

Entity = integer,

ConfigData = byte array);

C Structure

typedef struct {

UBYTE AddrInfo[30];

unsigned short ComponentID;

UBYTE Entity;

unsigned short CSASlot;

unsigned short Protocol;

UBYTE ConfigData[220];

} XL_PPLConfig;

C++ Class

class XLC_PPLConfig : public XLC_OutboundMessage {

public:

const UBYTE *getAddrInfo() const;

UBYTE *getAddrInfo();

void setAddrInfo(UBYTE *x);

XBYTE getStartSpan() const;

void setStartSpan(XBYTE x);

UBYTE getStartChannel() const;}

void setStartChannel(UBYTE x);

XBYTE getEndSpan() const;

void setEndSpan(XBYTE x);

UBYTE getEndChannel() const;

void setEndChannel(UBYTE x);

XBYTE getSpan() const;

void setSpan(XBYTE x);

UBYTE getChannel() const;

void setChannel(UBYTE x);

UBYTE getStackID() const;

void setStackID(UBYTE x);

UBYTE getLinkID() const;

void setLinkID(UBYTE x)

XBYTE getV5ID() const;

void setV5ID(XBYTE x);

XBYTE getRouterHandle() const;

void setRouterHandle(unsigned short x);

unsigned short getComponentID() const;

void setComponentID(unsigned short x);

UBYTE getEntity() const;

void setEntity(UBYTE x);

unsigned short getCSASlot() const;

void setCSASlot(unsigned short x);

unsigned short getProtocol() const;

void setProtocol(unsigned short x)const;

UBYTE *getConfigData() const;

UBYTE *getConfigData();

void setConfigData(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 (0x0007)
3, 4 | Message Type (0x00D7) | 3, 4 | Message Type (0x00D7)
5 | Reserved (0x00) | 5 | Reserved (0x00)
6 | Sequence Number | 6 | Same Sequence Number
7 | Logical Node ID | 7 | Logical Node ID
: | AIB Address Method Depends on the component being addressed. See PPL Component Addressing in the API Reference. | 8, 9 | Status MSB, LSB
10 | Checksum
Number of AEs to follow
AEs Depends on the component being addressed.
: | PPL Component ID MSB, LSB See PPL Component IDs in the API Reference.
: | PPL Entity 0x01 PPL Configuration Bytes Block 1: 1-200 0x02 PPL Configuration Bytes Block 2: 201-400 0x03 PPL Configuration Bytes Block 3: 401-600 0x04 PPL Configuration Bytes Block 4: 601-800 0x05 PPL Configuration Bytes Block 5: 801-1000
: | Configuration Data Number of Data Locations (n) For each location to be assigned data, indicate the byte to be configured (1–600) and the data. NOTE: If you are going to change the configuration of ISDN B Channels, do not send this message until you have sent the ISDN Interface Configure message.
: | Location 1: Byte Number (in groups of 200, according to the value of the PPL Entity field).
: | Location 1: Data
: | Location n: Byte Number
: | Location n: Data
: | Checksum

See Programmable Protocol Language.
American National Standards Institute. ANSI administers and coordinates the U.S. voluntary standardization and conformity assessment system for the
telecommunications industry. More details on these standards may be
viewed at www.ansi.org.
International Telecommunications Union (UN)
See Circuit Identification Codes.
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.
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 group of data bits in a specific format, with a flag at each end to indicate the beginning and the end of the frame.
See Address Information Block.
Most Significant Bit
Least Significant Bit
A programmable software component that uses PPL state machines that can be modified with the PPL Tool.
See Integrated Services Digital Network.