Configuration requirements
- Last Updated: February 11, 2026
- 2 minute read
- OpenEdge
- Version 13.0
- Documentation
Configuration requirements
In order to use Unicode in the OpenEdge DataServer for MS SQL Server, you must use Microsoft SQL Server 2005 or later. All MS SQL server drivers, including the DataDirect Connect ODBC driver for MS SQL Server, Version 5.1 or later, support Unicode. Additionally, you must perform the following prerequisite tasks:
-
Prepare your Unicode Schema Holder — If you create a new OpenEdge application to be Unicode-enabled for migration to an MS SQL DataServer, ensure that you create the database from a Unicode source. A copy of the empty OpenEdge
UTF-8database can be obtained from$DLC/prolang/utf/empty. If you use the Create DataServer Schema MS SQL DataServer utility to create a DataServer schema and you plan to set the schema holder's code page toUTF-8, the schema holder must also be derived from a copy of the emptyUTF-8database located at$DLC/prolang/utf/empty.Note: The migration process derives a schema holder this way automatically if you set the code page of your migration toUTF-8.The following command creates an empty OpenEdge database named "empty" that can be used to describe a Unicode-enabled foreign data source:
Prodb OpenEdge_utf-8_schema_holder $DLC/prolang/utf/emptyNote: The best way to ensure that the database path is correct for utilities that create a Unicode-enabled database is to set the$DLCDBenvironment variable to$DLC/prolang/utf. This ensures that databases will be constructed with Unicode enablement. If you do not set$DLCDB, you will need to reference the$DLC/prolang/utfdirectory explicitly whenever you want to create a Unicode-enabled database. - Use appropriate startup parameters — To process Unicode data in your client
application, set your
cpinternalclient code page toutf-8. If you are executing file I/O against your Unicode data, set your client'scpstreamcode page toutf-8. You also may consider several other available client code page settings for Unicode. For more information, see OpenEdge Development: Internationalizing Applications. -
Prepare OpenEdge databases for Unicode — Your OpenEdge database does
not need to be Unicode-enabled in order to be migrated to an MS SQL DataServer. The
migration process will convert data from any ANSI code page to Unicode as part of the
migration if you chose to move data during a migration and have specified a Unicode
destination. If you have existing data in an OpenEdge database that you wish to convert to
Unicode prior to migration, you can convert your non-Unicode data using one of two
conversion utilities:
- Data Administration dump and load utility
PROUTIL CONVCHARcharacter conversion utility
For more information on these utilities, see OpenEdge Development: Internationalizing Applications.