INFO: Configuration files in GroupID Synchronize

Applies To:

GroupID 8, 9, 10 - Synchronize

Business Scenario:

What job files are involved in GroupID Synchronize? How do they work and what is the purpose of these files?

More Information:

Synchronize maintains different types of files for every job, job group, job template and job group template. There are three file types:

• Configuration file
• Report file
• Log file

The location of these files depends on the Windows version installed on your computer. You can find the Synchronize configuration folder using the Windows %ALLUSERSPROFILE% environment variable. On the Windows Run dialog box, type the following command (for GroupID 8):

Location:

For GroupID 8, the  Jobs, Group Jobs, Job Templates and Job Group Templates folders are available at the following path:

The configuration file: .dtmconfig

The configuration file is an XML document that stores the settings for jobs, job groups, job templates, and job group templates. When you open a wizard in Synchronize to create any of these, GroupID populates the wizard with the settings from the corresponding file. It has the extension: .dtmconfig.

Configuration file for jobs and job groups

For jobs and job groups, the configuration file is created and saved in the jobs subfolder.

• Job configuration files contain job settings.
• Job group configuration files contain job group settings and the settings for each individual job in the group.

When an existing job is added to a job group, Synchronize copies the settings of that job from its configuration file to that of the job group. Thus, it separates the sources so that changing one does not affect the other.

Configuration file for job templates and job group templates

A configuration file is created when an existing job or job group is saved as a template. During the save operation, Synchronize creates a duplicate of the original job or job group, thus separating the template's configuration so that later changes to the original job or job group settings do not affect it.

The report file: .dtmreport

Synchronize creates report files only for jobs and job groups. Report files are generated when a job or a job group is run. It contains the records of objects inserted, updated, removed or exchanged between the source and destination. Data from this file is displayed on the Reports tab of the Run Job and Run Job Group dialog boxes.

Synchronize creates a new report file each time a job or a job group is run and archives it. Unlike configuration files, report files are saved in the jobs folder in a subfolder named after the job or job group.

The log file: .dtmlog

The log file is generated along with the report file during a job or job group run and displayed on the Log tab of the Run Job and Run Job Group dialog boxes. This file is saved with the .dtmlog extension in the same location as the report file. Data written to the log file depends on the log settings for Synchronize.

Synchronize creates a new log file each time a job or job group is run and archives it.