Welcome
Developing
Developing EGL applications
Enterprise Generation Language (EGL) is a programming language that you can use to focus on business problems instead of software technologies. Within the Rational® development environment, you can use EGL wizards and other tools to write complex applications with minimal effort.
EGL Language Reference
The EGL Language Reference covers the fundamental use of the language, including its concepts, syntax, and keywords. This volume is intended for a developer writing EGL applications with some experience in procedural programming.
Applications with user interfaces
Reference to widgets
Dojo widgets
The EGL Dojo widgets are based on Dojo technology.
DojoButton
A Dojo button invokes an event handler in response to a user’s click.

Overview
Getting started
Installing
Upgrading and migrating
Developing
- Model driven development of EGL code
- Generating source code from UML models
  You can use transformations to create source code from a UML model. First you must create a transformation parameters file and then apply those parameters to a model.
- Generating the EGL Dependency Graph from EGL projects
- Generating Source Code from OpenAPI Documents
- Developing EGL applications
  Enterprise Generation Language (EGL) is a programming language that you can use to focus on business problems instead of software technologies. Within the Rational® development environment, you can use EGL wizards and other tools to write complex applications with minimal effort.
  - How to use this documentation
  - Additional information about EGL
    The most recent EGL documentation is in the Rational® Business Developer Information Center.
  - EGL Programmer's Guide
    The EGL Programmer's Guide covers using EGL within the Eclipse Integrated Development Environment (IDE), as well as some of the common programming tasks that EGL developers perform.
  - EGL Generation Guide
    The EGL Generation Guide covers the process of converting EGL code to Java™ or COBOL source code, including the processes and the files involved. This section is intended for a developer who will generate or deploy EGL applications.
  - EGL Language Reference
    The EGL Language Reference covers the fundamental use of the language, including its concepts, syntax, and keywords. This volume is intended for a developer writing EGL applications with some experience in procedural programming.
    - General syntax
    - System data parts
    - User-defined data parts
    - Logic parts
    - Correspondence between a JSON string and an EGL variable
      This topic describes the EGL record that corresponds to a JavaScript™ Object Notation (JSON) string. Other topics describe the functions (serviceLib.convertFromJSON() and serviceLib.convertToJSON()) that are used by a Rich UI developer to convert JSON data to or from a variable, as may be necessary to access a third-party REST service. A failure in either function causes a RuntimeException.
    - Correspondence between a JSON string and an EGL variable for zOS and IBM i
      This topic describes the EGL record that corresponds to a JavaScript Object Notation (JSON) string. This topic describes the functions—serviceLib.convertFromJSON() and serviceLib.convertToJSON()—that are used by an EGL developer to convert JSON data to or from a variable either for zOS or IBM i systems. A failure in either function causes a RuntimeException.
    - Special considerations for JSON support on IBM i:
    - Correspondence between an XML string and an EGL variable
      This topic describes the EGL record that corresponds to an Extensible Markup Language (XML) string. Other topics describe the functions (serviceLib.convertFromXML and serviceLib.convertToXML) that are used by a Rich UI developer to convert XML data to or from a variable, as may be necessary to access a third-party REST service.
    - EGL statements
    - EGL core system libraries and variables
    - Accessing data in EGL
      Whenever you access a data store in EGL, the data goes into a record.
    - Applications with user interfaces
      - Enumerations for user interface properties and fields
      - Common UI statements
      - Common UI properties
      - Validation properties
      - Handler part
        A handler typically includes both variables and functions. It is used for basic processing and for user interaction.
      - Rich UI programming model
      - EGL library ruiLib
        This topic describes the system functions in the ruiLib library.
      - DojoLib
        The DojoLib library includes constants and validation functions used by the EGL Dojo widgets. The library is not a system library, and its use has prerequisites.
      - DojoMobileLib
        The DojoMobileLib widget defines constants that are used by EGL Dojo mobile widgets.
      - Reference to widgets
        Dojo widgets
        The EGL Dojo widgets are based on Dojo technology.
        DojoAccordionContainer
        The DojoAccordionContainer widget contains a set of panes in one pane of the user interface. When an action is taken for an individual interface, another pane in the interface is displayed. Each pane is defined by using the DojoContentPane widget.
        DojoBarGraph
        The DojoBarGraph widget creates bar graphs. Use this widget to create vertical or horizontal bar graphs.
        DojoBorderContainer
        The DojoBorderContainer widget creates a container partitioned into up to five regions: left, right, top, bottom, and center.
        DojoBubbleChart
        The DojoBubbleChart widget creates bubble charts. Use this widget to show the relationship of three different sets of data.
        DojoButton
        A Dojo button invokes an event handler in response to a user’s click.
        DojoCalendar
        The DojoCalendar widget creates a calendar.
        DojoCheckbox
        The DojoCheckbox widget creates check boxes.
        DojoColorPalette
        The DojoColorPalette widget creates a color palette.
        DojoComboBox
        The DojoComboBox widget defines a presentation that includes a visible value, which represents the current selection, and a dropdown list of values. This widget is based on the Dojo dijit.form.ComboBox definition.
        DojoContentPane
        The DojoContentPane defines the content of a tab pane. You must use this widget with either the DojoAccordionContainer or DojoTabContainer widgets.
        DojoContextMenu
        The DojoContextMenu widget creates a context menu that is invoked by a right-mouse click.
        DojoCurrencyTextBox
        The DojoCurrencyTextBox widget defines a text box that contains a numeric currency value. This widget is based on the Dojo dijit.form.CurrencyTextBox definition.
        DojoDateTextBox
        The DojoDateTextBox widget defines a text box that contains a date or part of a date. This widget is based on the Dojo dijit.form.DateTextBox definition.
        DojoDialog
        The DojoDialog widget creates a pop-up dialog box. By default, the box is hidden.
        DojoEditor
        The DojoEditor widget creates a text box that has editing functions.
        DojoFilteringSelect
        The DojoFilteringSelect widget defines an interface that includes an input box with a drop-down list. It accepts a list of acceptable value pairs that consists of two kinds of text. One is the text to be displayed in the input box. The other one is the hidden text to be submitted. You can also type the text and the partially matched values will be shown in a pop-up menu below the input text box. Unlike a DojoComboBox widget, the unmatched user text is flagged as an error. This widget is based on the Dojo dijit.form.FilteringSelect definition.
        DojoGrid
        The DojoGrid widget displays data in a table.
        DojoHorizontalSlider
        The DojoHorizontalSlider widget creates a horizontal ruler.
        DojoLineGraph
        The DojoLineGraph widget displays line graphs.
        DojoMenu
        Along with one or more DojoMenuItem widgets, the DojoMenu widget creates menu items. To create complex menus, you can nest the DojoMenu and DojoMenuItem widgets.
        DojoMenuItem
        The DojoMenuItem widget describes the items that are associated with a menu. Code a DojoMenuItem widget for each menu item.
        DojoPieChart
        Along with one or more PieChartData records, the DojoPieChart widget creates pie charts.
        DojoProgressBar
        The DojoProgressBar widget displays progress bars.
        DojoRadioGroup
        The DojoRadioGroup widget defines radio buttons.
        DojoStackContainer
        The DojoStackContainer widget creates a container that has multiple children. Only one child is displayed at a time.
        DojoTabContainer
        The DojoTabContainer widget creates tab folders.
        DojoTextArea
        The DojoTextField widget defines a text box containing one or more lines of text. This widget is based on the Dojo dijit.form.SimpleTextarea definition.
        DojoTextField
        The DojoTextField widget defines a text box that contains a single line of text. This widget is based on the Dojo dijit.form.ValidationTextBox definition.
        DojoTimeTextBox
        The DojoTimeTextBox widget defines a text box that contains a time value. This widget is based on the Dojo dijit.form.TimeTextBox definition.
        DojoTitlePane
        The DojoTitlePane widget creates a collapsible container with a title bar.
        DojoToggleButton
        The DojoToggleButton widget creates a button and the text of the button changes when clicked.
        DojoTooltip
        The DojoTooltip widget creates a pop-up window that contains information. You can use the DojoTooltip with any element that uses the ID property.
        DojoTooltipDialog
        The DojoTooltipDialog widget creates a tooltip that contains a dialog.
        DojoTree
        The DojoTree widget works with an array of DojoTreeNode records to create trees.
        DojoTreeNode
        The DojoTreeNode record creates the elements that compose a tree.
        EGL Dojo mobile widgets
        The EGL Dojo mobile widgets are based on Dojo technology.
        Rich UI BidiTextArea
        Rich UI BidiTextField
        Rich UI Box
        Rich UI Button
        Rich UI Checkbox
        Rich UI Combo
        Rich UI DataGrid and DataGridTooltip
        A Rich UI dataGrid widget defines an array of row values in a table. This topic gives general information about the widget and then provides reference detail.
        Rich UI Div, FloatLeft, and FloatRight
        Rich UI Grid and GridTooltip
        Rich UI GridLayout
        A Rich UI grid layout has variably spaced rows and columns that embed child widgets. Each child widget has a layoutData property, and you specify the location of the widget by assigning a value to that property. Your layoutData settings also can align the widget horizontally and vertically within the position and can cause the widget to span multiple rows and columns.
        Rich UI Grouping
        Rich UI HTML
        Rich UI Hyperlink
        Rich UI Image
        Rich UI List
        Rich UI ListMulti
        Rich UI Menu
        Rich UI PasswordTextField
        Rich UI RadioGroup
        Rich UI Shadow
        Rich UI Span
        Rich UI TextArea
        Rich UI TextField
        Rich UI TextLabel
        Rich UI Tooltip
        Rich UI Tree and TreeTooltip
      - EGL reports
      - Text UI
        A text UI application presents a text-based user interface similar to that of a 5250 or 3270 terminal.
      - Web transaction support in EGL
        Use EGL web transactions to migrate VisualAge® Generator web transactions to EGL.
    - VisualAge® Generator compatibility
    - Appendices
    - Importing product-supplied projects
      You can click a link to download the current version of Rich UI projects. The capability is useful if you deleted a project or want a clean version.
  - Rational® COBOL Runtime Guide for zSeries®
    This manual provides information about customizing and administering the IBM® Rational® COBOL Runtime.
  - Rational® Business Developer EGL Server Guide for IBM® i
    This manual provides information about customizing and administering EGL Server for IBM® i on the host.
  - Generation for VSE Feature Reference
    This reference manual provides z/VSE-specific information about developing and generating EGL programs in the VSE environment.
- Source code analysis with code review
  With code review, you can create configurations of coding rules for EGL source code. You can then run the configurations to check the source code for consistency with the rules.
- Responsive Design Support in RBD
  What is Responsive Design? Responsive design is an approach for creation of web pages that automatically scales its content and elements to match the screen size on which it is viewed. So, instead of designing multiple websites for different devices with variable screen sizes, we can design just one website that scales up or down automatically, to match the device it’s being viewed on.
Samples
Troubleshooting and support
EGL runtime error messages
Reference
Glossary
Using the help
Notices for IBM Rational Business Developer documentation

DojoButton

A Dojo button invokes an event handler in response to a user’s click.

Properties

text: The text label for the button.
width: The width of the button.

Events

onClick: Specifies an event that occurs when the button is pressed