Rational QualityArchitect
Release Notes

 


Release 2002.05.00

Part Number: 800-023988-000

Copyright © 2001 Rational Software and its subsidiaries. All rights reserved.
October 2001


About These Release Notes

Trademarks and Copyrights

Scope - Product Definition

New and Changed Features

Additional Application Server Support

EJB Query Builder

Automatic Generation of Datapools and Lookup Tables

Rational QualityArchitect Options Dialog

COM Stub Generation from CoClasses

Late Changes to Documentation

Deploying Stubs Permanently to a WebLogic Server

For WebLogic 5.1

For WebLogic 6.1

COM Test Scripts Fail to Run from TestManager

Guidelines, Defects, and Restrictions

General

Rational QualityArchitect and Microsoft .NET

Java Database Verification Points

Rational QualityArchitect Console

Issues Debugging Scripts

Running Test Scripts from Rational TestManager

Upgrading Test Assets from Previous Releases

Problems with Microsoft Office 2000

Online Manual on Windows XP Systems

Submitting Defects form the Test Log Window

UCM on Windows NT with ClearCase 5.0

COM

Systems Running Windows 98

Limitations with COM Programmatic ID Strings

COM Unit Test Generation

COM Scenario Test Generation

COM Query Design Wizard

EJB (General)

Using Fully Qualified Class Names

Using the IBM JDBC Driver

Classpath Issues

Problems with Visual Café

Running RQA Java Test Scripts from TestManager

Working with Stub Code from Previous Releases

Problems with VisualAge for Java

Problems with Database Verification Points and Sun JVM 1.2.2

Problems with the EJB Query Design Wizard

Problems with the Rational Bank Account Sample Application

Problems with the Sun J2EE Reference Server v. 1.3

EJB Session Recorder

Connecting to Remote Application Servers with the Session Recorder

J2EE Dependency on ioserxx.dll

Problem with the isIdentical() Method Using the Sun J2EE Reference Server v.1.2.1

Additional Classpath Requirement for WebLogic 6.1

Problems with the EJB Session Recorder and VAJ

Problems with Verification Points on Windows NT Systems

Problems with Long Constant Values in Method Parameters

Contacting Rational Technical Support

 

About These Release Notes

Trademarks and Copyrights

Scope - Product Definition

New and Changed Features

Additional Application Server Support

EJB Query Builder

Automatic Generation of Datapools and Lookup Tables

Rational QualityArchitect Options Dialog

COM Stub Generation from CoClasses

Late Changes to Documentation

Deploying Stubs Permanently to a WebLogic Server

For WebLogic 5.1

For WebLogic 6.1

Guidelines, Defects, and Restrictions

Issues Debugging Scripts

Running Test Scripts from Rational TestManager

Problems with Microsoft Office 2000

Online Manual on Windows XP Systems

COM

Limitations with COM Programmatic ID Strings

COM Unit Test Generation

COM Scenario Test Generation

COM Query Design Wizard—Problems with Spaces in Table Names

Using the OLE DB Query Design Wizard and the IBM DB2 ODBC Driver

EJB (General)

Using Fully Qualified Class Names

Using the IBM JDBC Driver

Order of Jar Files on the Classpath

Stack Overflows in Visual Cafe

Problems with Database Verification Points on Windows NT 4 Machines

EJB Session Recorder

Connecting to Remote Application Servers

J2EE Dependency on ioserxx.dll

J2EE Problem with the isIdentical() Method

Additional Classpath Requirement for WebLogic 6.1

Contacting Rational Technical Support

 


 

About These Release Notes

These Release Notes provide information that is not available in the printed documentation or Help for Rational QualityArchitect (RQA).

Trademarks and Copyrights

A complete online trademark and copyright information page resides for all Rational products resides in the \doc subfolder of your installation folder. The file is called copyright.html, and its default location is C:\Program Files\Rational\doc.

Scope - Product Definition

Rational® QualityArchitect is a powerful collection of integrated tools for testing middleware components built with technologies such as Enterprise JavaBeans and COM.

QualityArchitect, in conjunction with Rational Rose, generates test scripts for components and interactions in your Rose model. Once generated, the test scripts can be edited and run right from your development environment or from Rational TestManager.

This release of QualityArchitect is designed specifically for testing the following component types:

