installutil 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 dbsetName] [-force] [-allowconversion] [-verbose] codePage adminUser adminPassword
Description
The installutil setdbcodepage subcommand sets the value of the Rational
ClearQuest data code page to a supported Windows code
page.
Important: This command does not guarantee that text that is stored in the
database set is compatible with the data code page setting.
Options and arguments
- dbsetName
- The name of the database set or connection that contains the database to set.
- -force
- Set the data code page to a local character set value even if
the database validation failed. Important: Using the -force option is highly discouraged.
- -allowconversion
Sets the data code page to the specified value, even if there are characters in your database that are not stored correctly when they are moved from the Rational ClearQuest client to the vendor database.
Important: Using the -allowconversion option might cause data corruption. Use this option only after you run the installutil setdbcodepage subcommand with the -verbose option to determine whether your database contains characters that are not stored correctly when they are moved to the vendor database.- -verbose
- Lists the characters in a Rational ClearQuest database that are not stored correctly when they move from the Rational ClearQuest client to a vendor database. The replacement characters are also displayed.
- codePage
- The Windows code page number to which to set the Rational ClearQuest data code.
- adminUser
- The login name of an administrative user. This user must have the Super User privilege.
- adminPassword
- The password for the adminUser user. If there is no password, enter an empty set of double quotation marks ("").
Example
- Set the Rational
ClearQuest data code page for the
mydbset database set to the local character set value 1252 (ANSI - Latin
I).
installutil setdbcodepage -dbset mydbset 1252 admin secret
Validating that database MASTR supports code page 1252 (ANSI - Latin I)...
Successfully validated all databases.
Successfully set the code page to: 1252 (ANSI - Latin I)