Client version checking

Not all methods are available to older client applications if the methods became available in a later version. Version information can help provide information for determining what methods are available for all clients you may be supporting. The individual method sections of this Reference documentation include notes for what version a given Perl or COM API method became available.

Beginning in version 7.0, the version numbering convention for IBM® Rational® products follows the standard IBM VRMF (Version, Release, Maintenance, Fix Pack) versioning model. The versioning model in releases earlier than 7.0 was year, major version, minor version, build, individual product release number (for example, 2003.6.15.734.0). This change may impact existing Rational ClearQuest® API code that checks or compares version numbers (that can be used to prevent older or specific client versions from making changes to records). For example, existing code that checks version numbers as string values using a Perl le (less than or equal) or ge (greater than or equal) comparison operator may not work as expected for a comparison between a newer version number (such as 7.0.0.0) and an older version number (such as 2002.05.00).

The following table lists product version and feature level numbers returned by the Rational ClearQuest API methods:

for Perl: GetProductVersion method of the ProductInfo object
for VBScript: GetProductVersion method of the Session object
for Perl and VBScript: GetMinCompatibleFeatureLevel and GetMaxCompatibleFeatureLevel methods of the Session object

Rational ClearQuest product version	Compatible feature level
2002.05.00	Min=3 , Max=5
2003.06.00	Min=3 , Max=5
2003.06.01	Min=3 , Max=5
2003.06.12	Min=3 , Max=5
2003.06.13	Min=3 , Max=5
2003.06.14	Min=3 , Max=5
2003.06.15	Min=3 , Max=5
7.0.0	Min=5 , Max=5
7.0.1	Min=5 , Max=6
7.1	Min-5 , Max=7

Note: You can use the GetDatabaseFeatureLevel method of the Database object to get the feature level in use by a database. The value must be within the range of the MinCompatibleFeatureLevel and MaxCompatibleFeatureLevel for the client to work with the database.

The following table lists API version information returned by the Rational ClearQuest API methods for each product version:

for Perl: GetObjectModelVersionMajor and GetObjectModelVersionMinor methods of the Session object
for VBScript: GetClearQuestAPIVersionMajor and GetClearQuestAPIVersionMinor methods of the Session object
Note: These VBScript methods were new in version 7.0.0.

Rational ClearQuest product version	Object model version (Perl)	ClearQuest API version (VBScript)
2002.05.00	Major=1, Minor=1
2003.06.00	Major=1, Minor=2
2003.06.01	Major=1, Minor=2
2003.06.12	Major=1, Minor=2
2003.06.13	Major=1, Minor=3
2003.06.14	Major=1, Minor=4
2003.06.15	Major=1, Minor=5
7.0.0	Major=1, Minor=6	Major=1, Minor=1
7.0.1	Major=1, Minor=7	Major=1, Minor=2
7.1	Major=1, Minor=8	Major=1, Minor=3