SMPP Class

Properties   Methods   Events   Configuration Settings   Errors  

The Smpp Class implements a lightweight message transmission interface using the Short Message Peer-to-Peer protocol, most known for its use in cellular text messaging.




The Smpp class supports both plaintext and SSL/TLS connections. When connecting over SSL/TLS the SSLServerAuthentication event allows you to check the server identity and other security attributes. The SSLStatus event provides information about the SSL handshake. Additional SSL related settings are also supported via the Config method.

The Smpp Class will bind as a transceiver, and thus can send and receive messages from the server. Additionally, it can send single and multi-recipient messages, and can upload data.

Using Smpp is quite easy. First, simply set the SMPPServer, SMPPPort, and, if needed, the SMPPVersion properties. Second, a single call to the Connect method with a specified user id and password will connect the class.

Transmitting messages is just as easy. You can manipulate the Recipients properties directly, or just use AddRecipient method to add recipients one-by-one to the recipient list. After all recipients have been added, a single call to the SendMessage method will transmit the specified message. If the send is successful, the method will set and return the value of the MessageId property. Otherwise, an Error event will fire for each unsuccessful message destination.

The Smpp Class supports message and data transmission, as well as auxiliary operations such as CheckMessageStatus and ReplaceMessage. All non-implemented features of the protocol are supported through the SendCommand method and PITrail event. Due to the nature of the protocol, all methods and operations are implemented synchronously.

Property List

The following is the full list of the properties of the class with short descriptions. Click on the links for further details.

ConnectedIndicates whether or not the class is bound.
FirewallA set of properties related to firewall access.
IdleThe current status of the class.
LocalHostThe name of the local host or user-assigned IP interface through which connections are initiated or accepted.
MessageExpirationDenotes the validity period of the current message.
MessageIdThe identifier of the most recently sent message.
MessagePriorityThe priority level of the current message.
PasswordContains the user's password.
ProtocolThe SMPP protocol to be used.
RecipientsA list of message recipients.
ScheduledDeliveryTells the server when to deliver the current message.
SenderAddressThe address of the ESME.
ServiceTypeIndicates the type of service for the current message.
SMPPPortThis property contains the server port for secure SMPP (default 2775).
SMPPServerThe SMPP entity to which the class will connect.
SMPPVersionThe SMPP version to be used throughout the connection.
SSLAcceptServerCertInstructs the class to unconditionally accept the server certificate that matches the supplied certificate.
SSLCertThe certificate to be used during SSL negotiation.
SSLEnabledWhether TLS/SSL is enabled.
SSLServerCertThe server certificate for the last established connection.
SSLStartModeDetermines how the class starts the SSL negotiation.
SystemTypeA string representing the type of system during a connection.
TimeoutA timeout for the class.
UserIdUsed for identification with the SMPP service.

Method List

The following is the full list of the methods of the class with short descriptions. Click on the links for further details.

AddRecipientWill add a recipient of the specified type to the recipient list.
CancelMessageWill cancel the specified message.
CheckLinkWill check the connection to the server.
CheckMessageStatusWill retrieve the status of the specified message.
ConfigSets or retrieves a configuration setting.
ConnectWill bind as a transceiver to the SMPP service.
DisconnectWill disconnect from the SMPP service.
DoEventsProcesses events from the internal message queue.
InterruptInterrupt the current method.
ReplaceMessageReplaces a previously sent message with a new one.
ResetReset the class.
SendCommandWill format and send a PDU using the specified command identifier and payload.
SendDataSends raw data to Recipients .
SendMessageSends a message to all recipients in the recipient list.

Event List

The following is the full list of the events fired by the class with short descriptions. Click on the links for further details.

ConnectedThis event is fired after a successful bind operation.
ConnectionStatusFired to indicate changes in connection state.
DisconnectedThis event is fired when connection to the SMS service is lost.
ErrorThis event is fired when the server detects an error.
MessageInThis event is fired upon receipt of a message.
MessageStatusThis event is fired upon receipt of a message.
PITrailThis event is fired once for each PDU sent between the client and server.
ReadyToSendFired when the class is ready to send data.
SSLServerAuthenticationFired after the server presents its certificate to the client.
SSLStatusShows the progress of the secure connection.

Configuration Settings

The following is a list of configuration settings for the class with short descriptions. Click on the links for further details.

