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:
- 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.
- 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
- Set the Rational ClearQuest data
code page for the Connection3 database to the local character set value 1252.
This value is (Latin-1).
cquest–home–dir>installutil setdbcodepage
-dbset Connection3 1252 admin ““
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)
This
command does not guarantee that text already stored in this dbset is compatible
with this data code page setting. See test_codepage and analyze_tables for more information.