ID conversion file

An ID conversion file maps PointID and Recno values from a source Data Archive to matching points on a target system. This mapping ensures that archived events are written to the correct points during migration or reprocessing, even when internal identifiers differ. Always use an ID conversion file when migrating archives between Data Archive servers to preserve data integrity.

File types

The mapping process uses two file types:

• ptidconv.out: An intermediate text file containing the point mapping data. This file must contain only three columns: PointID, Recno, and TagName.

• ptidconv.bin: A binary version of the mapping file generated from the text file. The offline archive utility (piarchss) requires the binary format to perform the conversion.

For steps to generate these files, see Create an ID conversion file.

Command-line options

The piarchss utility supports the following ID conversion options:

• -idci <path to ptidconv.out> -idco <path to ptidconv.bin>

  Use this option to convert the text mapping file (ptidconv.out) into a binary file (ptidconv.bin).

• -id <path to ptidconv.bin> -if <input archive> -of <output archive>

  Use this option to reprocess an archive with the specified binary mapping file.

Processing details

During reprocessing, the offline archive utility applies the mapping to all events in the input archive. The utility reports any points that do not exist on the target Data Archive. If the ptidconv.out file contains comments or summary lines, the utility returns an error. After processing, register the output archive on the target Data Archive.