Editing Java runtime properties in a build descriptor

When you are editing a build descriptor part, you can assign values to the following Java™ runtime properties, which are detailed in Java runtime properties (details):

Your assignments are used only if you generate Java code.

To edit the properties, do as follows:

  1. To open an EGL build file with the EGL build parts editor, do as follows in the Project Explorer:
    1. Right-click on the EGL build file
    2. Select Open With > EGL Build Parts Editor
  2. If the Outline view is not displayed, open that view by selecting Show View > Outline from the Window menu.
  3. In the Outline view, right-click on a build descriptor and select Open. The EGL part editor displays the general build descriptor options for the current part definition.
  4. Click the Show Java runtime Properties button on the editor toolbar.
  5. To add the Java runtime property vgj.jdbc.database.SN, do this:
    1. In the screen area that is titled "Database mappings for connect", click theAdd button
    2. Type a "Server name" that you use when coding the system word VGLib.connectionService; this value is substituted for SN in the name of the generated property
    3. If the row in the Database mappings for connect list is not highlighted, click once to select the row, then click the JNDI name or URL field once to put the field into edit mode. Type a value whose meaning is different for J2EE connections as compared with non-J2EE connections:
      • In relation to J2EE connections (as is needed in a production environment), the value is the name to which the datasource is bound in the JNDI registry; for example, jdbc/MyDB
      • In relation to a standard JDBC connection (as may be used for debugging), the value is the connection URL; for example, jdbc:db2:MyDB
  6. To assign the date masks used when you code either VGVar.currentFormattedGregorianDate (for a Gregorian date) or VGVar.currentFormattedJulianDate (for a Julian date); or EGL validates a page item or a text-form field that has a length of 10 or more and a dateFormat property of systemGregorianDateFormat or systemJulianDateFormat, do this:
    1. In the screen area that is titled "Date Masks", click the Add button
    2. In the Locale column, select one of the codes in the listbox; the selected value is substituted for locale in the date-mask properties listed earlier. Only one of your entries is used at run time: the entry for which the value of locale matches the value of the Java runtime property vgj.nls.code
    3. If the row in the Date Masks list is not highlighted, click once to select the row, then click the Long Gregorian Mask field once to put the field into edit mode. Either select a mask from the listbox or type a mask; characters other than D, Y, or digits can be used as separators, and the default value is specific to the locale
    4. If the row in the Date Masks list is not highlighted, click once to select the row, then click the Long Julian Mask field once to put the field into edit mode. Either select a mask from the listbox or type a mask; characters other than D, Y, or digits can be used as separators, and the default value is specific to the locale
  7. To assign the date masks used when EGL validates a page item or a text-form field that has a length less than 10 and a dateFormat property of systemGregorianDateFormat or systemJulianDateFormat, do this:
    1. In the screen area that is titled "Date Masks", click the Add button
    2. In the Locale column, select one of the codes in the listbox; the selected value is substituted for locale in the date-mask properties listed earlier. Only one of your entries is used at run time: the entry for which the value of locale matches the value of the Java runtime property vgj.nls.code
    3. If the row in the Date Masks list is not highlighted, click once to select the row, then click the Short Gregorian Mask field once to put the field into edit mode. Either select a mask from the listbox or type a mask; characters other than D, Y, or digits can be used as separators, and the default value is specific to the locale
    4. If the row in the Date Masks list is not highlighted, click once to select the row, then click the Short Julian Mask field once to put the field into edit mode. Either select a mask from the listbox or type a mask; characters other than D, Y, or digits can be used as separators, and the default value is specific to the locale
  8. To remove an assignment, click on it, then click the Remove button.

Related concepts
Build descriptor part
Java runtime properties

Related tasks
Adding a build descriptor part to an EGL build file
Editing general options in a build descriptor
Removing a build descriptor part from an EGL build file

Related reference
EGL build-file format
Java runtime properties (details)
connectionService()
currentFormattedGregorianDate
currentFormattedJulianDate

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