Message customization for EGL Java run time

When an error occurs at Java™ run time, an EGL system message is displayed by default; but you can specify a customized message for each of those system messages or for a subset.

When a message is required, EGL first searches a properties file that you identify in the Java runtime property vgj.messages.file. The format of the referenced file is the same as for any Java properties file, as described in Program properties file and as shown in the current topic.

In many cases, a system message includes placeholders for the message inserts that EGL retrieves at run time. If your code submits an invalid date mask to a system function, for example, the message has two placeholders; one (placeholder 0) for the date mask itself, the other (placeholder 1) for the name of the system function. In properties-file format, the entry for the default message is as follows:
  VGJ0216E = {0} is not a valid date mask for {1}.
You can change the wording of the message to include all or some of the placeholders in any order, but you cannot add placeholders. Valid examples are as follows:
  VGJ0216E = Function {1} was given invalid date mask {0}.

  VGJ0216E = Function {1} was given an invalid date mask.

A fatal error occurs if the file identified in property vgj.messages.file cannot be opened.

For details on the message numbers and their meaning, see EGL Java runtime error codes.

Other details are available in Java language documentation:

Related concepts
Program properties file

Related reference
EGL Java runtime error codes
Java runtime properties (details)

Feedback
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.