Workspace Options

The Workspace personal options allow you to select a variety of options that affect the way your workspace operates.

Select Tools > Personal Options > Workspace

Confirm
Delete Displays a Confirm dialog box for deletions.
Move/Share Displays a Confirm dialog box for move and share operations.
Warnings Displays a Confirm dialog box for warnings.
Display
Toolbars Displays Toolbars.
Status bar Displays the Status Bar.
Custom tools Displays custom tools created as part of StarTeam Extensions. If no custom tools are configured, clear the Custom tools check box to prevent custom tools from attempting to load with each view window.
Show history times as UTC Displays time stamps in the Time column of the history pane in UTC times. UTC times end in “Z” to differentiate them from local times (Z stands for the "zero meridian", which goes through Greenwich, England). Displays time stamps in local time when not selected.
Sort view labels by name Automatically sorts view labels alphabetically.
General
Restore folder selection on tab change Returns StarTeam to the last folder that was selected for a specific component tab. If you have not selected a particular tab in this session, StarTeam automatically selects the root folder for the view.
Reset scope to local on folder change Resets the All Descendants button on the toolbar every time you change a folder. This saves you the time StarTeam would take to scan items. If not selected, you must select the button manually.
Maintain group state on folder/scope change Keeps your place in the upper pane even when you change folders or reset the All Descendants button. If not selected, all groups collapse when you make a folder or scope change.
Open URL in new window The default setting for the way a view displays in your workspace when you open a URL link. When this check box is selected, any StarTeam view you open via a URL opens in a new window.
Automatic refresh with maximum delay of ___ minutes

Specifies the maximum number of minutes between refreshes of your project. This refresh is the equivalent of pressing Shift + F5 and updates the Folder Tree and the upper pane. It happens every X minutes unless an operation by the user such as pressing Shift+F5 forces a refresh and resets the timer.

Automatic refresh is designed to perform even if the client is minimized. When Automatic refresh enabled, if the network is down, Automatic refresh will attempt to refresh the data in the client resulting in a connection error.

Restore shortcuts at startup

Reopen at startup any views that were left open when you exited the application the previous time.

Enable File System Watching If selected, then the operating system notifies the StarTeam Cross-Platform Client if files/folders are added, modified, or removed from the file system. If not selected, then no such notification occurs.
Sort open windows by name If selected, sorts the opened windows by name. By default, windows are sorted by the order in which they are opened.
TimeSpan Format Pattern Allows you to specify a format for TimeSpan type properties. For details, see Time Span formats.
Reports
Report output path

Specifies the name and path to which your reports should be sent

StarTeam
client log
Log output path

Specifies the name and path for your StarTeam.Log files. The StarTeam.Log file contains data about operations sent from your workstation to one or more servers, depending on what project views you have open. The data includes the name of the project so that you can isolate data for a particular server when necessary.

Log errors

Records errors that occur while you are using the client application. The errors log lists the date and time you started your server configuration and any errors or failed operations between the server and client. The application identifies each failed operation by an internal ID and provides an explanation. For example, you might see: ...Operation 40956 failed: TCP/IP Socket Error 10054:.... If you are logging both errors and operations, the application also logs the operation that the server was performing at the time of the error.

Log operations and events that take at least ___ (milliseconds)

Specifies that StarTeam should record file operations and/or events that take at least the specified number of milliseconds, and should send them to the .log files. The milliseconds time setting stops the log from filling up with operations and events of little importance. The default, 10 milliseconds, is a reasonable setting.

The Summary option includes a breakdown of the time spent on the client and the server for each operation, and the Details option lists the server commands along with the summary.

This option records information on the date, time, and UI Operation number for each command executed by your workstation. Operations can be executed on either the server or the client.

Log StarTeamMPX events

Specifies that StarTeamMPX events should be sent to the .log files. The log identifies the time and date on which a StarTeamMPX event (an automatic refresh or file status update) took place. The log prefaces a StarTeamMPX event as Statistics for Events and uses internal IDs and brief explanations to identify the server event.

The following example describes a status change for a file: ...Statistics for Events /1b21dd1-e208-51ea-01b2-1dd1e20851ea/Object/File/ Modify.

You can log StarTeamMPX events only if you check Enable StarTeamMPX on the StarTeamMPX tab in the Personal Options dialog box. For StarTeamMPX related operations, any changes you make on the Workspace tab do not apply to projects already open. However, the application will log StarTeamMPX events for any projects you open after checking this option.

