PITrail Event

This event is fired once for each PDU sent between the client and server.

Syntax

typedef void __fastcall (__closure *TipwSMPPPITrailEvent)(System::TObject* Sender, TipwSMPPPITrailEventParams *e);

__property TipwSMPPPITrailEvent OnPITrail = {read=FOnPITrail, write=FOnPITrail};

typedef struct {
     int Direction;
     String PDU;
     int CommandLength;
     int CommandId;
     String CommandDescription;
     String CommandStatus;
     int SequenceNumber;
} TipwSMPPPITrailEventParams;

Remarks

Whenever either the component or the SMPPServer sends any data across the connection, the component will fire a PITrail event containing that data. It will usually be in SMPP-PDU format.

A PDU will contain at least the SMPP header, which is always 16 bytes long. The first four bytes represent the total length of the PDU, including the 16-byte header. The next four bytes are the command id associated with the PDU. The command id of a response PDU is always the command id to which it is responding plus 0x80000000.

The component parses the values contained in the PDU header into the appropriate fields. The CommandLength, CommandId, CommandStatus, and SequenceNumber parameters contain these parsed values.

The third set of four bytes are the command status (status code) of the command. All originating commands will have a status code of 0x00000000, which will be ignored by the receiver. The field is only set by in response PDUs to indicate the status of the originating command. The final four bytes represent the sequence number of the command. All response PDUs will contain the same sequence number as the originating command.