PPL Configure 0x00D7

SwitchKit Name

PPLConfig

Type

EXS API and SwitchKit API message

Description

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;

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);

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);

int getMsgSize() const;

void setMsgSize(UBYTE 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