IBM Rational ProjectConsole Service Release 2003.06.13 Release Notes


Version 2003.06.13, September 2004

File last updated 08/18/2004

Material ID/Part Number: GI11-5915-03


© Copyright IBM Corporation 2001, 2004. All Rights Reserved.

Any reproduction or distribution of this work is expressly prohibited without the prior written consent of IBM Corporation.

Legal Notices Information


Scope

Product changes described in this document and contained within this service release apply if you are upgrading from Rational ProjectConsole v2003.06.00.

These Service Release Notes include:

Read the ProjectConsole Release Notes for a full description of the release, including enhancements, all supported platforms, and known issues.

 

Contents

What's New in This Service Release

Hardware/Software Information

Getting Started
Installation Information
Licensing
Installation Issues

Product Documentation

Compatibility Issues
With Rational Products
With Third-Party Products
Menu Incompatibilities

Late Changes to Documentation
ProjectConsole Template Builder Comments in Word 2003

Defects and Changes
Known Issues
Defects fixed
Files changed

Contacting IBM Rational Software Support

What's New in This Service Release

These Release Notes are accurate at the time this product was prepared for release. The most recent Version of this file is available in the IBM Publications Center at http://www.ibm.com/shop/publications/order. Search for GI11-5915-03 to find the latest Version of these Release Notes in the IBM Publications Center. (To search for the IBM Publications Center, go to http://www.ibm.com and enter "IBM Publications Center" in the Search field.)

This service release includes the following changes:

For more information about ProjectConsole features updated since 2003.06.00, see the IBM ProjectConsole Release Notes.

Hardware/Software Information

This release has no additional hardware or software requirements or recommendations beyond those for Rational ProjectConsole Version 2003.06.00.

For more information on server and client requirements, see the Rational Suite Release Notes.

Getting Started

Review the information in this section before installing this service release.

Installation Information

Licensing

The following files from LEAD Technologies, Inc. are included in this release:

lfbmp13n.dll
lfcmp13n.dll
lflmb13n.dll
lfpng13n.dll
lfwmf13n.dll
ltdis13n.dll
ltefx13n.dll
ltfil13n.dll
ltimg13n.dll
ltkrn13n.dll
ltocx13n.ocx
lttwn13n.dll

These files, which are used for graphic representation, were also included in Version 2003.06.00 of ProjectConsole.

Installation Issues

For information about ProjectConsole installation on a server, see the section "Defects and Limitations in This Service Release" in the document IBM Rational Service Release 2003.06.13 Release Notes.

Product Documentation

A full description of the release, including enhancements, all supported platforms, and known issues, is available here.

Compatibility Issues

The information in the following subsections supercedes the compatibility statements in the Version 2003.06.00 Release Notes.

With Rational Products

ProjectConsole Template Builder Version 2003.06 can report on Rational products of the same Version, 2003.06. Template Builder is backwards compatible in the same way that any point product is. If an individual Rational product Version 2003.06 can read data from an earlier Version of that product, Template Builder can also read that data and report on it.

With Third-Party Products

To use ProjectConsole and its features in Netscape and Mozilla, all cookie types must be enabled. Otherwise, you will receive an authentication error.

When using Dashboard or Designer, you may be prompted to install a Java plug-in from Sun Microsystems. Follow the instructions to do this from the Sun Web site at http://www.sun.com/. Note: When instructed to create a soft link, the documentation may state that you should use the "ns610" directory for the soft link. For all supported Versions of Mozilla and Netscape, use the "ns610-gcc32" directory instead.

Microsoft Windows XP SP2 includes security measures that may affect IBM Rational products. See the IBM Rational Project Console Release Notes for more details.

In order to be able to launch either the Designer or Dashboard, cookies need to be enabled. For details, see the IBM Rational ProjectConsole Release Notes, section "Compatibility with Third-Party Products."

Menu Incompatibilities

This release contains no menu corruption or compatibility issues for ClearCase and Adobe Acrobat 5.0.5. Therefore, it is no longer necessary to use the commands on the ProjectConsole toolbar instead of the commands on the ProjectConsole menu.

Late Changes to Documentation

The behavior of comments in ProjectConsole Template Builder Version 2003.06.12 using Word 2003 is slightly different from Word 2002 and similar to Word 2000.

ProjectConsole Template Builder Comments in Word 2003

