support: Customer Portal
Focused on delivering choice, investment protection and flexibility to organizations with valuable COBOL assets

Veryant Knowledge Base
Home > All Categories > isCOBOL General > Localization > Is there a way to localize (translate) text messages similar to the ACUCOBOL-GT TEXT configuration variable?
Question Title Is there a way to localize (translate) text messages similar to the ACUCOBOL-GT TEXT configuration variable?

With isCOBOL text messages displayed by the compiler, debugger and runtime can be customized or translated into the language of your choice.

iscobol.jar and isrun.jar contain text resource files for the following locales:

ar, de, el, en, es, fr, it, ja, nl, pt, ru, zh_CN, zh_TW

The above are ISO 639-1 codes listed on optionally followed by an underscore and an ISO 3166-1 country code listed at

The messages that are currently localized are:

username=User Name
change_password=Change Password
new_password=New Password
retype_password=Retype Password
open=Browse for folder
selectall=Select all
ef_out_of_range_msg_part1=Please enter a value between
ef_input_required_msg=Entry required!
ef_error_number=Number required

These messages can be customized with the following steps:

1. Extract the default language text resource file or the file you are customizing with the following command:

jar xvf isrun.jar com/iscobol/rts/

where xx is one of the codes listed above. For example, to extract the default message file

jar xvf isrun.jar com/iscobol/rts/

To customize the English language message file

jar xvf isrun.jar com/iscobol/rts/

2. Edit the file. If you are adding a new language, then rename the file to replacing xx with the appropriate code(s) from the websites listed above.

3. Add the text resource file to a new jar file with the following command:

jar cvf mymessages.jar com/iscobol/rts/

replacing xx with the appropriate code.

4. Make sure your new jar file precedes isrun.jar or iscobol.jar in the class path used when running a program. For example,

java -cp "mymessages.jar;%CLASSPATH%" MYPROG

If you prefer, you can replace the text resource file in isrun.jar and/or iscobol.jar with the jar -u option. For example, to replace the English messages in isrun.jar use the following command:

jar uvf isrun.jar com/iscobol/rts/

Note that text resource files must be written using ISO 8859-1 encoding. To insert characters that cannot be represented by the ISO encoding, Unicode escape sequences must be used. The escape sequence is composed by \u followed by the utf-16 representation of the character (the same you would use with nx syntax in the cobol source).

See How do I use text that has been translated into other languages in my screens and messages? for more information.

Authored by: Veryant Support This question has been viewed 5669 times so far.
Click Here to View all the questions in Localization category.
File Attachments File Attachments
There are no attachment file(s) related to this question.
How helpful was this article to you?
User Comments User Comments Add Comment
There are no user comments for this question. Be the first to post a comment. Click Here
Related Questions Related Questions
  1. How do I use text that has been translated into other languages in my screens and messages?
Article Information Additional Information
Article Number: 140
Created: 2010-07-22 11:42 AM
Rating: 1 Star
Article Options Article Options
Print Question Print this Question
Email Question Email Question to Friend
Export to Adobe PDF Export to PDF File
Export to MS Word Export to MS Word
Bookmark Article
Subscribe to Article Subscribe to Article
Search Knowledge Base Search Knowledge Base


© Veryant - All Rights Reserved
Veryant and isCOBOL are trademarks or registered marks of Veryant in the United States and other countries. All other marks are the property of their respective owners.