StarTeamMPX Options

Servers that use StarTeamMPX offer additional caching services and performance enhancements. To take advantage of these benefits, StarTeamMPX must be enabled and configured on your workstation so that any open project view can take advantage of StarTeamMPX.

Select Tools > Personal Options > StarTeamMPX

StarTeamMPX Status Indicators

The right end of the application status bar displays the current status of StarTeamMPX on your workstation. The words and icons on the status bar for StarTeamMPX are as follows:

Yellow lightning bolt

Indicates that MPX is available and enabled for the currently selected project view.

If Web Edition can use the default client profile for an MPX-enabled server and, therefore, take advantage of MPX, this icon appears in front of the server configuration’s name in the browser window.

Gray lightning bolt

Indicates that MPX is available for the currently selected project view but that it has not been enabled in the client.

Red circle with a slash beside a yellow lightning bolt

Indicates that MPX is enabled for the currently selected project view, but something happened to break the connection. For example, the Message Broker may be stopped.

(no icon)

Indicates that MPX is not available for the currently selected project view.

Instant

Indicates that MPX’s auto-refresh is turned on.

Auto

Indicates that your workstation’s auto-refresh is turned on, but that MPX’s auto-refresh is either turned off or unavailable. (Your workstation’s auto-refresh option is on the Workspace tab of thePersonal Options dialog box.)

Manual

Indicates that your workstation’s auto-refresh is turned off and that MPX’s auto-refresh is either turned off or unavailable. You must manually refresh the current project view by pressing F5.

Back to top

Options for StarTeamMPX

Enable

Enables your workstation to use StarTeamMPX if it is available on the server. Changing this check box does not affect open projects. StarTeamMPX is enabled by default.

Automatic refresh with

Enables automatic refresh of the application window by way of MPX, with options for setting the minimum and maximum delay times between refreshes. The default minimum is 30 seconds, and the default maximum is 0– seconds. If this option is not selected, you must refresh manually (Shift+F5.)

When Automatic Refresh is enabled, after every change to the view, StarTeam waits a minimum number of seconds before refreshing. That means that if changes are infrequent, the application performs a refresh almost immediately. However, if changes are frequent, the minimum refresh timer is constantly being reset and never reaches the number of seconds set for a refresh. In such cases, the next refresh occurs when the maximum number of seconds between refreshes forces a refresh.

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.

Use MPX Cache Agent for
File Content Use the MPX Cache Agent to retrieve file content.
Item Properties Use the MPX Cache Agent to retrieve item properties.
Use MPX Cache Agent at Designates a specific MPX Cache Agent to use by IP address and port number.
Automatically locate the closest MPX Cache Agent for StarTeamMPX Server Locates the network nearest MPX Cache Agent automatically, but only if the server is MPX-enabled.
Maximum request threads Specifies the maximum number of request threads allowed. The default is 2, and 2 to 3 should be adequate for most of your needs.

Back to top