Like Word 2002, Word 2003 requires Markup to be turned ON to display Word comments (and ProjectConsole Template Builder commands). However, in this Version of Template Builder, the default Markup setting is ON and the color is white, which makes Markup invisible to the user. This does not affect comment functions for normal Word usage. Now that Markup is always set to ON in Template Builder, you can use the Word Show/Hide button to toggle the display of Template Builder commands. The placement of the cursor in relation to the marker is irrelevant in this Version (this is different from Word 2002).

Defects and Changes

Known Issues

For a list of issues for Rational ProjectConsole and its components for v2003.06.13, including ProjectConsole Template Builder identified in v2003.06.13 and earlier releases, see the ProjectConsole Release Notes.

Defects fixed

The following tables list the defects fixed for ProjectConsole and its components in this service release and all earlier 2003.06 Versions.

v2003.06.10

ProjectConsole was not updated in v2003.06.10.

v2003.06.12

Product

ID

Description

ProjectConsole Template Builder RATLC00369284/ No APAR You can add a DISPLAY command in any column of a non-Template Builder table (a table with no REPEAT command that you use for formatting purposes).
ProjectConsole Template Builder RATLC00369629/ No APAR In Word 2002, built-in heading styles no longer change to Normal style during save.
ProjectConsole Dashboard RATLC00369861/ No APAR In the ProjectConsole Dashboard, if you move your cursor over a bar or line displayed on a chart, the value for that data point is displayed as pop-up text. In ProjectConsole Version 2003.06.00, you could print a single data point displayed in this way, but you could not print the values for all of the data points on a chart.
 
In this release, ProjectConsole provides a check box that lets you print the values for all of the data points represented on a published chart.
 
To publish an individual chart so that the values for all data points on the chart are shown, do the following:

1.     Open the chart in the ProjectConsole Dashboard.

2.     In the right pane of the Dashboard, right-click the chart, and then click Publish on the shortcut menu.
 
The Publish As dialog box opens.

3.     In the File name box, type a name for the published file.

4.     In the Save as type list, select a format for the file.

5.     Select the Show chart value labels check box.

6.     Click OK.

To publish a metrics panel containing multiple displays so that all values for the data points on all charts in the panel are shown, do the following:

1.     Open the panel in the ProjectConsole Dashboard.

2.     On the toolbar, click View > Publish on Schedule.

3.     Specify the required information.

4.     Under Task Information, select the Show chart value labels check box.

5.     Click OK.

ProjectConsole Maintenance Tool RATLC00372018/ No APAR ProjectConsole now installs properly on operating systems where the code page is not currently supported (such as Hebrew). On these operating systems, a warning message is displayed in the ProjectConsole Maintenance Tool, indicating that the data warehouse supports the storage of ASCII data only.
ProjectConsole Maintenance Tool RATLC00372058/ No APAR You can now copy a data repository using the ProjectConsole Maintenance Tool if the source database is configured to use DB2.
ProjectConsole Administration RATLC00372090/ No APAR In addition to Internet Explorer, you can now use Netscape browsers to perform user and group administration on the ProjectConsole Web site.
ProjectConsole RATLC00372122/ No APAR The Refresh button, which is used to update the artifact report that is currently displayed, is now fully functional using all supported Versions of Netscape.
ProjectConsole Template Builder RATLC00372518/ No APAR In Word 2002, it is now possible to modify an existing REPEAT across a table and add a filter.
ProjectConsole Designer ProjectConsole  Administration RATLC00372854/ No APAR RATLC00372878/ No APAR RATLC00373011/ No APAR  RATLC00373013/ No APAR A number of double-byte character issues have been resolved in this service release.
ProjectConsole Template Builder RATLC00373091/ No APAR The amount of white space sometimes created by a recursive REPEAT has been reduced. You may have to modify templates that you previously adjusted to minimize that space.
ProjectConsole RATLC00374003/ No APAR In the last release, ProjectConsole Help files did not contain information on how to specify the artifact ID for Rational TestManager. Help now provides the format for entering TestManager artifact ID information.
ProjectConsole Maintenance Tool RATLC00374078/ No APAR ProjectConsole no longer needs to restart the Web server to reconnect to the security database.
 
