Bound sessions are configured using SLEE profiles. You must create one profile per bound session peer.

Information about more general resource adaptor configuration properties is in resource adaptor configuration.

Table 1. SmppBoundSessionConfigurationProfile Attributes
Profile Attribute Type Default Comment

Host

String

localhost

IP address or hostname of SMSC to connect to

Port

Integer

2775

TCP port to connect to.

BindMode

String

TRX

Type of bind request to use, must be one of TX, RX or TRX (transmitter, receiver or transceiver).

SystemId

String

null

Value for system_id in bind request. Must be 15 characters or less.

Password

String

null

Value for password in bind request. Must be 8 characters or less.

BindInterfaceVersion

String

50

Value for interface_version in bind request. Must be 2-digit hex value, "34" for SMPPv3.4 or "50" for SMPPv5.0

SystemType

String

null

Optional value for system_type in bind request.

Address

String

null

Optional ESME address/range for bind request in the form: ton:npi:address, eg. 1:1:123456

RebindInterval

Integer

5000

Interval (in ms) between re-bind attempts. Must be greater than 100.

EnquireLinkInterval

Integer

5000

Interval (in ms) between ENQUIRE_LINK requests. The resource adaptor periodically sends these to check the session is still active. Set to 0 to disable (not recommended). If set, must be greater than 100.

InactivityTimeout

Integer

15000

If no transactions have completed (including ENQUIRE_LINKs) after this time, the session will be closed. Set to 0 to disable (not recommended). If set, must be greater than 100.

MaxOutgoingRequests

Integer

0

A maximum number of outgoing requests that may be outstanding on this session. 0 means no limit.

PermanentBindFailureCodes

String

(See below)

Bind failure codes that are considered permanent - the RA will not attempt to rebind. May be empty.

EnquireLinkInterval/InactivityTimeout

Certain considerations must be taken into account when specifying these values.

ENQUIRE_LINK request messages are sent if no message has been received in the time specified by EnquireLinkInterval.

The ultimate determination of when to disconnect and reconnect is made according to the value of InactivityTimeout. If no messages have been received (including ENQUIRE_LINK or ENQUIRE_LINK_RESP) within this time, then the session is closed.

So it is important that the value of InactivityTimeout be sufficiently larger than EnquireLinkInterval for the desired number of ENQUIRE_LINK attempts to have occurred before the connection is closed.

For example, for the resource adaptor to close the connection after 6 seconds, and have a single ENQUIRE_LINK attempt before that, you might set:

EnquireLinkInterval=5000
InactivityTimeout=6000

To close the connection after 8 seconds, and have two ENQUIRE_LINK attempts before that, you might use:

EnquireLinkInterval=3500
InactivityTimeout=8000

PermanentBindFailureCodes

This configuration property is specified as a comma-delimited list, and may contain status codes or their symbolic names as defined in the SMPP specification.

The default value is: ESME_RINVSRCADR, ESME_RBINDFAIL, ESME_RINVPASWD, ESME_RINVSYSID, ESME_RINVSRCTON, ESME_RINVSRCNPI, ESME_RINVSYSTYP.

Updating Configuration Profiles

Warning Changes to profiles are not automatically picked up by the resource adaptor. The administrator must trigger a configuration reload for the profiles to be reloaded. This applies even when resource adaptor entities are deactivated and reactivated — the configuration profiles will not be reloaded unless triggered by the administrator.

A configuration reload can be triggered in the Rhino command line console:

updateraentityconfigproperties <entity-name>

When using the Rhino Element Manager, you can edit and save an unchanged resource adaptor entity configuration to achieve the same result.

Previous page Next page