Skip to main content

Software  > Globalization > CDRA > 

Globalize your On Demand Business

Appendix H. OS/400 Considerations
CDRA API Considerations for the Operating System/400 Licensed Program

This appendix summarizes additional information you need when using the CDRA APIs on the OS/400 licensed program. APIs are found in "Chapter 5. CDRA Interface Definitions"; they are not duplicated in this appendix.

Note: For information on general national language support information for the OS/400 licensed program, see AS/400 National Language Support, SC41-3101.
CDRA APIs in the OS/400 Licensed Program

The following CDRA APIs are included in the OS/400 licensed program in the QSYS2 library:

  • Convert a Graphic Character String (CDRCVRT)
  • Get CCSID for Normalization (CDRGCCN)
  • Get Control Function Definition (CDRGCTL)
  • Get Encoding Scheme, Character Set, and Code Page Elements (CDRGESP)
  • Get Related Default CCSID (CDRGRDC)
  • Get Short Form (CCSID) from Specified ES (CS, CP) (CDRSCSP)
  • Get Short Form (CCSID) with Maximal CS for Specified ES, CP (CDRSMXC)

CDRCVRT - Convert a Graphic Character String API

The following parameter ranges and functional differences apply when using the CDRCVRT API (as described in "CDRCVRT - Convert a Graphic Character String") with the OS/400 licensed program.

CCSID1 a value in the range 1 to 65,534.
L1 a number from 1 to 32,767.
ST1 if ST1 is 1, and the null-termination character is not encountered within L1 bytes, an error condition is indicated. The function then performs as if ST1=0. The use of this default is not recommended.
CCSID2 a value in the range 1 to 65,534.
GCCASN 0 and 1 are the only values allowed. All others are reserved. Both 0 and 1 select the IBM default mapping.
L2 a number in the range 1 to 32,767.
L3 a number in the range 1 to 32,767.
L4 the implementation of this API does not support the function of this parameter. This value is always returned as 0.
Feedback Value for value 0004 0001, the implementation of this API does not support returning a properly truncated string in S2.

CDRGCCN - Get CCSID for Normalization API

The following parameter ranges and functional differences apply when using the CDRGCCN API (as described in CDRGCCN - Get CCSID for Normalization") with the OS/400 licensed program.

CCSID1 a number in the range 1 to 65,534.
CCSID2 a number in the range 1 to 65,534.

CDRGCTL - Get Control Function Definition API

The following parameter range and functional differences apply when using the CDRGCTL API (as described in "CDRGCTL - Get Control Function Definition") with the OS/400 licensed program.

N1 the maximum input value permitted is 99
CCSID1 if CCSID1 is 13488 (UCS-2) and SEL is 0, the code point value returned for SPACE is X'0020'
CCSID2 if CCSID1 is 13488 (UCS-2) and SEL is 1, the code point value returned for SUB is X'001A'

CDRGESP - Get Encoding Scheme, Character Set, and Code Page Elements API

The following parameter ranges and functional differences apply when using the CDRGESP API (as described in "CDRGESP - Get Encoding Scheme, Character Set, and Code Page Elements") with the OS/400 licensed program.

CCSID1 a number in the range 1 to 65,534.
ES a number in the range 4,096 to 65,535.

CDRGRDC - Get Related Default CCSID API

The following parameter ranges and functional differences apply when using the CDRGRDC API (as described in "CDRGRDC - Get Related Default CCSID") with the OS/400 licensed program.

CCSID1 a number in the range 1 to 65,534.
ESIN a zero, or a number in the range 4,352 to 65,534.
SEL SEL is verified to be within its specified range of valid values. If a value is found that is outside the specified range, it is treated as zero. The use of this default is not recommended.
CCSIDR a number in the range 1 to 65,534.

CDRSCSP - Get Short Form (CCSID) from Specified ES (CS, CP) API

The following parameter ranges and functional differences apply when using the CDRSCSP API (as described in "CDRSCSP - Get Short Form (CCSID) from Specified ES (CS, CP)") with the OS/400 licensed program.

ESIN a number in the range 4,352 to 65,534. The implementation of this API supports only a value of zero for this parameter.
CCSIDR a number in the range 1 to 65,534.
ESR the implementation of this API does not support the function of this parameter.
CDRSMXC - Get Short Form (CCSID) with Maximal CS for Specified ES, CP API

This API has been implemented as described in "CDRSMXC - Get Short Form (CCSID) with Maximal CS for Specified ES, CP" with no functional differences or parameter range variations.


E-mail us
Easy ways to get the answers you need.
E-mail us

Stay informed

Globalization News
Stay informed

Locate IBM globalized products

Product languages
Locate IBM globalized products

interact globally

Discussion forum
interact globally