Configure this event to handle delivery confirmation information uploaded by MobiLink Listeners. If the status parameter returns 0, then the push request identified by request_id was successfully received by the MobiLink Listener identified by the remote_device parameters.
You can use the request_option parameter to initiate an action in response to the delivery confirmation. If request_option is 0, the confirmation_handler event initiates the default action, where the request_delete event is executed to delete the original push request. If the device sending the delivery confirmation does not match the device identified by the request_id, the default action is to send the original push request through a secondary gateway.
Use the dblsn -x option to allow MobiLink Listeners to upload delivery confirmation information. Use the dblsn -ni option if you want delivery confirmation but do not want IP tracking. See MobiLink Listener options for Windows devices.
This event requires the use of a system procedure. You can not configure this event directly using the Sybase Central method. See MobiLink server settings for server-initiated synchronization.
The following parameters can be captured using the confirmation_handler event:
Controls what the Notifier does to the request after the handler returns. The following values can be returned:
The situation summary. The status can be used during development to identify problems such as incorrect filters and handler attributes. The following values can be returned:
|request_id (in)||Integer||The request ID. Your request_cursor event must contain a request ID column to use the confirmation_handler event.|
The summary reported by the MobiLink Listener. The following values can be returned:
|remote_device (in)||Varchar||The device name of the responding MobiLink Listener.|
|remote_mluser (in)||Varchar||The MobiLink user name of the responding MobiLink Listener.|
|remote_action_return (in)||Varchar||The return code of the remote action.|
|remote_action (in)||Varchar||Reserved for the action command.|
|gateway (in)||Varchar||The gateway associated with the request.|
|address (in)||Varchar||The address associated with the request.|
|subject (in)||Varchar||The subject associated with the request.|
|content (in)||Varchar||The content associated with the request.|
Discuss this page in DocCommentXchange.
|Copyright © 2010, iAnywhere Solutions, Inc. - SQL Anywhere 12.0.0|