·         Enterprise JavaBeans (EJB)

·         COM

New and Changed Features

Additional Application Server Support

With this release QualityArchitect now includes support for BEA WebLogic Server 6.x and IBM WebSphere 4.0.

EJB Query Builder

The EJB Query Builder now contains a graphical user interface for joining tables during the process of creating a SQL query. This feature was provided in the previous release of the COM Query Builder.

Automatic Generation of Datapools and Lookup Tables

After it generates a unit test script, QualityArchitect now auto-generates a datapool, using the parameters in the method-under-test for the column names. QualityArchitect also generates a lookup table automatically during the stub generation process. In both cases, it is up to the user to populate the datapool or lookup table with valid records.

 

Rational QualityArchitect Options Dialog

Both the Visual Basic and Java options tabs of the Rational QualityArchitect Options dialog now contain a text box for changing the location of generated test scripts. Prior to this release, you could only change this location in Rational TestManager.

COM Stub Generation from CoClasses

COM stubs are now generated off of classes stereotyped as coclasses from the COM Type Library. Prior to this release, COM stubs were generated off of classes stereotyped as interfaces.

Late Changes to Documentation

Deploying Stubs Permanently to a WebLogic Server

The procedure documented in this section of the Rational QualityArchitect User’s Guide is missing a step.

For WebLogic 5.1

Before restarting the WebLogic 5.1 application server (Step 14), you need to run the wlconfig.exe utility. This utility adds the required Rational JAR files to the application server’s classpath. To run the utility, type the following from the command line or create a batch file that contains the following text. Be sure to adapt the file locations to your particular installation.

c:\weblogic\bin\wlconfig.exe -Dweblogic.class.path=c:\weblogic\lib \weblogic510sp7.jar;c:\weblogic\license;
c:\weblogic\lib\weblogicaux.jar;c:\weblogic\mssqlserver4v70\classes;
c:\weblogic\myserver\serverclasses;c:\weblogic\classes;
"c:\program files\rational\rational test\rttssjava.jar";
"c:\program files\rational\rational test\QualityArchitect\rational_ct.jar";
"c:\program files \rational\rational test\tsea\rttseajava.jar"

For WebLogic 6.1

Before restarting the WebLogic 6.1 application server (Step 14), you need to edit one of two command files, depending on whether you are running the Default application server or the Example application server. The command files will be executed when you restart the server.

Default Server

Edit the C:\bea\wlserver6.1\config\mydomain\startWeblogic.cmd file as follows:

Set CLASSPATH=.;.\lib\weblogic_sp.jar;.\lib\weblogic.jar;"C:\Program Files\Rational\Rational Test\QualityArchitect\rational_ct.jar";"C:\Program Files\Rational\Rational Test\tsea\rttseajava.jar";"C:\Program Files\Rational\Rational Test\rttssjava.jar"

Example Server

Edit the C:\bea\wlserver6.1\config\examples\startExamplesServer.cmd file and change classpath as follows:

Set CLASSPATH=.;.\lib\weblogic_sp.jar;.\lib\weblogic.jar;
.\samples\eval\cloudscape\lib\cloudscape.jar;.\config\examples\serverclasses;"C:\Program Files\Rational\Rational Test\QualityArchitect\rational_ct.jar";"C:\Program Files\Rational\Rational Test\tsea\rttseajava.jar";"C:\Program Files\Rational\Rational Test\rttssjava.jar"

 

 

COM Test Scripts Fail to Run from TestManager

The error message described in this troubleshooting section is incorrect.

Symptom

A COM test script cannot be run from TestManager, and an error message such as the following is displayed:

 Compiling Test Scripts ...

 Error GetFile Timestamp()from ...

 .

 .

 .

 0 warning(s), 1 error(s)

 Fatal compiler error, run terminated

 

The correct message is

Compiling Test Scripts ...

Error compiling .rc file

0 warning(s), 1 error(s)

Fatal compiler error, run terminated

 

Guidelines, Defects, and Restrictions

General

RQARational QualityArchitect and Microsoft .NET

RationalQualityArchitect does not support the Microsoft .NET platform. RQA should not be used on a system that has VisualStudio.Net installed.Rational QualityArchitect does not support the Microsoft .NET platform on Windows XP. QualityArchitect should not be used on Windows XP systems that have Visual Studio.Net installed as there are known incompatibilities.

