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
EGL Dojo mobile widgets
The EGL Dojo mobile widgets are based on Dojo technology.
DojoMobileToolBarButton
The DojoMobileToolBarButton widget is a button that is placed in the header of the DojoMobileView widget. It can only live as a child of DojoMobileView's toolbar property.

Overview
Getting started
Installing
Upgrading and migrating
EGL Code Accelerator for IBD
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 IBM Business Developer documentation.
  - 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
      - 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.
        EGL Dojo mobile widgets
        The EGL Dojo mobile widgets are based on Dojo technology.
        DojoMobileView
        The DojoMobileView widget is a container for widgets in a mobile application. Mobile applications are made up of one or more views, and each of the views contains the tabs, lists, or other widgets. The view has a header area across the top, with an optional button for navigating back to the previous view. The views are declared as part of the initialUI for the Rich UI handler, if necessary.
        DojoMobileButton
        The DojoMobileButton widget starts an event handler in response to a user's click.
        DojoMobileCheckbox
        The DojoMobileCheckbox widget displays a boolean value.
        DojoMobileDatePicker
        The DojoMobileDatePicker widget creates a date picker, with which the user can set the date with just one click.
        DojoMobileIconContainer
        The DojoMobileIconContainer widget is a container for the icon items that trigger action and event.
        DojoMobileIconItem
        The DojoMobileIconItem widget is an icon that associates the actions and child of DojoMobileIconContainer.
        DojoMobileListCategory
        The DojoMobileListCategory widget is a titled separator within a list. The list category is useful for alphabetic or logical grouping of the list items.
        DojoMobileList
        The DojoMobileList widget provides a container for the list items and categories.
        DojoMobileListItem
        The DojoMobileListItem widget displays the items in a DojoMobileList.
        DojoMobileOpener
        The DojoMobileOpener widget is a component that encapsulates the mechanism for displaying secondary views such as dialogs.
        DojoMobileProgress
        The DojoMobileProgress widget displays the progress bars.
        DojoMobileSlider
        The DojoMobileSlider widget creates a slider that allows changing a numeric value by dragging a slider handle.
        DojoMobileSwitch
        The DojoMobileSwitch widget creates a switch, which is a toggle switch with a slider. You can either tap or drag the slider to toggle the switch.
        DojoMobileTabContainer
        The DojoMobileTabContainer widget creates the tab folders.
        DojoMobileTab
        The DojoMobileTab widget is an individual tab and only live inside the tab container.
        DojoMobileTextArea
        The DojoMobileTextArea widget defines a text box that contains one or more lines of text.
        DojoMobileTimePicker
        The DojoMobileTimePicker widget creates a time picker, with which the user can set the time with just one click.
        DojoMobileToolBarButton
        The DojoMobileToolBarButton widget is a button that is placed in the header of the DojoMobileView widget. It can only live as a child of DojoMobileView's toolbar property.
        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.
  - IBM 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 IBD
  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.
- Containerizing an EGL RUI Application
Samples
Troubleshooting and support
EGL runtime error messages
Reference
Glossary
Using the help
Notices for IBM Business Developer documentation

DojoMobileToolBarButton

The DojoMobileToolBarButton widget is a button that is placed in the header of the DojoMobileView widget. It can only live as a child of DojoMobileView's toolbar property.

Note:

To import the selected sample, you must install and use the local help.

Properties

text: The text label for the ToolbarButton.
imagePath: An icon that displays on the left of the item. The value can be either a path for an image file or a class name of a Dojo DOM button.
transition: The animation style when changing to another view. The values can be DojoMobileLib.TRANSITION_SLIDE , DojoMobileLib.TRANSITION_FADE, and DojoMobileLib.TRANSITION_FLIP. The default setting is DojoMobileLib.TRANSITION_SLIDE.
transitionDir: The transition direction. The values can be DojoMobileLib.TRANSACTION_DIR_FORWARD and DojoMobileLib.TRANSACTION_DIR_BACKWARD.
selected: Indicates whether the toolBarButton is in the selected status.
actionView: The view to move when the tool bar button is pressed.

Events

onClick: Specifies an event that occurs when the icon is clicked.