ML_GET_SERVER_NOTIFICATION function [System]

This function allows UltraLite users to use light weight polling to query a notifier on a MobiLink server for server-initiated sync requests. Not supported by UltraLite Java edition databases.

Syntax

ML_GET_SERVER_NOTIFICATION( notifier, address, key )

Parameters

notifier The name of the notifier on the MobiLink server to poll.
address The stream parameters, specified as:
tcpip{host=pc1;port=1234}
key Optional. The notification request key.

If there are no requests for the given request key, or if the notifier name does not exist on the MobiLink server, the result is NULL. If NULL is provided for the request key, then the remote ID of the user is used as the request key. If a request does exist, the resulting message is returned in the form: [subject]content (for example, [sync]profile1).

This function communicates over the network as it retrieves responses from the MobiLink server. As a result, this function may require a long execution time resulting from network latency. During execution, there may be periods when the function can execute in the background, allowing work to be performed in the runtime on other connections. These periods are not guaranteed however, and depend on the complexity of the SQL. The recommended method for users to retrieve a MobiLink address to use in this function is to use the sync_profile_option_value function with an existing synchronization profile to get the value for the Stream profile option. The value returned by this function call can be used directly as the MobiLink address parameter.

Example

Discuss this page in DocCommentXchange.

ML_GET_SERVER_NOTIFICATION function [System]

Syntax

Parameters

Returns

Remarks

See also

Example