Java Database Verification Points

When the specified RQA (Rational QualityArchitect) test script location path contains any double byte characters, inserted static database verification points fail. This failure is because the double byte characters are corrupted, which renders the test script path invalid.

RQARational QualityArchitect Console

Closing the RQARational QualityArchitect Console sometimes results in an application error on certain Windows ’98 language systems.

Issues Debugging Scripts

If you stop test script execution before tms.EndTestServices (Visual Basic) or tms.endTestServices(Java) is called in the script, be sure to exit your IDE. Otherwise, logging will be turned off for future runs of QualityArchitect test scripts.

 

Running Test Scripts from Rational TestManager

If you run QualityArchitect  test scripts from TestManager, and those test scripts contain deployed stubs, invalid test logs will be producedstub messages are not written to the log. When using stubs, run test scripts directly from your IDE.

Upgrading Test Assets from Previous Releases

Be sure to use the Rational Administrator to upgrade the Test Datastore before you attempt to play back RQA (Rational QualityArchitect) test scripts. If you do attempt a playback before upgrade, you will get a Test Datastore login error, indicating that the datastore is not the correct version. After the login error, be sure to exit the playback IDE sometime between upgrade and a second attempt at playback.

To upgrade:

1.    Exit from the IDE.

2.    Start the Rational Administrator.

3.    Select a project.

4.    Right-click the project and click upgrade assets.

Problems with Microsoft Office 2000

There is a defect in Microsoft Office 2000 on Windows 2000 and Windows NT machines that sometimes causes a series of warnings to appear when generating unit or scenario tests as a non-administrative user. For example, you may see "Error 1706—No valid source could be found for product Microsoft Office 2000. The Windows installer cannot continue." Clicking OK produces two subsequent messages: "Fatal error during installation" and "Unable to run this command." 

This problem occurs because application shortcuts have not been registered correctly.  Microsoft has confirmed this problem in Microsoft Knowledge Base article Q253768. 

To workaround this problem, simply double-click on one or all of the Office icons (Access, Excel, Outlook, PowerPoint, Word) in the Programs menu.

Online Manual on Windows XP Systems

Warning messages appear when you first display the Rational QualityArchitect online manual on Windows XP systems. Click OK to view the online manual. In addition, full text search is not functional.

 

Submitting Defects form the Test Log Window

If after submitting a defect in the Test Log Window, you want to log in to a different datastore or project, or log in as a different user, TestManager may not display the login dialog after restart. In this case, you must either log off the operating system and log back in (if you are running on Windows NT or later), or bring up Task Manager and terminate the CQINTSRV11.EXE process. You can then log in to another datastore or project, or log in as a different user.

 

UCM on Windows NT with ClearCase 5.0

A possible problem has been identified on Windows NT 4.0 when ClearCase 5.0 is installed. After performing a UCM datastore operation from the Rational Administrator (such as create datastore, check-in all, or add/remove from source), we suggest you shut down the Rational Administrator before attempting another such operation.

COM

 

Systems Running Windows 98

If you are running Windows 98, you may experience intermittent system failures when exiting from Rational Rose. A system failure can occur after you insert Database Verification Points during Scenario Test Generation for COM.

Limitations with COM Programmatic ID Strings

COM Programmatic ID strings must be 39 characters or less. Since there is no check on this limitation in QualityArchitect, a .cls name combined with the Visual Basic Project name may exceed 39 characters. Visual Basic will not allow you to run if you do not trim down the length of the Programmatic ID string. The error will appear as follows:

"ProgrammaticID string too long '<Visual Basic project name>.<Rational QualityArchitect cls name>'.

The Programmatic ID must be 39 characters or less"

Limitations with COM Programmatic ID Strings

COM Programmatic ID strings must be 39 characters or less. Since there is no check on this limitation in QualityArchitect, a .cls name combined with the Visual Basic Project name may exceed 39 characters. Visual Basic will not allow you to run if you do not trim down the length of the Programmatic ID string.

The error will appear as follows:

"ProgrammaticID string too long '<Visual Basic project name>.
<Rational QualityArchitect cls name>'.

The Programmatic ID must be 39 characters or less"

 

 

To workaround this problem, rename the Visual Basic project such that the combined length of the project name and the class name is less than 39 characters.

