The Workspaces Tab / The Open Workspace Dialog

The Workspaces tab displays summary information on some or all of the workspaces in the AccuRev repository. In addition, it lets you create, edit, and remove a workspace.

The Open Workspace dialog, a slight variant of the Workspaces tab, makes it easy to open a  File Browser tab on a selected workspace.

Opening a Workspaces Tab

Choose View > Workspaces from the GUI main menu.

Opening the Open Workspace Dialog Box

Choose File > Open Workspace from the GUI main menu, or click the Open Workspace button in the GUI main toolbar.

Workspaces Tab Layout

The Workspaces tab contains a table with these columns:

User

(appears if Show all workspaces is checked) The user who owns the workspace.

Status

(appears if Include deactivated trees is checked) Active indicates that the workspace is available for use. Inactive indicates that the workspace is currently deactivated. Inactive workspaces can be reactivated. See the Remove and Reactivate commands below.

Name

The simple name of the workspace, including the suffix that indicates the user who owns the workspace.

Location

The pathname of the workspace tree on the machine where it resides.

Host

The name or IP address of the machine where the workspace tree resides.

Stream#

The integer stream-ID of the workspace. This number is unique with the workspace's depot only, not across the entire repository.

Note: More precisely, this integer identifies the private workspace stream that is an integral part of the workspace. A depot's streams, snapshots, and workspaces share the same "pool" of stream-IDs.

Target Transaction

(appears if Show details is checked) The depot's transaction level at the time the Update command was most recently invoked on the workspace. Update attempts to load versions created in transactions up to and including the target transaction. If the Target Transaction and Update Level are the same, the workspace's most recent update completed successfully.

Update Level

(appears if Show details is checked) The highest-numbered transaction whose versions have been copied to the workspace in an update.

Type

(appears if Show details is checked) An integer that indicates the type of workspace stream: 1 (standard workspace), 9 (exclusive-file-locking), or 17 (anchor-required).

EOL

(appears if Show details  is checked) The type of line terminator used when an update copies text-file versions to the workspace tree: Auto (line terminator used by the host machine's OS), UNIX (NL), or Windows (CR-LF).

Working in a Workspaces Tab

You can apply filters to control the amount of data displayed in the workspaces table, and you can perform a number of operations on a selected workspace.

See also:

Working with Tables.

Controlling Which Workspaces are Displayed

Include deactivated trees

If checked, the table includes workspaces that have been deactivated with the Remove command. This also adds a Status column; deactivated workspaces have Inactive status, and are shaded.

Show all workspaces

If checked, the table includes workspaces created by all users. This also adds a User column.

If cleared, the table includes your workspaces only.

Controlling the Data Displayed for Each Workspace

Show details

If checked, the table includes these columns: Target Transaction, Update Level, Type, and EOL.

Operating on a Selected Workspace

You can choose any of the following commands from the context menu of a selected workspace:

Open (Workspaces tab)

Ok (Open Workspace dialog)

Using a File Browser tab, display the entire contents of the workspace.

Edit

Modify the configuration of the workspace.

Reactivate

Bring back into active service a workspace that was previously deactivated with the Remove command.

Remove

Deactivate a workspace. The workspace cannot be used to perform AccuRev commands, although the workspace tree is not changed in any way. The workspace no longer appears in the StreamBrowser display (unless you use the StreamBrowser's Include deactivated trees option).

You can use the Reactivate command to bring back a Remove'd workspace.

Creating a New Workspace

Click the New button at the bottom of the Workspaces tab to invoke the New Workspace wizard (see The New Workspace Command).