z/OS Unicode Services User's Guide and Reference
Previous topic |
Next topic
|
Contents
|
Contact z/OS
|
Library
|
PDF
Contents (exploded view)
z/OS Unicode Services User's Guide and Reference
SA38-0680-00
Abstract for Unicode Services User's Guide and Reference
z/OS Version 2 Release 1 summary of changes
Introduction to the Unicode Standard and z/OS Unicode Services
Introduction to the Unicode Standard
What is the Unicode Standard?
The Unicode standard
How the Unicode Standard relates to prior standards such as ASCII and EBCDIC
Evolving standards based on limited platforms
Historical simplicity creates modern complexity
Character sets for many characters
Stateful encodings
Why the Unicode Standard?
What is z/OS Unicode Services?
z/OS support for the Unicode Standard application programming interfaces
Character conversion
Case conversion
Normalization
Collation
Stringprep
Bidirectional transformation
Conversion information service
Dynamic locale service
Application programmer information
About the application programming interfaces
z/OS Unicode environment
General concepts when using the z/OS Unicode Services programming interfaces
Conversion handle use
Sample code
Characteristics for the caller
Linkage conventions
Bidi function
Related services
Character conversion
Calling the character conversion services
Calling the bidi conversion services
Restrictions for the calling environment
Using the C interface
Mapping of parameters in C
31-bit mapping
64-bit mapping
Using the HLASM interface
Mapping of parameters for AMODE (31)
Description of parameters in area CUNBCPRM
Mapping of parameters for AMODE (64)
Description of parameters in area CUN4BCPR
Mapping of the extended bidi parameter area
AMODE(31)
Description of parameters in area CUNBDPRM
AMODE(64)
Description of parameters in area CUN4BDPR
Handling a target buffer overflow
Sample programs
Case conversion
Calling the case conversion services
Restrictions for the calling environment
Using the C interface
Mapping of parameters in C
31-bit mapping
64-bit mapping
Using the HLASM interface
Mapping of parameters for AMODE (31)
Description of parameters in area CUNBAPRM
Mapping of parameters for AMODE (64)
Description of parameters in area CUN4BAPR
Sample programs
Normalization
Calling the normalization service
Handling a work buffer overflow
Restrictions for the calling environment
Using the C interface
Mapping of parameters in C
31-bit mapping
64-bit mapping
Using the HLASM interface
Mapping of parameters for AMODE (31)
Description of parameters in area CUNBNPRM
Mapping of parameters for AMODE (64)
Description of parameters in area CUN4BNPR
Sample programs
Collation
Calling the collation service
Restrictions for the calling environment
Using the C interface
Mapping of parameters in C
31-bit mapping
64-bit mapping
Mapping of constants in C
Using the HLASM interface
Mapping of parameters for AMODE (31)
Description of parameters in area CUNBOPRM
Mapping of constants for AMODE (31)
Mapping of parameters for AMODE (64)
Description of parameters in area CUN4BOPR
Mapping of constants for AMODE (64)
Sort key vector format
Work buffer length considerations
Target buffer length considerations
Sample programs
Bidi transformation
Calling bidi transformation service
Using the C interface
Mapping of parameters in C
31-bit mapping
64-bit mapping
Using the HLASM interface
Mapping of parameters for AMODE (31)
Description of parameters in area CUNBBPRM
Mapping of parameters for AMODE (64)
Description of parameters in area CUN4BBPR
Character conversion service and the new B technique
Stringprep conversion
Calling the stringprep services
Using the C interface
Mapping of parameters in C
31-bit mapping
64-bit mapping
Using the HLASM interface
Mapping of parameters for AMODE (31)
Description of parameters in area CUNBPPRM
Mapping of parameters for AMODE (64)
Description of parameters in area CUN4BPPR
Sample programs
Conversion information service
Calling the conversion information service
Restrictions for the calling environment
Using the C interface
Mapping of parameters in C
31-bit mapping
64-bit mapping
Using the HLASM interface
Mapping of parameters for AMODE (31)
Description of parameters in area CUNBIPRM
Mapping of parameters for AMODE (64)
Description of parameters in area CUN4BIPR
Sample programs
Dynamic locale service
Adding and removing locales in the z/OS Unicode environment
Mapping of parameters in C
31-bit mapping
64-bit mapping
Mapping of parameters for AMODE (31)
Description of parameters in area CUNBLPRM
Mapping of parameters for AMODE (64)
Description of parameters in area CUN4BLPR
System programmer information
z/OS Unicode environment
Key concepts behind the z/OS Unicode environment
Life cycle
Dynamic loading
CUNUNIxx parmlib statements
The knowledge base
The SETUNI command
Equivalent commands
The DISPLAY UNI command
How conversions are deleted from the z/OS Unicode environment
Storage requirements
Page-fixed (REALSTORAGE)
Conversion images
The DB2 conversion image
Diagnostic tools for z/OS Unicode environment errors
Diagnosing Unicode environment errors
API return codes
Console messages
The DISPLAY UNI command
The z/OS Unicode environment mapping utility (CUNMIMAP)
Dumping the z/OS Unicode dataspace
Recovering from z/OS Unicode environment errors
Delete individual conversions
Delete all conversions
System-initiated "reset" of the z/OS Unicode environment
Invalid conversion handles
Manually setting up z/OS Unicode Services
Prerequisites
Configuring the z/OS Unicode environment
Updating parmlib members
CUNUNIxx
IEASYSxx
MVS Message Service
Creating the z/OS Unicode Services environment
Creating a conversion image
Step a: Select the conversions
Step b: Specify control statements
Control statement CONVERSION
Control statement CASE
Control statement NORMALIZE
Control statement COLLATE
Image generator
Step c: Invoke the image generator
Step d: Use the image generator listing
Specifying the type of conversion
Character conversion
Understanding how z/OS Unicode Services loads conversion tables
Case conversion
Normalization conversion
Collation conversion
Calculating the storage needed for a conversion image
Estimating the size of an image based on planned conversions
Determining the size of an image from an existing member
Determining the size of the active image
Determining the value for the REALSTORAGE parameter
Managing a conversion handle that is not valid
Changing the conversion environment
Creating user-defined conversion tables
Format of tables
Table naming convention
Creating a user-defined conversion table between two existing CCSIDs
Example of building a character map based from an existing conversion table
Step 1: Create the text format file
Reference information on CUNJITG1 (not required reading for the example above)
Step 2: Change the mapping
Reference information on text source (not required reading for the example above)
Step 3: Create the binary file
Reference information on CUNJITG2 (not required reading for the example above)
Step 4: Load the new table
Step 5: Update your system for the next IPL
Step 6: Update your program to use the new table
Defining a new user-defined CCSID and then creating a user-defined conversion table using this new CCSID
Step 1: Update the z/OS Unicode Services knowledge base
Step 1a: Modify CUNSIUKB for the new user-defined CCSID
Step 1b: Assemble and link the modified z/OS Unicode Services knowledge base module using CUNSIUKB
Reference information on CUNSIUKB
Step 1c: IPL the system to activate the new z/OS Unicode Services knowledge base
Steps two through seven
Reference information about the CUNAIKBG macro
Description of CCSIDs
Unicode CCSIDs
Encoding Scheme
Conversion support for multi-byte encodings (MBCS)
Internal handling of MBCS conversions
MBCS CCSID decomposition
When a shift character is in the data stream
MBCS CCSIDs compatible with iconv
C-variant MBCS CCSIDs compatible with iconv()
Conversion tables supplied with z/OS Unicode Services
Direct conversions supported between non-Unicode CCSIDs
Direct conversions supported to and from Unicode
Validation, case, normalization, collation, & stringprep resources
Validation tables
Case conversion tables
Normalization tables
Collation tables
Stringprep tables
Locales for collation and case support
Locales supported for collation
Locales supported for case service
Locales for dynamic locale service
Adding and removing locales to the z/OS Unicode Services environment
Euro and pre-euro support
Language Environment C/C++ Runtime Library compatible locale support
System control offsets
Examples for 31-bit callers
List of offsets for 31-bit services
Examples for 64-bit callers
List of offsets for 64-bit services
Unicode return and reason codes
Return code meanings
Image generator for z/OS support for Unicode – return codes
Copyright IBM Corporation 1990, 2014