COM Unit Test Generation

QualityArchitect Unit tests for COM components create an instance of the component under test in Visual Basic by invoking the CreateObject method and providing it with the ProgID of the component under test.  The QualityArchitect Unit Test generator determines the ProgID to use in this call by reading the UUID from the model and looking it up in the registry.  If that UUID is found in the registry, the corresponding ProgID from the registry is used.

If the UUID cannot be found in the registry (because the component has not yet been created and registered or has had its UUID changed by a Visual Basic project which does not specify Binary Compatibility), then QualityArchitect will build a ProgID using the convention: Libraryname.CoClassname.  If you do not wish to follow this convention, then you must make sure your component is registered, and that the component's UUID in the model is in sync with the actual component's UUID.

COM Scenario Test Generation

·         When scenario tests are generated for COM applications, you may receive the following warning from Visual Basic when opening the script:

File not found: '<ScriptName>.RES’

This is a problem only if you want to execute the test under TestManager. If you are not interested in TestManager playback, click OK and the project will load in Visual Basic.

This problem can be avoided by following the guidelines below:

·         When prompted to "Choose a directory that will be the data path for the script source named "RQA VB Scripts", be sure to choose a directory that does not contain spaces in its path. 

·         Make certain that the name of the scenario diagram does not contain any spaces.

·         There is a known problem on Windows NT 4.0 systems with Rose freezing during scenario test generation when you insert VPs and click Yes to edit the datapool. This problem occurs when a large number of Rose add-ins are enabled. The workaround is to go to Add-Ins > Add-In Manager and deselect any add-ins that you do not use.

File not found: '<ScriptName>.RES’

This is a problem only if you want to execute the test under TestManager. If you are not interested in TestManager playback, click OK and the project will load in Visual Basic.

This problem can be avoided by following the guidelines below:

ˇWhen prompted to "Choose a directory that will be the data path for the script source named "RQA VB Scripts", be sure to choose a directory that does not contain spaces in its path. 

ˇMake certain that the name of the scenario diagram does not contain any spaces.

COM Query Design Wizard

·         There is a known issue when connecting to a SQL Database with a table name containing a blank space. The following error appears:

Could not find stored procedure ‘dbo.Order.Details.’

An error has occurred whilst trying to access this Table/Query!

Please rectify the error condition and try again.

The workaround is to turn off the "Show Owner" checkbox on the Add Tables dialog.

—Problems with Spaces in Table Names

There is a known issue when connecting to a SQL Database with a table name containing a blank space. The following error appears:

Could not find stored procedure ‘dbo.Order.Details.’

dbo.Order.Details

An error has occurred whilst trying to access this Table/Query!

 


Please rectify the error condition and try again.

 

The workaround is to turn off the "Show Owner" checkbox on the Add Tables dialog.

 

·         Because of compatibility problems with the OLE DB Query Design Wizard and the IBM DB2 ODBC Driver, you will need to enter SQL statements manually when using this combination.

The following error appears when you attempt to use the Query Design wizard:

[IBM][CLI Driver]SQL0104N An unexpected token "END-OF-STATEMENT" was found following "<TABLE OWNER>.<YOUR TABLE NAME>". Expected tokens may include "JOIN <joined_table".

SQLSTATE=426

Please contact IBM Technical Support for DB2 ODBC Driver resolution."

 

·         When you try to connect to an Oracle database with the COM Query Design Wizard, a message such as the following will appear:

'[Microsoft][ODBC driver for Oracle][Oracle]ORA-00900: invalid SQL statement'

The workaround is to manually enter the SQL statement.

Using the OLE DB Query Design Wizard and the IBM DB2 ODBC Driver

Because of compatibility problems with the OLE DB Query Design Wizard and the IBM DB2 ODBC Driver, you will need to enter SQL statements manually when using this combination.

The following error appears when you attempt to use the Query Design wizard:

[IBM][CLI Driver]SQL0104N An unexpected token "END-OF-STATEMENT" was found following "<TABLE OWNER>.<YOUR TABLE NAME>". Expected tokens may include "JOIN <joined_table".

SQLSTATE=426

 

·         Please contact IBM Technical Support for DB2 ODBC Driver resolution."There is a formatting issue when using a date in the form 'xx/xx/xxxx' as a condition in the Where clause. The COM Query Wizard places  # signs around the date. This causes an error in execution of the SQL statement in a datasource other than an Access database. 

