Skip to main content
Summary How to pass strings using non-default codesets
Article Number 35547
Environment Orbix 6.3.x All supported platforms
Question/Problem Description How to configure the codesets used by Orbix
How to change the codesets used by Orbix
How to specify the codeset for strings passed by an application
How to convert the codeset of strings received by an application
Clarifying Information The default codeset used by Orbix is determined by the platform. However, there may be times when users are required to use a different codeset.

This article demonstrates how to non-default codesets can be used by Orbix.
Error Message
Defect/Enhancement Number
Cause
Resolution The codesets used by Orbix can be specified through five configuration variables:

- plugins:codeset:always_use_default
  Set to "true" to use default codesets. Set to "false" to configure alternative codesets.


- plugins:codeset:char:ncs and plugins:codeset:wchar:ncs
  Specifies native codeset to use. This is applied to all characters and wide-characters sent from the CORBA application.

- plugins:codeset:char:ccs and plugins:codeset:wchar:ccs
  Specifies the list of conversion codesets to use. This can be applied to any characters and wide-characters sent to the CORBA application.

The codeset used in an Orbix request is negotiated between the client and server, using the above configuration variables. To summarise this negotiation:

  - If the sender and receiver both share the same NCS, this codeset is used for the request.
  - Else, if the NCS on one side matches a CCS on the other, this codeset is used for the request.
  - Else, if the sender and receiver share a common CCS, this codeset is used for the request.
  - Else, if the sender and receiver share a compatible CCS, UTF-8 is used for the request.
  - Finally, if none of the above conditions are met, an INCOMPATIBLE_CODESET exception is thrown.
Workaround
Notes
Attachment
Created date: 17 October 2012
Last Modified: 14 February 2013
Last Published: 14 February 2013
First Published date: 17 October 2012

#Orbix
#KnowledgeDocs