This interface is provided for the Zamano SMS service. Note that this interface currently only submits messages - it is expected that the user will provide a separate interface to receive delivery reports from Zamano.

The interface currently supports only standard SMS messages.


The following parameters are available:

$sms_serviceThe name of the DLL for this interface should be entered on the second parameter of the $sms_service configuration command as @PFC\CF8SMS03.DLL.  For example:
$sms_service * ZAMANO "@PFC\CF8SMS03.DLL"
The interface can also be called from CopiaFacts version 7, using engine 7.401 or later.
SMS_SERVICESet this variable to ZAMANO (see above) to use this service for the call.
SMS03_URLSet this variable (normally in FAXFACTS.CFG) to the Zamano URL to which the notification request is to be sent.  The URL should consist of everything up to, but not including, the ? introducing the parameters.
SMS03_USERNAMESet this variable (normally in FAXFACTS.CFG) to your Zamano Client ID.
SMS03_PASSWORDSet this variable (normally in FAXFACTS.CFG) to your Zamano account password.
SMS03_PORTSet this variable to the port number to connect to.  If not supplied, the default is 80.
SMS03_SOURCEMSISDNSet this variable to the Zamano sourceMsisdn value to be used.
SMS03_TAGSet this variable to the Zamano sourceMsisdnTag value to be used.  The characters -/^.+\_-!?[]+$ will be stripped from the value.
SMS03_OPERATORIDSet this variable to the Zamano operatorId number if required.
SMS03_OPERATORSet this variable to the numeric Operator ID supplied earlier by mBlox, if available.  If omitted, no Operator element is included in the notification request.
SMS03_KEEPNLSet this variable to a non-empty value to cause newlines in the message to be retained. When not specified, LF will be set to a space, and CR will be deleted.
SMS_MSGIDThis variable is not used in this interface.  The FS number is used to identify the message (as Zamano requestId).

SMS_DELIVERY_OUTCOME   Will be set to PENDING after the 'submission' of the message. This variable is not set if the submission fails.

SMS_ERROR_CODEWill be set to the numeric code returned by Zamano (0, -1, 12..20) if the message submission fails.

SMS_ERROR_MESSAGE   Will be set to the error text returned by Zamano if the message submission fails.  The variable will be cleared if the submission succeeds.

Outcome codesOne of the following codes:
170SMS_SERVICE not defined for the transmission
172Submission error
173Error getting SMS provider response
174No message to send
175SMS delivery failure
176SMS message too long (see below)
179Exception in SMS DLL
(FFTRACE)Set CF8SMS03 under File/Applications to see the trace output.

Message Processing

Messages are currently sent UTF-8 encoding.  Zamano document that characters @£^€|~][{}¬` may cause problems, but these are not currently stripped.

If a message contains more than 160 characters after variable expansion, it will be failed with outcome 176.  However if a character ¶ (182) appears in the text, a block of characters preceding it, and  the character itself, will instead be replaced by "..." to reduce the total length of the message to 160 bytes. If more than 160 characters follow the marker character, the transmission will fail with outcome 176. This feature allows trailing message text (preceded by ¶) to be retained even if the message has to be shortened.