Example:

Where [Employee].[HireDate] = #04/01/1992#

The workaround is to replace the # signs with single quotes if using a datasource other than Access.

Example:

Where [Employee].[HireDate] = '04/01/1992'

 

·         There are known font issues when using COM scenario tests with verification points and connecting to a database with Japanese characters.

·         Table and column selection dialogs with Japanese characters do not display correctly in the COM Query Design Wizard.

·         When running a VB script with the "User Acknowledge Baseline" Advanced Option, the User Acknowledgement dialog that pops up at runtime does not display Japanese characters correctly.

Although Japanese characters are not displayed correctly in the above circumstances, the verification point is captured successfully; the test will function properly; and the test result can be viewed correctly in the Log window.

EJB (General)

Using Fully Qualified Class Names

When using QualityArchitect to generate tests or stubs, make sure that fully qualified class names are used for parameter types and return types. For example, use java.math.BigDecimal and NOT just BigDecimal. Failure to use fully qualified class names will result in code that will not compile without adding additional import statements.

Using the IBM JDBC Driver

If you connect to DB2 via IBM 's JDBC Driver, you need to be aware of:

1.    The character set or code page used by the DB2 database

2.    The character set used by client applications

The character code page on the client and the target DB2 server must be compatible, that is, the DB2 server must minimally be able to convert the client code page into the DB2's internal code page. If this fails, the DB2 server will throw an "incompatible code page error message."

Example: If you attempt to configure a DB2 ODBC data source to be used by IBM's COM.ibm.db2.jdbc.app.DB2Driver on a Korean NT4.0 machine with the target server being on a US English DB2 server, you'll get an error message relating to incompatible code page.

In this case, you must consult the IBM documentation or IBM Tech Support on resolving this issue.

Classpath Issues

·         If a J2EE JDK is installed on a pre-J2EE application server, the pre-J2EE jar files must precede the J2EE jar files on the classpath. For example, weblogicaux.jar should precede the standard JDK 1.2.x jar files if the WebLogic version is pre-J2EE (i.e. 4.5x).

·         When you run an RQA (Rational QualityArchitect) Java test script that connects to the Sun's J2EE Reference Server v.1.2.1 Server, you must make sure that the J2EE.jar file located in %J2EE_HOME%/lib/j2ee.jar is set to be the first entry picked up first in the user your classpath variable or in your IDE.

If not, you might get a CORBA exception at runtime with a container method such as EJBRemote.getHandle(). In the Log View window, the error message logged would be:

Failure Description:

CORBA MARSHAL 0 No; nested exception is: \torg.omg.CORBA.MARSHAL: Unable to read value from underlying bridge : minor code: 0 completed: No

Message Text:      Exception: java.rmi.MarshalException

·         If you perform a network installation of Rational Software, all JAR files, EXEs, and DLLs will remain on the server. The client classpath JAR entries must point to the files on the server.

Problems with Visual CafeCafé

·         If you receive stack overflow errors in Visual Cafe when building generated test scripts:

1.    Delete all Visual Cafe non-project files. This includes all files with the following extensions: .cdb, .ve2, .vpj.  Do not delete files with the extension .vep.

2.    Rebuild your Visual Cafe project.

 

 

·         Problems occur when you use Visual Cafe v.4.1 with the default JVMs, and you try to execute a generated test script or the EJB Session Recorder. When you try to execute a test script, you will receive the following error:

"Unable to open the project".

 

When you try to execute the EJB Session Recorder, you will receive the following  error:

 

"Unable to determine the Rational QualityArchitect installation directory".

 

Each of these errors is caused by the same deficiency in the default JVMs used in Visual Cafe v.4.1. These default JVMs include custom debug wrappers that enable code debugging within the IDE.  These debug wrappers encode Java strings using the UTF-8 format. The JNI code that Rational uses returns strings in a UNICODE format.  Problems occur when these strings are encoded using UTF-8. 

 

Workarounds:

 

 

·         Upgrade to Visual Cafe v.4.5.

 

·         Change the JVM in the IDE from one of the default JVMs to a Sun JVM. You can do this by choosing Tools > Environment Options from the main menu and then clicking on the Virtual Machines tab and entering your custom JVM information. If you find that your version of Visual Cafe 4.1 does not allow you to select your own JVM, you must upgrade to Visual Cafe v.4.5.

