Synchronization APIs

• + (void)loginToSync:(NSString *)user password:(NSString *)pass – loginToSync synchronizes the KeyGenerator from the Unwired Server with the client. The KeyGenerator is an MBO for storing key values that are known to both the server and the client. On loginToSync from the client, the server sends a value that the client can use when creating new records (by using the method [KeyGenerator generateId] to create key values that the server accepts).
  The KeyGenerator value increments each time the generateId method is called. A periodic call to submitPending by the KeyGenerator generateId MBO sends the most recently used value to the Unwired Server, to let the Unwired Server know what keys have been used on the client side. Place this call within a try/catch block and ensure that the client application does not attempt to send any more messages to the server if loginToSync throws an exception.

• + (void)beginOnlineLogin:(NSString *)user password:(NSString *)pass – beginOnlineLogin is the recommended login method. It functions similarly to loginToSync, except it sends the login request asynchronously (it returns without waiting for a server response). This method checks the SUPMessageClient status and immediately fails if the status is not STATUS_START_CONNECTED. Make sure the connection is active before calling beginOnlineLogin, or implement the onLoginFailure callback handler to catch cases where it may fail.

[SampleApp_SampleAppDB beginOnlineLogin:@"supUser" password:@"s3pUser"];