Version 2 Release 3 z/OS - IBM
z/OS Version 2 Release 3
Unicode Services User's Guide and Reference
IBM
SA38-0680-30
Note Before using this information and the product it supports, read the information in "Notices" on page 605.
This edition applies to Version 2 Release 3 of z/OS (5650-ZOS) and to all subsequent releases and modifications until otherwise indicated in new editions. Last updated: 2019-02-16 ? Copyright International Business Machines Corporation 2001, 2017. US Government Users Restricted Rights ? Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
Contents
List of Figures....................................................................................................... ix
List of Tables........................................................................................................ xi
About this information......................................................................................... xv
Who should use this information............................................................................................................... xv How this information is organized..............................................................................................................xv
Overview of contents............................................................................................................................ xv Syntax diagrams...................................................................................................................................xvi z/OS information........................................................................................................................................ xvi
How to send your comments to IBM.................................................................... xvii
If you have a technical problem............................................................................................................... xvii
Summary of changes......................................................................................... xviii
Summary of changes............................................................................................................................... xviii Summary of changes............................................................................................................................... xviii z/OS Version 2 Release 1 summary of changes......................................................................................xviii
Part 1. Introduction to the Unicode Standard and z/OS Unicode Services................ 1
Chapter 1. Introduction to the Unicode Standard.......................................................................................3 What is the Unicode Standard?.............................................................................................................. 3 The Unicode standard............................................................................................................................ 3 How the Unicode Standard relates to prior standards such as ASCII and EBCDIC............................. 4 Evolving standards based on limited platforms............................................................................... 4 Historical simplicity creates modern complexity.............................................................................4 Character sets for many characters................................................................................................. 4 Stateful encodings............................................................................................................................ 5 Why the Unicode Standard?................................................................................................................... 5 What is z/OS Unicode Services?.............................................................................................................6 z/OS support for the Unicode Standard application programming interfaces..................................... 6 Character conversion........................................................................................................................ 6 Case conversion................................................................................................................................ 7 Normalization.................................................................................................................................... 7 Collation............................................................................................................................................ 7 Stringprep..........................................................................................................................................7 Bidirectional transformation.............................................................................................................7 Conversion information service........................................................................................................ 8 Dynamic locale service..................................................................................................................... 8
Part 2. Application programmer information...........................................................9
Chapter 2. About the application programming interfaces ..................................................................... 11 z/OS Unicode environment.................................................................................................................. 11 General concepts when using the z/OS Unicode Services programming interfaces......................... 11 Conversion handle use......................................................................................................................... 13 Sample code......................................................................................................................................... 14 Characteristics for the caller ............................................................................................................... 14 Linkage conventions.............................................................................................................................14 Bidi function..........................................................................................................................................14 Related services................................................................................................................................... 14
iii
Chapter 3. Character conversion...............................................................................................................15 Calling the character conversion services........................................................................................... 15 Calling the bidi conversion services.....................................................................................................18 Restrictions for the calling environment..............................................................................................19 Using the C interface............................................................................................................................ 19 Mapping of parameters in C................................................................................................................. 19 31-bit mapping............................................................................................................................... 20 64-bit mapping............................................................................................................................... 22 Using the HLASM interface.................................................................................................................. 24 Mapping of parameters for AMODE (31)..............................................................................................25 Description of parameters in area CUNBCPRM................................................................................... 27 Mapping of parameters for AMODE (64)..............................................................................................34 Description of parameters in area CUN4BCPR....................................................................................37 Mapping of the extended bidi parameter area.................................................................................... 44 AMODE(31)..................................................................................................................................... 44 Description of parameters in area CUNBDPRM............................................................................. 47 AMODE(64)..................................................................................................................................... 60 Description of parameters in area CUN4BDPR.............................................................................. 63 Handling a target buffer overflow ....................................................................................................... 75 Sample programs................................................................................................................................. 77
Chapter 4. Case conversion....................................................................................................................... 79 Calling the case conversion services................................................................................................... 80 Restrictions for the calling environment..............................................................................................81 Using the C interface............................................................................................................................ 81 Mapping of parameters in C................................................................................................................. 81 31-bit mapping............................................................................................................................... 81 64-bit mapping............................................................................................................................... 82 Using the HLASM interface.................................................................................................................. 83 Mapping of parameters for AMODE (31)..............................................................................................84 Description of parameters in area CUNBAPRM...................................................................................85 Mapping of parameters for AMODE (64)..............................................................................................89 Description of parameters in area CUN4BAPR....................................................................................91 Sample programs................................................................................................................................. 95
Chapter 5. Normalization...........................................................................................................................97 Calling the normalization service.........................................................................................................97 Handling a work buffer overflow ................................................................................................... 98 Restrictions for the calling environment..............................................................................................98 Using the C interface............................................................................................................................ 98 Mapping of parameters in C................................................................................................................. 99 31-bit mapping............................................................................................................................... 99 64-bit mapping............................................................................................................................... 99 Using the HLASM interface................................................................................................................ 100 Mapping of parameters for AMODE (31)........................................................................................... 101 Description of parameters in area CUNBNPRM................................................................................ 102 Mapping of parameters for AMODE (64)........................................................................................... 105 Description of parameters in area CUN4BNPR................................................................................. 106 Sample programs............................................................................................................................... 109
Chapter 6. Collation................................................................................................................................. 111 Calling the collation service............................................................................................................... 112 Restrictions for the calling environment........................................................................................... 116 Using the C interface.......................................................................................................................... 116 Mapping of parameters in C............................................................................................................... 120 31-bit mapping............................................................................................................................. 120 64-bit mapping............................................................................................................................. 122
iv
Mapping of constants in C..................................................................................................................123 Using the HLASM interface................................................................................................................ 125 Mapping of parameters for AMODE (31)........................................................................................... 127 Description of parameters in area CUNBOPRM................................................................................ 131 Mapping of constants for AMODE (31).............................................................................................. 144 Mapping of parameters for AMODE (64)........................................................................................... 146 Description of parameters in area CUN4BOPR................................................................................. 149 Mapping of constants for AMODE (64).............................................................................................. 162 Sort key vector format........................................................................................................................163 Work buffer length considerations.................................................................................................... 165 Target buffer length considerations...................................................................................................165 Sample programs............................................................................................................................... 166
Chapter 7. Bidi transformation................................................................................................................169 Calling bidi transformation service.................................................................................................... 169 Using the C interface.......................................................................................................................... 170 Mapping of parameters in C............................................................................................................... 170 31-bit mapping............................................................................................................................. 170 64-bit mapping............................................................................................................................. 171 Using the HLASM interface................................................................................................................ 171 Mapping of parameters for AMODE (31)........................................................................................... 172 Description of parameters in area CUNBBPRM.................................................................................173 Mapping of parameters for AMODE (64)........................................................................................... 174 Description of parameters in area CUN4BBPR................................................................................. 175 Character conversion service and the new B technique...................................................................177
Chapter 8. Stringprep conversion........................................................................................................... 179 Calling the stringprep services.......................................................................................................... 179 Using the C interface.......................................................................................................................... 179 Mapping of parameters in C............................................................................................................... 180 31-bit mapping............................................................................................................................. 180 64-bit mapping............................................................................................................................. 181 Using the HLASM interface................................................................................................................ 181 Mapping of parameters for AMODE (31)........................................................................................... 182 Description of parameters in area CUNBPPRM.................................................................................184 Mapping of parameters for AMODE (64)........................................................................................... 186 Description of parameters in area CUN4BPPR..................................................................................187 Sample programs............................................................................................................................... 189
Chapter 9. Conversion information service.............................................................................................191 Calling the conversion information service....................................................................................... 191 Restrictions for the calling environment........................................................................................... 192 Using the C interface.......................................................................................................................... 192 Mapping of parameters in C............................................................................................................... 192 31-bit mapping............................................................................................................................. 192 64-bit mapping............................................................................................................................. 195 Using the HLASM interface................................................................................................................ 198 Mapping of parameters for AMODE (31)........................................................................................... 202 Description of parameters in area CUNBIPRM..................................................................................207 Mapping of parameters for AMODE (64)........................................................................................... 216 Description of parameters in area CUN4BIPR.................................................................................. 221 Sample programs............................................................................................................................... 229
Chapter 10. Dynamic locale service........................................................................................................231 Adding and removing locales in the z/OS Unicode environment......................................................231 Mapping of parameters in C............................................................................................................... 231 31-bit mapping............................................................................................................................. 231 64-bit mapping............................................................................................................................. 232
v
................
................
In order to avoid copyright disputes, this page is only a partial summary.
To fulfill the demand for quickly locating and searching documents.
It is intelligent file search solution for home and business.
Related download
- list of mathematical symbols basic knowledge 101
- version 2 release 3 z os ibm
- sml nj language processing tools user guide
- character sets and unicode in firebird
- ascii code the extended ascii table
- windows alt codes reference chart
- unicode plain text encoding of mathematics
- date 2009 10 22 iso iec jtc 1 sc 2 wg 2 unicode
- the ascii character set
- ascii conversion chart
Related searches
- scrabble 2 and 3 letter words
- girlfriend experience season 2 release date
- 2 and 3 letter words for scrabble
- scrabble dictionary 2 and 3 letter words
- 2 and 3 letter words
- 13 reasons why season 2 release date
- sin 2 theta 3 4 5 triangle
- ielts speaking part 2 and 3 questions
- after 2 release date netflix
- after part 2 release date
- x 3 xy 2 y 3 1
- after 2 release date movie