Working with Agents in Sybase Central

After an Agent is created and configured on the client device using the mlagent command, the Agent must also be created in Sybase Central before it can be assigned tasks. The Create MobiLink Agent Wizard guides you through the creation of the Agent, where you specify the information that is required for the Agent to be properly identified.

Note that you must have a remote schema name defined before you can create an Agent in Sybase Central.

To add a remote schema name (Sybase Central)

Ensure the MobiLink project you are working with is selected in the left pane in Folders view, right-click Remote Schema Names and choose New » Remote Schema Name.
Follow the instructions in the Create Remote Schema Name Wizard and click Finish.

To add an Agent (Sybase Central)

Ensure the MobiLink project you are working with is selected in the left pane in Folders view, expand Consolidated Databases, right-click Agents and choose New » Agent.
Follow the steps in the Create MobiLink Agent Wizard.

Once the Agent is created in Sybase Central, you can do the following:

view and change Agent properties
add remote databases for an Agent to manage
synchronize an Agent
delete an Agent
view events for an Agent
view tasks for an Agent
view information about remote databases managed by an Agent

Viewing and changing Agent properties

Agent properties can be viewed and edited from the Agent Properties window in Sybase Central. You can also set the following properties by right-clicking an Agent and choosing Set, then the property you want to set:

Synchronization Interval
Administration Polling Interval
MobiLink Client Network Protocol Options
Connection Strings for Managed Databases

The MobiLink client network protocol options are an Agent property that is specified on the client and sent up to the server when the Agent first synchronizes. If an administrator changes an agent's MobiLink protocol options, the new value is sent to the Agent when it synchronizes, and the Agent uses the new value for all subsequent communicates with MobiLink.

If an administrator sends invalid MobiLink communication options (for example, an incorrectly set server host name) it may become impossible for the Agent receiving that value to communicate with the MobiLink server any more. In this case, the administrator must correct the MobiLink client network protocol option in Sybase Central, and then have the Agent re-configured on the device to the correct set of options.

To view or change Agent properties (Sybase Central)

Ensure the consolidate database you are working with is expanded in the Folders view of the MobiLink 12 plug-in for Sybase Central. Expand Agents, right-click the Agent you want to worth with and choose Properties.
If necessary, make changes to the properties and click Apply.

Adding managed remote databases

In order for an Agent to manage a remote database, the database must be associated with the Agent in Sybase Central. This is done by specifying a remote schema name.

To add a managed remote database (Sybase Central)

Ensure the consolidate database you are working with is expanded in the Folders view of the MobiLink 12 plug-in for Sybase Central. Expand Agents, right-click the Agent you want to worth with and choose Add Managed Remote Database.
The available remote databases are represented by remote schema names. Choose a Remote Schema Name from the dropdown list.
Enter a connection string for the remote database and click OK.

The connection string is used on the client device. All ODBC data sources or paths and/or files must be valid for the device.

Adding a group

A group is a collection of MobiLink Agents. You must have one of more Agents defined before you can create a group.

To add a group (Sybase Central)

Ensure that your consolidated databases are running.
Ensure the MobiLink project you are working with is selected in the Folders view in the left pane, then right-click on the project name and choose New » Group.
Follow the instructions in the Group Wizard and click Finish.

Discuss this page in DocCommentXchange.