The msgResource JSF handler property identifies a Java™ resource bundle or properties file that is used in error-message presentation. The Java runtime searches for the file, which must be in a directory listed in the Java classpath.
The search is for a file whose name begins with the string the property points to, with an environment-specific locale value appended to that name. The Norwegian version of a resource bundle named myFile, for example, is myFile_no.
First, the runtime searches for a file with extension .class (for a resource bundle); but if that file is not found, it searches for a file with extension .properties (for a properties file).
The content of the resource bundle or properties file is composed of a set of keys and related values. A particular value is displayed in response to the program's calling the sysLib.setError() system function, when the call includes use of the key for that value.
This example assumes you set the property in the US:
Handler handler01 type JSFHandler
{ msgResource="errorMessages" }
...
end
The Java runtime
first looks for a file named errorMessages_en_US.class. If it does
not find the file, the runtime searches for errorMessages_en_US.properties.| Data item | JSF handler | VGUI record | Console UI | Text Form Java | Text Form COBOL | Print Form Java | Print Form COBOL |
|---|---|---|---|---|---|---|---|
| Yes | Yes | No | No | No | No | No | No |