If a stack overflow occurs in Visual Cafe when you attempt to build a project that contains generated test scripts:

·If you use Visual Café 4.5 with the JDK1.30_01 setting to compile an RQA Java script created from the ratlbankacct.mdl model, the compiler may fail to compile the .java files inside the ratlbankacct51.jar or ratlbankacct61.jar files.

The workaround is to unzip the ratlbankacct51.jar or ratlbankacct61.jar into the same directory where the script is located. This is the location of the RQA Java Script Datapath, as specified in the Java tab of the Rational QualityArchitect Console.

Running RQA Java Test Scripts from TestManager

If you are running an RQA (Rational QualityArchitect) Java test script from TestManager, and that script connects to an application server with JRE 1.2.2, you should be aware that JDK 1.2.2 does not ship with the JNDI classes needed by the test script. As a result, you need to provide these classes. Typically, you just include in your classpath Sun's j2ee.jar file from Sun's J2SDKEE1.2.1 or 1.3.x.

Recompiling Working with Stub Code from Previous Releases

EJB stub implementation classes now use Throwable in Try/Catch blocks instead of Exception. Throwable is preferred over Exception because all errors will be caught. As a result, users must regenerate any stub code generated with previous releases of Rational QualityArchitect.EJB stub implementation classes now use the java.lang.Throwable class in try/catch blocks instead of the java.lang.Exception class. The java.lang.Throwable class is preferred over the java.lang.Exception class because all errors will be caught. As a result, users must regenerate any stub code generated with previous releases of Rational QualityArchitect.

Problems with VisualAge for Java on Japanese Windows 2000 Machines

QualityArchitect tests that reference Japanese-language datapool values cannot be executed from VisualAge for Java on Japanese Windows2000 operating systems.

Problems with Database Verification Points and Sun JVM 1.2.2

When you try to execute test scripts using the Sun JVM v.1.2.2, and the test scripts contain a Database VP, the Java Virtual Machine will crash. It is recommended that you execute your test scripts using Sun JVM v.1.3 and above. This problem does not occur when you use the IBM JVM,v.1.2.

 

Problems with the EJB Query Design Wizard

When working with the EJB Query Design Wizard, messages such as the following may appear when you select tables with different owners or you select tables that are not public:

"The SQL execution failed for the specified SQL text.”

The workaround is to manually add the table’s owner to the SQL statement.

Problems with the Rational Bank Account Sample Application

When you import the Rational Bank Account Sample Application repository file (RatlBankAcct.dat) into VAJ and choose which project to load, four exact versions of the project are displayed in the list. Be sure to pick the first project in the list.

Problems with the Sun J2EE Reference Server v. 1.3

This release of Rational QualityArchitect does not support the Sun J2EE Reference Server v.1.3.  However, the Sun J2EE Reference Server v.1.2.1 is fully supported.  It may be downloaded using the following link:

 

http://java.sun.com/j2ee/sdk_1.2.1

EJB Session Recorder

 

Connecting to Remote Application Servers with the Session Recorder

When trying to connect to a remote application server, the required JNDI initial context classes for the application server must exist in the Additional Classpath Options field. This field can be accessed from the Java Options tab of the Rational QualityArchitect Options dialog box. If the application server classes are not found, the EJB Session Recorder will not be able to connect to the remote server.

Also, in order to connect to a remote version of WebSphere 3.5 from within VisualAge for Java 3.5, you need to apply VAJ 3.5 Patch 2. This patch can be downloaded from the IBM Website.

J2EE Dependency on ioserxx.dll

In this release, the EJB Session Recorder requires that the J2EE_HOME system variable be defined with the path to a version of the J2EE. This path should be the main installation path for the J2EE, for example J2EE_HOME=C:\j2sdkee1.2.1.)

Since the J2EE.jar file is dependent on ioserxx.dll, which is located in the nativeLib directory for the installed J2EE, you must include the path to the nativeLib directory in the system path for the version of the J2EE that you have specified in the J2EE_HOME system variable, for example, PATH=%PATH%;C:\j2sdkee1.2.1\nativelib.

If the J2EE cannot find ioserxx.dll, the Session Recorder will fail to connect to any deployed EJBs.

