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