Pull Project From CVS wizard

Pulling a project from a repository configures your connection to that project in the repository and deposits the project in your own workspace. In a team environment, it connects you to the network of users who can make changes in that project.

A project only needs to be pulled once. Once you have access to it, maintain it using the other commands available from the Team menu and from the context menu in the project pane.

The Pull Project From CVS command is available from the Project tab of the object gallery (invoked by File|New) and from the Team menu (after you select a VCS for the project). This is the only version control command available from the object gallery.

Use the Pull Project From CVS wizard to check out a module into your workspace using JBuilder. This wizard has three steps: Select An Empty Target Directory, CVS Module Properties, and CVS Repository Properties.

Select An Empty Target Directory

In order to initiate CVS commands from within JBuilder, you must have a JBuilder project open. In this step of the wizard, JBuilder creates an empty project in order to have access to the necessary commands. The project created in this step will remain empty and JBuilder will use the module's own project file and directory structure when it pulls the module into your workspace.

Step 2: CVS Module Properties

The CVS Module Properties page has up to two areas to complete: connection type and login settings.

Note that the CVSROOT path is displayed at the bottom of the dialog box. For more information on CVSROOT, please see "Checking and setting user environment variables" in the "CVS Reference" in Team Development Using JBuilder.

Connect Type

Choose the type of server you need to connect to in order to access CVS.

If you have any questions about your connection type, ask your CVS administrator.

Login Settings

Enter your login settings according to the requirements of your connection type.

CVS Repository Properties

The third step sets repository properties and functional options. Once you have entered a repository path, a module name, or a branch, it becomes available for future use from the drop-down lists provided.

Repository

Type in or select the path to the CVS repository the module resides in. If you're using a local repository, you can click the ellipsis button to browse to the repository.

Type in or select the name of the module you want to check out.

Type in or select the branch you want to work on. The default is the main trunk.

Options

Autosave Files Before CVS Operations

Checking this option saves a step. If this box is unchecked and you execute a CVS command from JBuilder without saving the changes first, you will be prompted to save the files then. This option is checked by default.

Show Console Messages

This option displays the stdout output from CVS in the message pane of the IDE. This allows you to view the exact command-line feedback from CVS on each operation. This option is off by default.

When you have entered all of your settings, click Finish. JBuilder displays a feedback dialog that shows the progress of the checkout and lets you know when it's done. Click OK to close the dialog and return to the IDE, where the project is now displayed.

Pull Project From Visual SourceSafe wizard

Pulling a project from a database configures your connection to that project in the database and deposits the project in your own working area. In a team environment, it connects you to the network of other users who work on that project.

The Pull Project From Visual SourceSafe command is available from the Project tab of the object gallery (invoked by File|New) and from the Team menu (after you select a VCS for the project). This is the only version control command available from the object gallery.

The Pull Project From Visual SourceSafe wizard configures the project's connection and copies the current version of an existing VSS project into your work area. Normally, the wizard has four steps. However, if JBuilder doesn't have the path to the Visual SourceSafe runtime directory, this wizard has five steps: the first step sets this path. Once the path is set, it doesn't have to be set again.

One-time step: Setting the path to the runtime directory

This sets the path to the VSS database executable. It's usually the ss.exe file within the win32 directory on the VSS server. If you can't find anything that matches that description, contact your Visual SourceSafe administrator for the correct path.

Click Next to go to the next step.

Select Visual SourceSafe Database Directory

This points JBuilder to the directory containing the srcsafe.ini file, which it needs to use to access the database. Type it in or click the ellipsis button to navigate to it. If you don't know where it is, contact your VSS administrator.

Click Next to go to Step 2.

Enter Username And Password

Enter the username and password which you use to access Visual SourceSafe.

Click Next to go to Step 3.

Use the drop-down list to select the project you want to pull.

Tip: If no projects are available from the list, make sure that you're connected to the server where the database resides. If you are but you still see no projects, then JBuilder found no .jpx project files in the projects in the database. In this case, ask a VSS administrator about putting the project into JBuilder and checking it in so the project file will become available. Then you can pull the project using JBuilder.

Click Next to go to Step 4.

Select An Empty Target Directory

JBuilder creates a default empty directory. It must be empty because it will be overwritten by the project being pulled into it.

Finish button

Click Finish to create the connection and pull the project from the database. JBuilder displays a feedback dialog that reports the progress of the command. Click OK to close the dialog when it's done.

Pull Project From ClearCase wizard

Mount a VOB in JBuilder using the Pull Project From ClearCase wizard.

Mounting a VOB in ClearCase means creating a local virtual file system entry that mirrors the master VOB. You access this virtual file system using a ClearCase view, which provides a configuration specification for accessing the files. This wizard configures the necessary connections.

The Pull Project From ClearCase command is available from the Project tab of the object gallery (invoked by File|New) and from the Team menu (after you select a VCS for the project). This is the only version control command available from the object gallery.

Pull Project From ClearCase

The New Project From ClearCase wizard has one page with four fields to fill in: VOB, View, Drive, and Autosave Files Before ClearCase Operations.

VOB

Select the VOB you want to mount from the drop-down list of available VOBs.

View

Select the view you want to use to access the VOB.

Drive

Select the drive for the views. In Windows environments, ClearCase maps to the M: drive. In Linux and UNIX, it maps to /view/.

Autosave Files Before ClearCase Operations

Choose whether or not to have JBuilder automatically save your files before checking them in. This option is on by default.

Finish button

Click Finish to complete the wizard.

JBuilder gets the .jpx project file associated with this VOB and this view and pulls the files it refers to into your view.

If there is no .jpx project file, JBuilder creates one with the same name as the existing project.

Note: JBuilder automatically restarts all the views used previously to manage a JBuilder project. If you remove a view from ClearCase, remove it from JBuilder's user.properties file in the .jbuilder directory in your JBuilder installation.