setdbcodepage

Sets the value of the Rational® ClearQuest® data code page to a supported Windows® code page.

Applicability

Platform: Windows

Command type: installutil subcommand

Synopsis

installutil setdbcodepage
[–dbset dbset_name] [ -force ] [-allowconversion] [-verbose] codepage admin_user admin_password

Description

The installutil setdbcodepage command sets the value of the Rational ClearQuest data code page to a supported Windows code page.

Options and arguments

dbset_name
The name of the database set or connection that contains the database to be checked. If you omit this parameter, the dbset_name is the version 7.0 connection name 7.0.0.
-force
This is an optional parameter if you want to set the Rational ClearQuest data code page to a local character set value that is not supported. To ensure data integrity, do not use this option.
-verbose
This optional parameter lists the characters in a Rational ClearQuest database that is not stored correctly when they move from the Rational ClearQuest client to a vendor database.
For example, you might specify this and then the -allowconversion option when using Simplified Chinese (936) with Oracle databases.
-allowconversion

This optional parameter sets the Rational ClearQuest data code page to the specified value even if there are characters stored in your Rational ClearQuest database that cannot be stored correctly when they are moved from the Rational ClearQuest client to a vendor database.

Run the command with this option only after you have done the following:

  1. Run the command with the -verbose option to determine if your Rational ClearQuest database contains characters that are not stored correctly when they move to your vendor database.
  2. Evaluated the -verbose output to verify which unsupported characters are stored in your Rational ClearQuest schema repository or database. Storage of the characters displayed by the -verbose option is corrupted. If this is acceptable, then run the command using the -allowconversion option.
Attention: Using the option may cause data corruption.
codepage
The Windows code page number to which the Rational ClearQuest code page is to be set.
admin_user
The Rational ClearQuest login name of the administrative user. This user must have super user privileges.
admin_password
The Rational ClearQuest password for the administrative user. If there is no password, enter an empty set of double quotes.

Examples

See also

installutil lscodepage, codepageutil test_codepage, codepageutil analyze_tables, installutil setdbcodepagetonochecking


Feedback