In previous releases, when connecting to an existing data repository, or creating or copying a data repository, the ProjectConsole Maintenance Tool restarted the Rational Web Server so the ProjectConsole Web services could reconnect to the security database. This restart action caused all of the applications served by the Rational Web Platform to be restarted.

v2003.06.13

Product

ID

Description

ProjectConsole Tree Control RATLC00374308/ No APAR When installing the ProjectConsole collection agents and report server on a remote machine, all of the dependent Template Builder files are now properly installed.
ProjectConsole Tree Control RATLC00373339/ No APAR Previously, when an attempt was made to copy a portion of the project tree within itself, the project tree would become locked until ProjectConsole was restarted and the copy would never occur.

ProjectConsole will now trap an attempt to copy a portion of the project tree to within itself, and report the attempted action as an error. The Project tree remains unlocked and available after reporting the error.
ProjectConsole Licensing RATLC00374629/ No APAR When the ProjectConsole servers start up, there were times when multiple licenses were consumed. The ProjectConsole servers now consume a single license under the name "ProjectConsoleServer".
ProjectConsole Licensing RATLC00375067/ APAR IC38098 When checking out a license, we now use the username and IP address of the user. This enables users to utilize the flexlm rational.opt file to list groups of users and machines that are allowed to utilize a subset of the available licenses. Refer to the documentation on the Rational License Manager for information on using the rational.opt file.
ProjectConsole Maintenance Tool RATLC00375153/ No APAR You can now specify a different username and password for the schema repository and data warehouse when using a SQL Server database. Previously, you needed to use the same username and password for both the schema repository and data warehouse.
ProjectConsole Dashboard RATLC00375624/ No APAR When you create a gauge or an indicator and use a derived measure value for the threshold, the values are no longer swapped and are now displayed correctly.
 
ProjectConsole Miscellaneous RATLC00375636/ No APAR The security database connection is now configured so that it remains open as needed.
ProjectConsole Miscellaneous RATLC00375966/ No APAR In this release, the ProjectConsole components are no longer dependent on the Microsoft JVM. There should be no visible change to the user.
ProjectConsole Miscellaneous RATLC00376019/ No APAR

RATLC00724984/ No APAR

ClearQuest converted their ODBC drivers to a new set of DataDirect ODBC drivers. The ProjectConsole Maintenance Tool supports new parameters required to connect to a ClearQuest database using the new drivers.

To use an existing ProjectConsole repository, run the Rational ProjectConsole Maintenance tool, and select the "Connect to a ProjectConsole repository" option. After selecting the repository to connect to, verify that the "Data warehouse information" is correct. The screens for SQL Server and Oracle have changed. These changes could affect the accuracy of the data that is displayed after selecting the existing repository to connect to. The following changes have been made to the "Data warehouse information":

  1. SQL Server: There is a new text box called "Connect options". This is not a required field, but may be used to specify options for connecting to the SQL Server database.
  2. Oracle:
    • There is a new text box called "Database server". In the "Database server" text box, you must specify the name of your database server.
    • The "Name" text box used to contain the name of the SQLNet alias. This text box has been replaced with a text box named "SID". Enter the database SID in the "SID" text box.

These changes have also been made to the screens that display when migrating data from a previous Version of ProjectConsole.

Note: The help topics for the ProjectConsole Maintenance tool in this release do not reflect these changes.

For more information about this issue, refer to the IBM Rational ClearQuest documentation.

ProjectConsole Miscellaneous RATLC00376022/ No APAR Users will notice a change in the look of Project Console - A new IBM Banner and IBM Logo. This change reflects the Rational inclusion in the IBM family of software products. All of the buttons and features remain where they were and provide the same functionality.
ProjectConsole Tree Control RATLC00376044/ No APAR Previously, a user's "My Workspace" was corrupted when the user was removed and subsequently added again. This sequence of operations now function as expected with no corruption of "My Workspace" resulting.
ProjectConsole Tree Control RATLC00716034/ No APAR ProjectConsole now properly handles entries in the navigation tree that contain "&" characters in the name.
ProjectConsole Tree Control RATLC00716609/ APAR IC39589 Previously, entering quotation marks as part of a Link URL field would corrupt the Project Tree. The Link URL (and Node Label) can now contain the following previously prohibited characters as well as quotation marks:
  • Quotation character
  • Apostrophe character
  • Ampersand character
  • Left-angle character
  • Right-angle character
