Known Issues

This section covers issues about which you may need to be aware.

Revision Assumptions

StarTeam Notification Agent assumes that only StarTeam Notification Agent and the users set by StarTeam Notification Agent are editing (and, therefore, creating revisions to) items under workflow control. If, for example, a third party changes the responsibility for an item to someone who is authorized to edit it, StarTeam Notification Agent assumes that the responsible person has already been notified.

Only Notification Agent Should Change Responsibility Field

StarTeam Notification Agent assumes that only StarTeam Notification Agent and the users set by StarTeam Notification Agent are editing (and, therefore, creating revisions to) items under workflow control. If a third party changes the responsibility for an item to someone who is authorized to edit it, StarTeam Notification Agent assumes that the responsible person has already been notified.

Out-of-Memory Errors from Java

When you start StarTeam Notification Agent from the Start menu, options from the notification.stjava file are used. This file is in the StarTeam Notification Agent installation folder (by default, C:\Program Files\Micro Focus\StarTeam Notification Agent).

The “options=” parameter in this file is now set to “-Xmx256m”, a Java option used to control memory usage. If you encounter out-of-memory errors, you may need to tweak this setting.

The documentation that Sun currently provides about this option is as follows:

-Xmxn

Specify the maximum size, in bytes, of the memory allocation pool. This value must a multiple of 1024 greater than 2MB. Append the letter k or K to indicate kilobytes, or m or M to indicate megabytes. The default value is 64MB. Examples:

-Xmx83886080
-Xmx81920k
-Xmx80m

The default content of the notification.stjava file is similar to the following:

[StJava]
class=com.starbase.starteam.workflow.NARuntime.NotificationAgentFrame
starteam=release_number
test=0
[Java VM]
name=java_version
classpath=installation_folder\agent.jar;%CLASSPATH%
librarypath=%LIBRARYPATH%;installation_folder
options=-Xmx256m

Back to top