You are here: CSP API Reference > 1 EXS & SwitchKit API Messages > PPL Delete 0x00DA

PPL Delete 0x00DA

SwitchKit Name

PPLDelete

Type

EXS API and SwitchKit API message

Description

PPL Delete 0x00DA

This message allows the host to delete a protocol, a primitive table, or a state/event table. A primitive or state/event table is not be deleted if it is associated with a protocol in use. All channels must be out-of-service.

If the host sends this message to a CSP that has multiple line cards of the same type, the system deletes the protocol only if the protocol is not in use by every card. If the PPL protocol is in use by at least one card, the system returns a Channel In Service (0xD5) response and does not delete the channel.

You can delete all downloaded PPL components by specifying the PPL component 0xFFFF, which is valid for this message only. Using this value has the following effects:

• For E1 and T1 cards and matrices (L4PPL), the system deletes all downloaded PPLs and purges all channels using non-default protocols.

• For ISDN and SS7 cards, the system deletes all downloaded PPLs. If any channel (D/B channel, SS7 link, and so on) is using a non-default protocol and is in service, the system resets the card; however, if no channels are in service, the system does not reset the card.

Sent by

Host

SwitchKit Code

Configuration

PPLDelete (

Node = integer,

ComponentID = integer,

Entity = integer,

EntityID = integer);

C Structure

typedef struct {

unsigned short ComponentID;

UBYTE Entity;

UBYTE EntityID;

} XL_PPLDelete;

C++ Class

class XLC_PPLDelete : public XLC_OutboundMessage {

public:

unsigned short getComponentID() const;

void setComponentID(unsigned short x);

UBYTE getEntity() const;

void setEntity(UBYTE x);

UBYTE getEntityID() const;

void setEntityID(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 (0x0009) | 1, 2 | Length (0x0007)
3, 4 | Message Type (0x00DA) | 3, 4 | Message Type (0x00DA)
5 | Reserved (0x00) | 5 | Reserved (0x00)
6 | Sequence Number | 6 | Same Sequence Number
7 | Logical Node ID | 7 | Logical Node ID
8, 9 | PPL Component ID MSB, LSB See PPL Component IDs in the API Reference. | 8, 9 | Status MSB, LSB
10 | Checksum
10 | PPL Entity 0x01 Primitive Table 0x02 State/Event Table 0x03 Route Table 0x04 Resource Group Table 0xFF Protocol
11 | PPL Entity ID 0x01–0x0A Host-defined table/protocol
12 | Checksum

See Programmable Protocol Language.
In PPL, a condition that, when met, drives a state machine (PPL Component) from one state to another, by invoking an associated Primitive. In PPL files, an Event is marked by an arrow and text.
A digital communications link - voice, data, and video at a 2.048 Mbps rate; 30B/2D or 31B/1D (ISDN); non-North American version of T1.
Digital communications link - voice, data, and video at a 1.544 Mbps rate (24 64 Kbps channels)
See Integrated Services Digital Network.
See Signaling System Number Seven.
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.
A programmable software component that uses PPL state machines that can be modified with the PPL Tool.
Most Significant Bit
Least Significant Bit
Group of one or more Atomic Functions that allow multiple actions (tests) to be initiated in response to a PPL event for a channel. See Programmable Protocol Language.
The condition of a component at a given instant. The current "context" of a PPL object, such as Idle, Seizing, Answered. In PPL files, a State is represented by a circle.