Changing the default application tools

The merge tool, compare tool, and editor are set by default in the ccm.properties file. The file is located in the etc directory of the client installation on both Windows and UNIX. You can change the default application tools settings on Windows in the ccm.user.properties file located in the profile directory. On UNIX, you can change the settings in the .ccm.user.properties file located in your home directory.

Default applications for Windows

About this task

Windows option Description
windows.tool.edit.project Defines the utility used to edit a project on a Windows system.
windows.tool.edit.dir Defines the utility used to edit a directory on a Windows system.
windows.tool.view.project Defines the utility used to view a project on a Windows system.
windows.tool.view.dir Defines the utility used to view a directory on a Windows system.
windows.tool.compare.ascii Defines the utility used to compare files on a Windows system.
windows.tool.merge.ascii Defines the utility used to merge files on a Windows system.
Note: Rational Synergy requires the double backslash separators.
windows.tool.compare.ascii = %ccm_compare
windows.tool.compare.binary = FAIL
windows.tool.merge.ascii = %ccm_merge
windows.tool.merge.binary = FAIL
windows.tool.edit.ascii = "%ccm_home\\bin\\util\\ccm_exec" "%file1"
windows.tool.edit.binary = "%ccm_home\\bin\\util\\ccm_exec" "%file1"
windows.tool.edit.executable = "%file1"
windows.tool.edit.project = explorer.exe "%file1"
windows.tool.edit.dir = explorer.exe "%file1"
windows.tool.view.ascii = "%ccm_home\\bin\\util\\ccm_exec" "%file1"
windows.tool.view.binary = "%ccm_home\\bin\\util\\ccm_exec" "%file1"
windows.tool.view.executable = "%file1"
windows.tool.view.project = explorer.exe "%file1"
windows.tool.view.dir = explorer.exe "%file1"
Note: The values shown are only examples. You can use other commands.

The following keywords are available:

edit: %file1, %ccm_home
view: %file1, %ccm_home
help: %file1, %ccm_home
FAIL: operation is not supported for that command
compare: %file1, %file2, %file1_label, %file2_label, %ccm_home
merge: %outfile, %ancestor %file1, %file2, %file1_label, %file2_label, 
ccm_home

Where %file1 is the first filename. %ccm_home is the directory where the client is installed. %file2 is the second filename. %file1_label and %file2_label are labels for the files. %ancestor is the common ancestor file used by merge. %outfile is the merged results.

Default applications for UNIX

About this task

UNIX option Description
unix.tool.edit.project Defines the utility used to edit a project on a UNIX system.
unix.tool.edit.dir Defines the utility used to edit a directory on a UNIX system.
unix.tool.view.project Defines the utility used to view a project on a UNIX system.
unix.tool.view.dir Defines the utility used to view a directory on a UNIX system.
unix.tool.compare.ascii Defines the utility used to compare files on a UNIX system.
unix.tool.merge.ascii Defines the utility used to merge files on a UNIX system.
unix.tool.compare.ascii = %ccm_compare
unix.tool.compare.binary = FAIL
unix.tool.merge.ascii = %ccm_merge
unix.tool.merge.binary = FAIL
unix.tool.edit.ascii = xterm -geometry 80x40 -e vi %file1
unix.tool.edit.binary = FAIL
unix.tool.edit.project = /bin/sh -c ^(cd '%file1'; xterm)^
unix.tool.edit.dir = /bin/sh -c ^(cd '%file1'; xterm)^
unix.tool.view.ascii = xterm -geometry 80x40 -e vi %file1
unix.tool.view.binary = FAIL
unix.tool.view.project = /bin/sh -c ^(cd '%file1'; xterm)^
unix.tool.view.dir = /bin/sh -c ^(cd '%file1'; xterm)^
Note: The values shown are only examples. You can use other commands.

The following keywords are available:

edit: %file1, %ccm_home
view: %file1, %ccm_home
help: %file1, %ccm_home
FAIL: operation is not supported for that command
compare: %file1, %file2, %file1_label, %file2_label, %ccm_home
merge: %outfile, %ancestor %file1, %file2, %file1_label, %file2_label, 
ccm_home

Where %file1 is the first file name. %ccm_home is the directory where the client is installed. %file2 is the second file name. %file1_label and %file2_label are labels for the files. %ancestor is the common ancestor file used by merge. %outfile is the merged results.


Feedback