Adobe 38043740 - ColdFusion Standard - Mac Development Manual page 1310

DEVELOPING COLDFUSION 9 APPLICATIONS
Using External Resources
If there is only one optional parameter, you can instead use the following code:
out.optionalParameter=parameter;
out.optionalParameterValue="value";
Note: Ensure that the Java Short.decode(String) function can parse the key or the value is a byte.
Message disposition notification
You can request the SMSC to return a message disposition response to indicate the fate of your message. To request a
delivery receipt, include a RegisteredDelivery field in the Data parameter of a
return variable of the CFC listener method. This field can have the following values:
Value Meaning
0 (Default) Do not return delivery information.
1 Return a receipt if the message is not delivered before the time-out.
2 Return a receipt if the message is delivered or fails.
Some providers also support intermediate delivery notifications. For more information, see your provider's
documentation.
To use delivery notification, send your message using synchronous mode, so you get a message ID. Your incoming
message routine must be able to handle the receipts (see
Validity period
You can change the length of time that the SMSC keeps a message and tries to deliver it. (Often the default value is 72
hours.) For a message sent to an emergency worker, for example, a short validity period (such as 15 min.) can be
appropriate. To change this value, include a validityPeriod field in the Data parameter of a
function or the return variable of the CFC listener method. To specify a time period, use the following pattern:
YYMMDDhhmmsst00R. In this pattern, t indicates tenths of seconds, and 00R specifies that this value is a relative time
period, not a date-time value. The time format 000001063000000R, for example, specifies a validity period of 0 years,
0 months, 1 day, 6 hours, 30 minutes.
ColdFusion SMS development tools
ColdFusion provides the following tools for developing SMS applications:
• SMS test server
• SMS client simulator
SMS test server
The ColdFusion SMS test server is a lightweight SMSC simulator that listens on TCP/IP port 7901 for SMPP
connection requests from other SMS resources, such as ColdFusion SMS gateways or the SMS client simulator. The
resource supplies a user name, password, and telephone number (address). The user name and password must
correspond to a name and password in the simulator's configuration file (described later).
After the SMS test server establishes a connection, it listens for incoming messages and forwards them to the specified
destination address, if the destination address also corresponds to an existing SMPP connection.
"Handling incoming
Last updated 1/20/2012
function or the
SendGatewayMessage
messages" on page 1298).
SendGatewayMessage
1305