Rocket UniVerse

1 Rocket UniVerseNLS GuideVersion 2013 UNV-112-NLS-12 NoticesEditionPublication date: November 2013 Book number: UNV-112-NLS-1 Product version: Rocket UniVerse Rocket Software, Inc. or its affiliates 1985-2014. All Rights Reserved. TrademarksRocket is a registered trademark of Rocket Software, Inc. For a list of Rocket registered trademarks go to: All other products or services mentioned in this document may be covered by the trademarks, service marks, or product names of their respective information might contain examples of data and reports. The examples include the names of individuals, companies, brands, and products. All of these names are fictitious and any similarity to the names and addresses used by an actual business enterprise is entirely agreementThis software and the associated documentation are proprietary and confidential to Rocket Software, Inc., are furnished under license, and may be used and copied only in accordance with the terms of such : This product may contain encryption technology.

2 Many countries prohibit or restrict the use, import, or export of encryption technologies, and current use, import, and export regulations should be followed when exporting this informationWebsite: Software, Inc. Headquarters77 4th Avenue, Suite 100 Waltham, MA 02451-1468 USATel: +1 781 577 4321 Fax: +1 617 630 7100 3 Contacting Global Technical SupportIf you have current support and maintenance agreements with Rocket Software, you can access the Rocket Customer Portal to report and track a problem, to submit an enhancement request or question, or to find answers in the U2 Knowledgebase. The Rocket Customer Portal is the primary method of obtaining log in to the Rocket Customer Portal, go you do not already have a Rocket Customer Portal account, you can request one by clicking Need an account? on the Rocket Customer Portal login , you can contact Global Technical Support by email or by telephone:Email: America+1 800 729 3553 United Kingdom/France+44 (0) 800 773 771 or +44 (0) 20 8867 3691 Europe/Africa+44 (0) 20 8867 3692 Australia+1 800 707 703 or +61 (0) 29412 5450 New Zealand+0800 505 515 Table of ContentsC:\Users\awaite\Documents\U2 Doc\ UniVerse \ \Source\nls\ ( )March 25, 2014 8:37 amTa b l e o f Contents Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Chapter 1 Chapter 1: What is NLS?

3 NLS mode ..1-3 How NLS mode works..1-4 Internal character set ..1-4 Mapping ..1-5 Enabling NLS mode ..1-5 What you get with NLS ..1-6 Maps ..1-6 Locales ..1-6 Chapter 2 Chapter 2: Getting startedInstalling NLS ..2-3 Removing NLS ..2-4 NLS shared memory segments on UNIX systems ..2-4 Making a plan ..2-5 Setting configurable parameters ..2-6 Editing the uvconfig file ..2-8 Setting default maps and locales ..2-10 Setting locales ..2-13 Associating maps with devices ..2-14 Mapping in the spool queue ..2-15 Setting file maps ..2-16 Setting terminal maps ..2-17 Retrieving terminal settings ..2-18 Setting maps tapes and other devices ..2-19 Updating accounts ..2-20 Configuring NLS for client programs ..2-21 Maps for client programs ..2-21 Locales for client programs ..2-23 Configuration checklist.

4 2-25 Table of Contents 5 Chapter 3 Chapter 3: MapsHow maps work ..3-3 Main maps and input maps ..3-3 Base maps ..3-4 Creating a map description ..3-8 Example of a map description record .. 3-10 Creating a map table .. 3-10 Example of a map table record .. 3-12 Multibyte NLS maps and system delimiters .. 3-14 Handling extra characters .. 3-16 Defining new characters .. 3-16 Maps and files .. 3-17 Assigning maps to new files .. 3-17 Modifying file maps .. 3-17 Chapter 4 Chapter 4: LocalesHow locales work ..4-3 Creating conventions ..4-6 Creating new locales ..4-7 Naming locales ..4-7 Format of convention records ..4-8 Time records ..4-8 Numeric records .. 4-14 Monetary records .. 4-16 Ctype records .. 4-21 Collate records .. 4-24 Collating.

5 4-28 How UniVerse collates .. 4-29 Example of accented collation .. 4-30 Example of cased collation .. 4-30 Shared weights and blocks .. 4-31 Contractions and expansions .. 4-31 Editing weight tables .. 4-31 Calculating the overall weight.. 4-33 Using locales .. 4-35 Retrieving locale settings .. 4-35 Saving and restoring locales .. 4-35 Listing current locales .. 4-36 Changing current locales .. 4-366 UniVerse NLS GuideChapter 5 Chapter 5: NLS in UniVerse BASIC programsHow UniVerse BASIC is affected ..5-4 Using the Include file ..5-4 String length ..5-5 Length of record IDs ..5-6 Display length in BASIC ..5-7 Finding the display length of a string ..5-7 Formatting a string in display positions ..5-8 Folding strings using display positions.

