Home / Siemens NX / Migrating custom tools to a new version of NX siemens NX

Migrating custom tools to a new version of NX siemens NX

If you make changes to the tool libraries that are installed with NX in a native environment in a previous release, then you must do a one-time conversion of your prior tool databases to the current format for each new release. You must perform the conversion for both the English and metric tool_database.dat files. These are located in the folders identified by the variables UGII_CAM_LIBRARY_TOOL_ENGLISH_DIR and UGII_CAM_LIBRARY_TOOL_METRIC_DIR.


Before doing the conversion, make backup copies of both of these files.

Customization and conversion applies to any or all of these files:

  • dbc_tool_general.tcl

  • dbc_tool_ascii.def

  • dbc_tool_ascii.tcl

  • dbc_tool_ascii_export.tcl

  • dbc_tool_build_ascii.tcl

  • segmented_tool_ascii.def

  • segmented_tool_ascii.tcl

  • english\tool_database.dat

  • metric\tool_database.dat

The conversion program creates a file in the same folder as the input library with the name <input_file_name>_converted.dat, where <input_file_name> is the name of your original customized tool library.

The conversion program does the following:

  • Reads the specified tool_database.dat file from a previous release and adds all converted new and uniquely identified tools to the current tool_database.dat.

  • For any tool that has a tool holder defined, the conversion program merges the holder into the current holder library holder_database.dat, unless it already matches an existing holder. The software outputs the appropriate tool holder LIBRF data (library reference) with the converted tool record.

  • Passes unrecognized tools, for example if you created a class, and records which are not FORMAT or DATA records, for example comments, through to the <input_file_name>_converted.dat file in the same folder as your original input database file.

  • Removes data fields that you have removed from a library class.

  • Appends data fields that you have added to a library class at the end of the records, and uses a default value.

  • Skips any tool in the library to be converted that matches the LIBRF of a tool in the current NX Library.


    If you modified the records of the default tools and want to keep the changes, you must assign each of the modified tools a unique library reference before you do the conversion. If you do not, your changes will not be migrated.


    When you add tools to the library, the software starts numbering at number much higher than the last out of the box tool This prevents new tools that are added in the next release from having conflicting LBREF data with tools that you add.

    It is useful to define your own identifier prefix and set the identifier for each modified tool before you export it as a new library entry. For example, if your company name is ABC, call your modified tools abc_0001, abc_0002, and so on.

Leave a Reply

Your email address will not be published. Required fields are marked *