Advanced
Options
Button
Component Order for ServerName Specifies the display order for the component tabs in the application. The tab display to the left of the Component Order button displays the tabs in the order you chose. Click Component Order.

Note: It is necessary to close and reopen the project for changes to the component tab order to take effect.

Note: Never list the Audit component tab first in the component list. Doing so greatly impacts performance.

Look and feel

Changes the look and feel of the application.

Note: This option is not available in the StarTeam Visual Studio Plugin.

Font adjustment

Increases or decreases the application font size.

Note: This option is not available in the StarTeam Visual Studio Plugin.

Application Instance

Specifies the default behavior for opening another instance of StarTeam when using a shortcut or URL.

Using a URL or shortcut defaults to using an open instance of the StarTeam Cross-Platform Client to open. However if the client has a dialog open inside some view (or some other modal operation in process), StarTeam cannot use open a project view in that client. In such situations, when you click a URL from email (for example) or a shortcut on your desktop, or a .vcmx file attached to a change package, a new instance of StarTeam is opened only if the option selected from the Application Instance group box allows it. If the option is not selected, and you try to open a shortcut, you may get an error saying your StarTeam Cross-Platform Client is busy.

Note: This option is not available in the StarTeam Visual Studio Plugin.

Component Order for ServerName Specifies the display order for the component tabs in the application. The tab display to the left of the Component Order button displays the tabs in the order you chose. Click Component Order.
    Note:
  • You must close and reopen the project for changes to take effect.
  • Do not list the Audit component tab first in the component list, as it will substantially impact the performance.

Back to top

Time Span formats

The TimeSpan Format Pattern option lets you set a format for TimeSpan type properties.

Syntax

A sequence of format terms can be enclosed in rectangle brackets, [], to indicate that they are optional. An optional format term is included in the formatted string only if it contains at least one field-name whose value is non-zero.

format: format-term [format-term ...]

format-term: optional-term | required-term

optional-term: '[' format ']'

The following shows a parameterized term that contains a field-name, which gets replaced by a value derived from the TimeSpan. Other components of the field-specifier are optional, and influence the formatting of field-name.

required-term: field-specifier | literal

field-specifier: [width-specifier] field-name[unit-specifier][fraction][label-specifier]

The following term specifies the field width. For example, '2s' shows the number of seconds padded with leading zeros if necessary to obtain a width of 2 digits.

width-specifier: positive-integer

The following term inserts a number derived from the TimeSpan.

field-name: 'y' | 'n' | 'w' | 'd' | 'h' | 'm' | 's' | 'f' | 'u'

The field names are interpreted as follows:

  • y: Years. Defined as 365-day intervals. If you want to use a different definition of years, then use unit-specifier. For example 'y=365.25d' might be used to display the number of 365 1/4 -day years.
  • n: Months. Defined as 30-day intervals. If you want to use a different definition of months, then use unit-specifier.
  • w: Weeks. Defined as 7-day intervals. If you want to use a different definition of weeks then use unit-specifier.
  • d: Days.
  • h: Hours.
  • m: Minutes.
  • s: Seconds.
  • f: Milliseconds.

  • u: An alias for the native units that are used in the repository to represent property values for this property.

    • The native units may be days, hours, minutes, etc.
    • The alias may also be a custom value that doesn't correspond to one of the recognized named units. In this case, the label-specifier, if provided, is ignored.
    • You can add your own label as a literal string, but it won't be localized.

Examples

Format String

Comment

Actual Value

Display Value

u.0:2

The  examples below assume the storage unit in the repository is 1.0 hours

26.505556

4.500000

2.000000

0.250000

26.51

4.5

2

0.25

[d.]2h:2m:2s.0:7

The format used by System.TimeSpan.ToString() under .NET. Oracle uses a similar format for their time spans (except that the period after the optional day component is replaced by a space)

26.505556

4.500000

2.000000

0.250000

1.02:30:20.0016

04:30:00

02:00:00

00:15:00

[[d+, ]h+, ]m+[, s.0:2+]

A verbose display format, displaying minutes and component labels.

26.505556

4.500000

2.000000              

0.250000

1 day, 2 hours, 30 minutes, 20.002 seconds

4 hours, 30 minutes

2 hours, 0 minutes

15 minutes

d=8h+

Displays 8-hour man-days

26.505556

4.500000              

2.000000              

0.250000

3 days

1 day

0 days

0 days