J2EE Problem with the isIdentical() MethodProblem with the isIdentical() Method Using the Sun J2EE Reference Server v.1.2.1

If the J2EE cannot find ioserxx.dl, the Session Recorder will fail to connect to any deployed EJBs. When you are connected to the Sun J2EE Reference server and you invoke the isIdentical() method on a Session Bean, the method always returns true. A defect has been submitted to the Java bug database. There is currently no workaround for this problem.

Additional Classpath Requirement for WebLogic 6.1

When using the EJB Session Recorder, there are conflicts between the WebLogic 6.1 JAR file, weblogic.jar, and the Xerces XML JAR file, xerces.jar. Both JAR files contain some packages with the same names. However, they do not have the same classes. As a result, if the WebLogic 6.1 JAR file is listed in the classpath before the Xerces JAR file, missing class and method errors are thrown by the EJB Session Recorder when you try to generate a test script.

You must make sure you insert the WebLogic 6.1 JAR file in the classpath after you insert the Xerces JAR file in order to successfully generate Java test scripts from the EJB Session Recorder.

Problems with the EJB Session Recorder and VAJ

Test script generation from the EJB Session Recorder does not always work successfully when run from within VAJ 3.5 or VAJ 4.0.  If you try to generate a test script from the EJB Session Recorder and cannot find the test script file, you can try to generate the script again using the XML file that was created.  Launch the EJB Session Recorder from the Rational QualityArchitect Console.  When the EJB Session Recorder window opens, choose Tools > Generate Test Script from the main menu.  Browse to the location of your test XML file and then enter the test script information. Your test script file should then be successfully generated.

Problems with Verification Points on Windows NT Systems

A problem was discovered in the version of the JVM that ships with QualityArchitect that causes the Scenario Test generator to freeze after inserting an indefinite number of Java verification points.

To workaround this problem, you must use version 1.3.1 of the JVM. You can download the 1.3.1 version from the following link:

http://java.sun.com/j2se/1.3/jre

After you download and install the JVM, you must modify the current JVM path for the Scenario Test generator in the System Registry. The JVM path is contained under the following registry key:

HKEY_LOCAL_MACHINE/SOFTWARE/Rational Software/Rose/AddIns/QualityArchitect/DefaultProperties/InteractionDgrm/Testability/default/JVMHome

The new JVM path that you enter must be the directory that contains the classic version of the JVM.dll file. If you installed the full JDK version 1.3.1, the JVM.dll file will be located in the <JDK Install Directory>\jre\bin\classic\ folder. If you installed just the JRE version 1.3.1, the JVM.dll will be located in the <JRE Install Directory>\bin\classic\ folder.

After modifying the JVM path in the registry, make sure you restart Rose to apply the new settings.

Problems with Long Constant Values in Method Parameters

If you use the EJB Session Recorder to record an EJB test script, and you input a constant long value as input to a method argument in the Parameter panel, without specifying a parameter name for the input value, the generated script will not compile and operate correctly.

For example, if you record an invocation of the following method:

getBalance(long acctID,String acctType)

The result in the generated test script will be something like the following:

getBalance(988724556667,"Checking")

In this case, the constant value 988724556667 will not be converted correctly to type long. Depending on the IDE and compiler, you may get a compile error or an application server error.

The workaround is to edit the generated source code by adding an L to the end of the constant value, for example:

GetBalance (988724556667L,"Checking")

 


 

Contacting Rational Technical Support


If you have questions about installing, using, or maintaining this product, contact Rational Technical Support as follows:

 

Your Location

Telephone

Facsimile

E-mail

North America

(800) 433-5444
(toll free)

(408) 863-4000
Cupertino, CA

(781) 676-2460
Lexington, MA

support@rational.com

Europe, Middle East, Africa

+31 (0) 20-4546-200
Netherlands

+31 (0) 20-4545-201
Netherlands

support@europe.rational.com

Asia Pacific

+61-2-9419-0111
Australia

+61-2-9419-0123
Australia

support@apac.rational.com

 

Note:  When you contact Rational Technical Support, please be prepared to supply the following information:

·         Your name, telephone number, and company name

·         Your computer’s make and model

·         Your operating system and version number

·         Product release number and serial number

·         Your case ID number (if you are following up on a previously-reported problem)