Checking Out Files with Options

Select the file(s) that you wish to check out from one of the Eclipse Explorers or from any view that surfaces the Team context menu.

Choose Team > Check Out with Options from the context menu. The Check Out dialog box opens.

Optional: Check the following options:

Force check out to overwrite any files with the same name in your working folder, even if they are more recent.
Show check-out statistics

For a particular check-out operation, you can see how many files are being sent by StarTeam directly and how many are being sent by Cache Agent by displaying the check-out statistics. After the check out operation completes, the Check Out Statistics dialog box opens displaying the elapsed time, total number of files, total number of bytes, and whether the check-out operation skipped or failed to check out any of the files.

Expand Reference By, and select one of the following options for the files you wish to check out:

Current revision: The most current (tip) revision.
Label : A specific file revision. The view labels precede the revision labels in the list.
Promotion state: A specific promotion state.
Configuration as of: The revision that was the tip revision at the specified date and time. Click the Date/Year button to use the calendar, and specify the time by typing in the time or using the spin boxes.

Expand Lock Status, and select one of the following lock options:

Unlocked: Does not lock the files you are about to check out, or causes them to be unlocked if you currently have them locked. Be aware that when you check out an unlocked file, it may become read-only in your working folder.
Note: There is a project property and a Preferences option that controls the read-only or read/write status of working files.
Exclusive: Indicates that you intend to make further changes to the files.
Non-exclusive: Indicates that you are working on the files and may possibly make changes.
Keep Current: Retains the current lock status.

Optional: expand EOL Conversion, and choose one of the following:

None or another button to change your current EOL conversion setting.
For Windows, the EOL marker is CR-LF (carriage return/line feed).
For UNIX, it is LF (line feed).
For Macintosh operating systems, it is CR (carriage return).

EOL settings on this dialog override the default setting you selected on the File page of the Personal Preferences dialog box.

Expand Advanced to optionally select an appropriate File Encoding from the list box to support keyword expansion for non-English code pages.

In the Changes area you can optionally: Show flat, tree, or compressed folder views by selecting the various toolbar buttons in the Changes area toolbar.

Select a file and click Compare with Revision in the Changes area toolbar to compare the local file with the tip revision of the file in the repository.

Note: The dialog box also provides a Configure Personal File Options link so you can quickly make modifications to file options before completing the checkout.

Click OK to complete the check out.

Note: You can also use the Get incoming changes from StarTeam Server button on the toolbar to check out files without using the Check Out dialog box. If process rules are required, the Check Out dialog box opens automatically.