Creating a Working Folder

In StarTeam, each of the child folders in the view has its own working folder, which is generally relative to the path of the root working folder. When you check out a file, StarTeam copies the requested file revision to the appropriate working folder. If the working folder does not currently exist on your workstation, StarTeam automatically creates it for you when you check out files.

You can also add new files to StarTeam from a working folder. If the appropriate folder does not yet exist on your workstation, you can create it automatically by using the Create Working Folders command. Once the working folder exists, you can place files in it and add them to StarTeam.

Note: The default working folder must point to a location that is physically discrete for each user, such as a drive on that user's workstation or a personal directory on a shared file server.

To create a working folder, do the following:

  1. Select a folder from the folder tree or in the upper pane on the Folder tab.

    Note: A folder that exists in the StarTeam repository, but not on your local workstation, is represented by a folder icon with an exclamation mark on it.

  2. Do one of the following:

    • Check out a file from the folder. StarTeam will automatically create a working folder with the same name and the same path.
    • Right-click the folder and choose Create Working Folders. After the working folder exists, you can copy files to it or create files in it and add them to the StarTeam repository.

Note: If the working folder path for a shared or moved folder exceeds the operating system's maximum working folder path length of 254 characters (including [ \ ] backslashes), StarTeam will not allow you to create the working folder and displays an error message.