ProjectConsole Miscellaneous RATLC00720569/ No APAR Mozilla Version 1.6 is now a supported browser on the Linux platform (using JRE 1.3 or higher). Previously, it was not supported.
ProjectConsole RATLC00726672/ No APAR Prior to running the Dashboard or Designer applets, uninstall Java Plug-In version 1.3.1. ProjectConsole will detect that a Java plug-in is not installed and automatically install Java Plug-In version 1.4.1. Failure to install Java Plug-In version 1.4.1 may result in runtime exceptions when using the Dashboard and Designer applets. For example, if you click a chart in Dashboard and then click the Scheduled Tasks node in the Designer, these actions cause a NullPointerException when using Java Plug-In version 1.3.1.
ProjectConsole RATLC00006119/ No APAR Previously, user had to rerun portalserver after making changes to documentserver values (using portal administrator) before the changes take effect. This is no longer a problem.
Dashboard

Designer

RATLC00369672/ No APAR On UNIX/Linux systems, ProjectConsole now properly detects the existence of the Java Plug-in and redirects the user to a download page if it has not yet been installed.
ProjectConsole RATLC00372168/ No APAR In v2003.06.00 of RationalSuite, ProjectConsole did not support the collection of and reporting on measures from Rational XDE. This has been fixed.

 

Files changed

The following files, which are located in the ProjectConsole folder or one of its subfolders, have been added or changed since Version 2003.06.00.

tb_xmlgen.dll
templatebuilder2000.dll
templatebuilder2002.dll
templatebuilder2003.dll
collector.exe
collector.jar
collectorcmd.exe
collectorcmd.jar
collectorservice.exe
cqcom.dll
cqcombridge.dll
dashboardserver.exe
dashboardserver.jar
dashboardservice.exe
filesystemservice.dll
jniregistry.dll
pjssetup.bat
pjssetup.exe
pjssetup.jar
pjssetupauto.bat
pjssetupauto.exe
pjssetupauto.jar
publisher.jar
rdsiagent.exe
rdsiagent.jar
reportserver.exe
rosert.dll
rs.jar
sodaagent.exe
sodaagent.jar
sodaquery.dll
textagent.exe
textagent.jar
rosert.dll

analyzer.jar
designer.jar
pjcclientcheck.jar
about.html
detectdashboardplugin_ie.html
detectdashboardplugin_moz.html
detectdashboardplugin_ne.html
detectdesignerplugin_ie.html
detectdesignerplugin_moz.html
detectdesignerplugin_ne.html
login.html
login_invalid.html
support.html
unsuportedbrowser.html
about_bottom.gif
about_top.gif
banner_ibm_logo.gif
banner_pjc.gif
pjcpackage.js
admin_addtree.xsl
admin_edittree.xsl
banner.xsl
pjcaboutbox.xsl
filesystemservice.dll
pjc.properties
pxconfig.xml
siteconfigpxcomponent.xml
membershipui\xml\admin_leftnav.xsl.xml
membershipui\xml\groups_remove.xsl.xml
membershipui\xml\org_groups_edit.xsl.xml
dbctrs8.dll
dblgen8.dll
dblib8.dll
dbserv8.dll
dbsrv8.exe
dbstop.exe
dbtool8.dll
caching.jar
common.jar
javalicense.jar
logging.jar
memui.jar
messaging.jar
mgmtsvc.jar
pjcserver.jar
pxserver.jar
rsclient.jar
ssm.jar
wpf.jar
xalan.jar
xercesimpl.jar
xml-apis.jar

This Version of ProjectConsole Template Builder is implemented as a COM add-in instead of a menu add-in. Because of that change, the following .wll files become zero bytes and their functionality is replaced with corresponding .dll files:

Old File / 0 Bytes New File
TemplateBuilder.wll TemplateBuilder2000.dll
TemplateBuilderXP.wll TemplateBuilder2002.dll

TemplateBuilder2003.dll is a new file that adds support for Word 2003.

Contacting IBM Rational Software Support

The IBM software support Internet site provides you with self-help resources and electronic problem submission. The IBM Rational Software Support Home page can be found at http://www.ibm.com/software/rational/support/.

Voice Support is available to all current contract holders by dialing a telephone number in your country (where available). For specific country phone numbers, go to http://www.ibm.com/planetwide/.