Running Replication
While running a replication process, the system first checks whether all data sets included in the current replication are released and displays an error message if otherwise. Moreover, each replication has to be released as well. After the replication process is completed successfully, the system creates Record Synchronization Entries and updates the Last Run Date and Time field on the Replication card page.
Running a Replication Manually
Choose the icon, enter Replications, and then select a related link.
Select the Run (Full) or Run (Incremental) action.
Note
It is possible to select multiple replications on the list and run them one after another.
Running a Replication using Job Queue
Replication can be set up using a job queue entry. It is recommended to use one job queue entry per replication with the incremental parameter. See Job Queue Setup.
Understanding Full and Incremental Replications
Each replication can be run in one of the two modes: Full or Incremental. Both replication methods include filters that are applied to a replication line or data set line and filters related to record-level setup. Each successful replication process updates the Last Run Date and Time field on its Replication Card page.
The Full replication loops through all the records in a data set. If no filters have been set up, all the records are exported each time the replication process is run. A record synchronization entry is created for each replicated record.
The Incremental replication includes only data that has been modified since the last replication. Tracking log entries are used to track the changes of the records (creation, modification, renaming and deletion). The replication creates record synchronization entries and deletes tracking log entries, which it used as a reference. See Tracking Log Entries.
If the Use Incremental field is not selected on the replication card, it is possible to run the Full processing (Tracking Log Entries are not created).
Note
If there is a parent record on the Tracking Log Entries (on top of a data set line) for which Always Include child is marked on a data set line then Record Synchronization Entries are created for all related tables defined in that data set.
Understanding Record Synchronization Entries
Record Synchronization Entries document the replication.
To see record synchronization entries of a particular replication:
Choose the icon, enter Replications, and then select a related link.
Select the Record Synchronization Entries action.
Review the following fields:
Entry No. - Specifies a sequential number.
Entry Type - Specifies a type of an entry. It can be: "Update" when data is replicated for the first time or updated, "Delete" when record was deleted from current or receiver company or "Rename" if rename operation was detected.
Action Type - Specifies what action was performed.
- Full - Full Replication.
- Incremental - Incremental Replication.
- Metadata - Metadata was sent (Disable Local Insertion, Disable Local Deletion, Disable Local Modify, Block Exception Filter).
- Records Management - Tool handling the deletion process from master.
- One-Time - One-time replication feature.
Source Type - Specifies if related to full/incremental replication or results from a Records Management operation.
Record ID - Specifies an ID of a record that was sent or deleted.
Target Table No. - Specifies a destination table number.
Target Table Name - Specifies a destination table name.
Date and Time - Specifies the date and time of a replication.
Status - Specifies record status.
- New - Newly created entries.
- Processed - Entries that processed successfully.
- Error - Entries for which a web service returned an error message.
- Cancel - Entries of status New that were canceled.
Processed Date & Time - Specifies the processing date and time.
Processed By - Specifies the ID of a user who processed the entry.
Error Text - Specifies the text of the message displayed after a processing error occurred.
Old Record ID - Specifies an old record ID to be used in case of record renaming. It points to the record that was renamed to be included in the receiver company.
Data Set No. - Specifies the data set number which was used for the replication.
Receiver No. - Specifies a number of the receiver. Important when the group receiver feature is used.
Synchronizing records
Synchronization is one of the tasks of the replication process. However, it can be run separately if Auto Synchronize is switched off in the MDMS Setup.
The Synchronize action on a Replication Card processes all entries pending for replication.
The Process action on the Record Synchronization Entries page processes all selected entries.
Record Synchronization Entry Details
Update and Rename operations can have Record Synchronization Entry Details created. The details show which fields and values were replicated.
To see record synchronization entry details:
Go to the Record Synchronization Entries page.
Select the Show Details action.
Review the following fields:
Field No. - Specifies a replicated field number.
Field Name - Specifies a replicated field name.
Field Value - Specifies a replicated field value.
Target Field No. - Specifies a destination field number.
Target Field Name - Specifies a destination field name.
Note
Details are generated only if Generate Record Sync. Details is marked in the MDMS Setup.
Group Receivers
With the group receivers feature, it is possible to process one replication simultaneously for multiple receivers. See Receiver Setup.
A group receiver can be used when a group of receivers always receives the same data.
Note
Replication with a group receiver can generate performance problems when processing a large volume of data.
Locked Replication
When the replication is being run or synchronized, it is set as Locked to avoid opening or double processing. Each replication can be unlocked manually by using the Unlock action available on the Replication Card and Replications pages.
Performance Log Entries
Performance Log Entries can be created during replication running and synchronization. Performance Log Entries are used to monitor and support performance issues. To use this feature, you must mark the Create Performance Log field in MDMS Setup.
Openning Performance Log Entries View
Choose the icon, enter Replications, and then select a related link.
Select the Performance Log Entries action.
Review the following fields:
- Entry No. - Specifies a sequential number.
- Entry Type - Specifies a type of entry. It defines the monitored part of the process.
- Replication No. - Specifies the number of the replication that it relates to.
- Receiver No. - Specifies the number of the receiver that it relates to.
- Data Set No. - Specifies the number of the data set that it relates to.
- Data Set Line Code - Specifies the data set line code.
- Starting Date & Time - Specifies the starting date & time of the processing.
- Measured Time - Specifies the process length.
- No. Of Records - Specifies the number of records that were processed.
- No. Of Fields - Specifies the number of fields that were processed.