AddressRangeSpecifies the addr_range parameter when binding.
BinaryDataCodingWhether or not to binary encode the message when DataCoding is set.
BindAsReceiverCauses the class to bind as a receiver.
BindAsTransmitterCauses the class to bind as a transmitter.
CustomTLVOptional TLV parameters added after the mandatory parameters and before the payload.
DataCodingThe data encoding mechanism to be used for the current message.
DecodeHexStringsWill decode an ascii hex-representation of binary data prior to transmission.
DestinationNPIThe Number Planning Indicator for the destination ESME.
DestinationTONThe Type of Number for the destination ESME.
DoSplitLargeMessagesSplits long messages and returns the UDH and Message Parts.
HexStringA hex-encoded binary string to be sent to the current recipient.
IncomingDestinationAddressReturns the dest_addr field inside the received message.
IntermediateNotificationCauses the class to request intermediate notification.
MaxCIMDSMSLengthIndicates the maximum SMS message length for the CIMD protocol.
MaxSMSLengthIndicates the maximum SMS message length.
MCReceiptThe Type of MC Delivery Receipt requested.
MessageInReceiptedMessageIdThe receipted_message_id field of an incoming deliver_sm PDU.
MessageModeThe Type of Messaging Mode requested.
MessageTypeThe Type of Message.
ProtocolIdThe protocol identifier.
SMEAcknowledgementThe Type of SME originated acknowledgement requested.
SourceNPIThe Number Planning Indicator for the ESME.
SourceTONThe Type of Number for the ESME.
SplitLargeMessagesDetermines whether large messages are split into multiple parts.
SplitMessageMethodDetermines how large messages are split into multiple parts.
StatusReportRequestDefines in what cases a status report is created by the server.
SubAddrDefines a unique index for application instance.
SynchronousSendCommandControls whether SendCommand behaves synchronously or asynchronously.
SynchronousSendMessageControls whether SendMessage behaves synchronously or asynchronously.
UseGSM7BitEncodingWhether or not to use GSM 7-bit encoding.
UseGSM7bitEncodingCompressionWhether to compress GSM 7-bit encoded characters.
WaitForBannerSpecifies the CIMD2 banner the class will wait for when connecting.
ConnectionTimeoutSets a separate timeout value for establishing a connection.
FirewallAutoDetectTells the class whether or not to automatically detect and use firewall system settings, if available.
FirewallHostName or IP address of firewall (optional).
FirewallPasswordPassword to be used if authentication is to be used when connecting through the firewall.
FirewallPortThe TCP port for the FirewallHost;.
FirewallTypeDetermines the type of firewall to connect through.
FirewallUserA user name if authentication is to be used connecting through a firewall.
KeepAliveIntervalThe retry interval, in milliseconds, to be used when a TCP keep-alive packet is sent and no response is received.
KeepAliveTimeThe inactivity time in milliseconds before a TCP keep-alive packet is sent.
LingerWhen set to True, connections are terminated gracefully.
LingerTimeTime in seconds to have the connection linger.
LocalHostThe name of the local host through which connections are initiated or accepted.
LocalPortThe port in the local host where the class binds.
MaxLineLengthThe maximum amount of data to accumulate when no EOL is found.
MaxTransferRateThe transfer rate limit in bytes per second.
ProxyExceptionsListA semicolon separated list of hosts and IPs to bypass when using a proxy.
TCPKeepAliveDetermines whether or not the keep alive socket option is enabled.
TcpNoDelayWhether or not to delay when sending packets.
UseIPv6Whether to use IPv6.
LogSSLPacketsControls whether SSL packets are logged when using the internal security API.
OpenSSLCADirThe path to a directory containing CA certificates.
OpenSSLCAFileName of the file containing the list of CA's trusted by your application.
OpenSSLCipherListA string that controls the ciphers to be used by SSL.
OpenSSLPrngSeedDataThe data to seed the pseudo random number generator (PRNG).
ReuseSSLSessionDetermines if the SSL session is reused.
SSLAcceptAnyServerCertWhether to trust any certificate presented by the server.
SSLCACertsA newline separated list of CA certificate to use during SSL client authentication.
SSLCipherStrengthThe minimum cipher strength used for bulk encryption.
SSLEnabledCipherSuitesThe cipher suite to be used in an SSL negotiation.
SSLEnabledProtocolsUsed to enable/disable the supported security protocols.
SSLEnableRenegotiationWhether the renegotiation_info SSL extension is supported.
SSLIncludeCertChainWhether the entire certificate chain is included in the SSLServerAuthentication event.
SSLNegotiatedCipherReturns the negotiated ciphersuite.
SSLNegotiatedCipherStrengthReturns the negotiated ciphersuite strength.
SSLNegotiatedCipherSuiteReturns the negotiated ciphersuite.
SSLNegotiatedKeyExchangeReturns the negotiated key exchange algorithm.
SSLNegotiatedKeyExchangeStrengthReturns the negotiated key exchange algorithm strength.
SSLNegotiatedProtocolReturns the negotiated protocol version.
SSLProviderThe name of the security provider to use.
SSLSecurityFlagsFlags that control certificate verification.
SSLServerCACertsA newline separated list of CA certificate to use during SSL server certificate validation.
TLS12SignatureAlgorithmsDefines the allowed TLS 1.2 signature algorithms when UseInternalSecurityAPI is True.
TLS12SupportedGroupsThe supported groups for ECC.
TLS13KeyShareGroupsThe groups for which to pregenerate key shares.
TLS13SignatureAlgorithmsThe allowed certificate signature algorithms.
TLS13SupportedGroupsThe supported groups for (EC)DHE key exchange.
AbsoluteTimeoutDetermines whether timeouts are inactivity timeouts or absolute timeouts.
FirewallDataUsed to send extra data to the firewall.
InBufferSizeThe size in bytes of the incoming queue of the socket.
OutBufferSizeThe size in bytes of the outgoing queue of the socket.
BuildInfoInformation about the product's build.
CodePageThe system code page used for Unicode to Multibyte translations.
LicenseInfoInformation about the current license.
UseInternalSecurityAPITells the class whether or not to use the system security libraries or an internal implementation.

Copyright (c) 2022 /n software inc. - All rights reserved.
IPWorks 2020 JS Edition - Version 20.0 [Build 8161]