The wizard generates two sets of objects.
The first set of objects lets the end user initiate and monitor synchronization:
nvo_appname_sync – a custom class user object that controls the MobiLink client (appname is the name of your application)
gf_appname_sync – a global function that instantiates the user object and calls a function to launch a synchronization request
s_appname_sync_parms – a structure that holds the MobiLink user’s name and password, and the remote database user and password
w_appname_sync – a status window that reports the progress of the synchronization process
In the wizard, you can choose whether the application uses the status window. The alternatives are to display the standard MobiLink dbmlsync log window or to display no status window. The generated status window has the advantage of including an OK button that lets the user view the status before dismissing the window, and a Cancel button that lets the user cancel synchronization before it completes. You can also customize the window to fit your application’s needs.
The second set of objects is generated only if you select Prompt User for Password and Runtime Changes in the wizard. It lets the end user change synchronization options before initiating synchronization:
w_appname_sync_options – an options window that lets the end user modify the MobiLink user name and password, the host name and port of the MobiLink server, and other options for dbmlsync, and choose how to display status
gf_appname_configure_sync – a global function that opens the options window and, if the user clicked OK, calls gf_appname_sync to initiate synchronization
Most applications that use the options window provide two menu items or command buttons to launch synchronization: one to open the options window so that users can set up or modify dbmlsync options before requesting a synchronization, and one to request a synchronization with the preset options.