6 5-8 Inputting using display length with INPUTDP ..5-8 Block size always in bytes ..5-8 The REMOVE pointer and multibyte character sets ..5-9 Maps in UniVerse BASIC ..5-10 Determining a file s map name ..5-10 Maps for source files ..5-11 Maps and devices ..5-12 Maps for auxiliary devices ..5-12@ Function codes for terminal and auxiliary maps ..5-12 Printing previously mapped data with UPRINT ..5-13 Finding the map associated with a print channel ..5-13 Maps for UNIX pipes ..5-13 Unmappable characters ..5-15 Unmappable characters and WRITE statements ..5-15 Unmappable characters and READ statements ..5-16 Multinational characters in UniVerse BASIC ..5-18 Editing multinational characters ..5-18 Generating characters in external format ..5-20 Generating characters in internal format..5-21 Internal and external string conversion.

7 5-21 Displaying records by character value ..5-24 Exchanging character values ..5-25 Case inversion and deadkey characters ..5-26 BASIC and locales ..5-27 Retrieving locale settings ..5-27 Saving and restoring locales ..5-27 Changing the current locale ..5-27 Chapter 6 Chapter 6: NLS in client programsClient programs ..6-4 Maps ..6-4 Table of Contents 7 Locales ..6-5 System delimiters and the null value ..6-5 UniObjects ..6-6 UniObjects for Java and UniObjects for .NET ..6-7 InterCall functions ..6-8 UCI programs ..6-9 Connecting to the server..6-9 Requesting an SQLC onnect ..6-9 Setting the map and locale .. 6-10 Values in the UCI configuration file .. 6-10 Interpreting the map name .. 6-11 Interpreting the locale name .. 6-11 Using SQLGetInfo .. 6-11 BCI programs .. 6-12 Connecting to the server.

8 6-12 Requesting an SQLC onnect .. 6-12 Setting the locale .. 6-13 Interpreting the locale name .. 6-14 Using SQLGetInfo .. 6-14 GCI subroutines .. 6-15 Specifying maps for GCI subroutines .. 6-15 Data types for multibyte characters .. 6-16 Chapter 7 Chapter 7: NLS administration menusUnicode menu ..7-3 Appendix AAppendix A: The NLS DatabaseAppendix BAppendix B: National convention hooksGeneral hook mechanism ..B-2 Support from UniVerse ..B-5 Memory management ..B-6 Using hooks in UniVerse ..B-7 Create a GCI definition for the initialization routine ..B-7 Compile the hook library ..B-8 Build the hook library ..B-8 Test the hooks ..B-9 Install the hook library ..B-9 NLS hook interface definitions .. B-10 Hook functions .. B-118 UniVerse NLS GuideAppendix CAppendix C: NLS quick referenceUniVerse commands.

9 C-2 UniVerse BASIC statements and functions ..C-4 Map tables ..C-6 UniVerse locales..C-8 unicode blocks ..C-10 Glossary1 ChapterC:\Users\awaite\Documents\U2 Doc\ UniVerse \ \Source\nls\ 25, 2014 8:37 am Administering UniData on Windows NT or Windows 2000 1 Administering UniData on Windows NT or Windows 20000 Chapter 1: What is NLS?NLS mode ..1-3 How NLS mode works ..1-4 Internal character set ..1-4 Mapping ..1-5 Enabling NLS mode ..1-5 What you get with NLS ..1-6 Maps ..1-6 Locales ..1-6 1-2C:\Users\awaite\Documents\U2 Doc\ UniVerse \ \Source\nls\Ch1 This chapter gives an overview of what NLS (National Language Support) is, why you need it, how it works, and what you will find when you install : This manual uses some terms that may be new to you. When a new term is introduced, it is printed in italic.

10 This means you can find an entry for the term in the UniVerse NLS GuideC:\Users\awaite\Documents\U2 Doc\ UniVerse \ \Source\nls\Ch13/25/14 NLS modeUniVerse has a special mode that offers National Language Support (NLS). With NLS mode enabled, you can use UniVerse in various languages and countries. You can do the following: Input data in many character sets (dependent on your local keyboard) Retrieve data and format it using your own conventions or those of another country Output data to a screen or printer using the character sets and display conventions of different countries Write programs that run in different languages and countries without source changes or recompilation 1-4C:\Users\awaite\Documents\U2 Doc\ UniVerse \ \Source\nls\Ch1 How NLS mode worksNLS mode works by using two types of character set: The NLS internal character set External character sets that cover the world s different languagesIn NLS mode, UniVerse maps between the two character sets when you input data to or output data from a character setIn NLS mode, UniVerse stores data using a single, large, internal character set that can represent at least 64,000 characters.