Programmer's Guide > Using the AOM > Using COM to Access the AOM > Registering and Unregistering Arbortext Editor as a COM Server
  
Registering and Unregistering Arbortext Editor as a COM Server
When you install Arbortext Editor, the setup program automatically registers PTC ArbortextEditor as a COM server. The uninstall program will unregister Arbortext Editor as a COM server.
Starting with release 5.4, Arbortext Editor also automatically checks at startup to see whether the application is registered as a COM server. If Arbortext Editor finds that it is not registered as a COM server, it performs a COM registration for Arbortext Editor itself and all of its installed components as part of the startup process. This check can be disabled with the APTNOCOMCHECK environment variable. If the automatic registration fails for some reason (usually because the user does not have administrator privileges), Arbortext Editor still opens but displays an error message first saying that this version is no longer configured correctly. In this case, some Arbortext Editor components might not be available. You can keep Arbortext Editor from opening in this case with the APTFAILIFNOCOM environment variable.
If you run a version of Arbortext Editor earlier than 5.4 on the same system with your current version, you might encounter problems with the earlier version’s COM registration due to the new automatic COM registration. You can obtain a utility called register.bat from PTC Technical Support that will correctly register releases of Arbortext Editor prior to 5.4. For more information, search the Technical Support knowledge base for TPI 144503.
You can manually register or unregister a PTC ArbortextEditor installation at any time by running Arbortext Editor with the -RegServer, -UnregServer, or -UnregAnyServer startup command options. In the examples that follow, the first path to the editor.exe binary is for 64-bit installations, and the second path is for 32-bit installations.
Arbortext-path\bin\x86\editor.exe -RegServerArbortext-path\bin\x86\editor.exe -RegServer
Arbortext-path\bin\x64\editor.exe -RegServerArbortext-path\bin\x86\editor.exe -RegServer
Registers a specific Arbortext Editor installation as a COM server.
Arbortext-path\bin\x86\editor.exe -UnregServerArbortext-path\bin\x86\editor.exe -UnregServer
Arbortext-path\bin\x64\editor.exe -UnregServerArbortext-path\bin\x86\editor.exe -UnregServer
Unregisters a specific Arbortext Editor installation as a COM server. Note that the -UnregServer option will not remove the editor.exe COM server entry in the registry, unless the Arbortext Editor installation you are running matches the Arbortext Editor installation listed as the current editor.exe COM server.
Arbortext-path\bin\x86\editor.exe -UnregAnyServerArbortext-path\bin\x86\editor.exe -UnregAnyServer
Arbortext-path\bin\x64\editor.exe -UnregAnyServerArbortext-path\bin\x86\editor.exe -UnregAnyServer
Unregisters any version of Arbortext Editor on the system as a COM server, not just the installation for which you are using the option.
Related topics
Using the Acl interface
Startup command syntax
APTNOCOMCHECK — Do not perform a COM check and automatic registration on startup
APTFAILIFNOCOM — Silently fail when COM check and automatic registration fails on startup