Running a Data Synchronization Task

Rules and Guidelines for Running a Data Synchronization Task

Use the following rules and guidelines when you run a Data Synchronization task:

•To run a Data Synchronization task that reads data from or writes data to a database, the Secure Agent and the corresponding database server must be running. The Data Synchronization task fails if either is not running.

•Verify that the source and target definitions are current. If the source or target no longer contains fields that are mapped in the field mapping, the Data Synchronization task fails.

•You cannot run multiple instances of a Data Synchronization task simultaneously. If you run a Data Synchronization task that is already running, the Data Synchronization task fails with the following error:

Data synchronization task <Data Synchronization task name> failed to run. Another instance of the task is currently executing.

If you configured the Data Synchronization task to run on a schedule, increase the time interval between the scheduled tasks to prevent multiple instances of the Data Synchronization task from running simultaneously. If you run the Data Synchronization task manually, wait for the currently running instance of the Data Synchronization task to complete before starting it again. You can view currently running Data Synchronization tasks in the activity monitor.

•The Data Synchronization task does not load any data into an IBM DB2 target if one or more records fails to load.

•When you use an active mapplet with a Data Synchronization task that includes a saved query, the Data Synchronization task ignores the configured target option for the task and tries to insert data to the target.

Running a Data Synchronization Task Manually

Run a Data Synchronization task manually to immediately start the Data Synchronization task. You might want to run a Data Synchronization task manually for the following reasons:

•To verify that the Data Synchronization task is configured properly.

•To load data into the target occasionally. You may not need to update the target on regular intervals.

When you start a Data Synchronization task manually, the activity monitor appears and shows you details about the task.

1. Click Task Wizards > Data Synchronization.

2. On the Data Synchronization Tasks page, click the Run Now icon for the Data Synchronization task that you want to run.

Running a Data Synchronization Task on a Schedule

Use a schedule to write data at a specified time or on regular intervals. Edit a Data Synchronization task to change the schedule associated with it.

1. To associate a schedule with a new Data Synchronization task, click Task Wizards > Data Synchronization > New, complete the preliminary wizard steps, and then click Schedule.

To associate a schedule with an existing Data Synchronization task, click Task Wizards > Data Synchronization, click the name of the Data Synchronization task, click Edit, and then click Schedule.

2. Select a schedule in the Schedule area, or click New to create a schedule.