Topic 4.2.1: Backing Up and Restoring the Tagname Dictionary

  • InTouch has two utility programs to back up and restore your Tagname Dictionary:
    • DBDump: Exports an InTouch application Tagname Dictionary as a .CSV (Comma-Separated Value) file that can be viewed or edited in any program supporting.CSV files. Microsoft Excel is recommended for this task.
    • DBLoad: Imports an InTouch application Tagname Dictionary as a .CSV (Comma-Separated Value) file that can be viewed or edited in any program supporting .CSV files. Microsoft Excel is recommended for this task.
  • Both the DBDump and DBLoad utilities can be started from the InTouch App Manager for Stand Alone InTouch, or the ArchestrA IDE for a Managed application.

  • You must specify how DBLoad handles duplicate tag records while loading data from the import file into an application’s Tagname Dictionary. 

  • If you use a import file template created with DBDump, the first line of the file contains the :mode keyword. For example, you can assign the value ask to the :mode keyword in cell A1 of the Excel application.

  • You can assign the following values to a :mode keyword:
    • :MODE=REPLACE: If a duplicate tag is encountered, the DBLoad utility deletes the existing tag in the Tagname Dictionary and replaces it with the tag from the import file with the same name.
    • :MODE=UPDATE: If a duplicate tag is encountered, the DBLoad utility overwrites the existing tag definition in the Tagname Dictionary only with data explicitly specified from the import file. All other data associated with the tag remains unchanged in the Tagname Dictionary.
    • :MODE=ASK: DBLoad stops when a duplicate tag is encountered while loading the Tagname Dictionary. The Duplicate Name dialog box appears and shows a list of options to handle duplicate tags. This is the default import mode.
      • Options for handing duplicates are:

    • :MODE=IGNORE: The DBLoad import utility ignores the duplicate tag and continues processing the remaining records of the import file.
    • :MODE=TERMINATE: The DBLoad import operation stops when a duplicate tag is encountered.
    • :MODE=TEST : 
      • DBLoad scans the import file for errors and does not attempt to load tag definitions into the Tagname Dictionary. DBLoad generates a report that identifies any format errors by line number and location in the import file.
      • Run DBLoad with :mode=test first to identify any errors in the import file. After correcting any errors, change the mode keyword value to :mode=replace or :mode=update before running DBLoad.

Last modified: Tuesday, 24 March 2020, 11:22 AM