With this dialog, you enable and configure the change control support provided by the IDE. This customization applies to the local machine and all users on that machine.
The Extract Command field contains the command called when you select the Extract action from an object's pop-up menu to extract a file from the change control system. Extract gets a copy of the file for reading only without any change privileges. You can edit the command in this field, or click Defaults to open a dialog box where you select a change control system. The default command for the change control system you select is displayed in the entry field.
The Checkout Command field contains the command called when you select the Checkout action from an object's pop-up menu to check a file out of the change control system. Checking out a file usually gives you the right to change the file, and to later put it back into the change control system through the Checkin action. You can edit the command in this field or click Defaults to open a dialog box where you select a change control system. The default command for the change control system you select is displayed in the entry field.
The Checkin Command field contains the command called when you select the Checkin action from an object's pop-up menu to check a file into the change control system. This action removes your lock on the file and allows other users to check out the file. You can edit the command in this field or click Defaults to open a dialog box where you select a change control system. The default command for the change control system you select is displayed in the entry field.
The Common Command Parameters field contains information you want appended on to the final library command. This is useful for parameters that apply to all of the commands. For example, if you have an environment variable that you want to temporarily override, this field allows you to make the change without having to bring the IDE down, change the variable, and then start the IDE back up.
The Relative Path Name field contains a path name that is added on to a file name when it is stored on the file system. For example, the path name of the file while stored in the change control system may be payroll\main.cpp, but on your file system it may stored as c:\myFiles\payroll\main.cpp. It this case c:\myFiles would be the relative path name that is automatically inserted and removed in the generated change control commands.
There are three variables that are substituted at run time and can be used in the three change control commands:
For example, if the relative path name is "c:\myFiles", the command is "teamc part -extract &fileName -relative &relativePathName", and the file selected for extraction is "c:\myFiles\payroll\main.cpp", then the command generated is "teamc part -extract payroll\main.cpp -relative c:\myFiles".
Check the Enable Change Control Support check box to enable the change control features. If this check box is clear, the change control actions will not appear on the IDE menus, and the command fields in the dialog box are disabled.
Check the Enable Initial Change Control Prompt check box to display the Change Control Prompt dialog box when a change control action is selected. The Change Control Prompt dialog box allows you to change the change control command before it is submitted for processing. If this check box is clear, the Change Control Prompt dialog box will only been shown if an error occurs during the processing of the library command.
Check the Enable Notification for Successful Commands check box if you want to see a dialog box when your command completes successfully. By default this is not checked, so if the library command is successful and does not write anything to stdout or stderr, then no dialog box appears.
Click OK to save the current values in the Change Control Configuration dialog box, and close the dialog box. Click Cancel to close the dialog box without saving the current values. Click Defaults to select default commands from some popular change control systems.
