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 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.
Contents of an EGL application
EGL applications contain projects, packages, folders, and files.
Projects
Sharing projects
This topic explains the options for sharing projects between computers, as well as some of the possible problems in doing so.
Sharing projects in a repository
These general guidelines describe EGL files that you will most likely share in a repository or source-control system. The guidelines also cover some common problems you might encounter when sharing EGL projects.

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.
    - Introduction
      These topics explain the fundamentals of using EGL in the Eclipse IDE, as well as changes to the EGL language and IDE in this version.
    - Contents of an EGL application
      EGL applications contain projects, packages, folders, and files.
      - Projects
        Creating an EGL project
        This topic covers how to create an EGL project.
        Creating an EGL web project
        This topic covers how to create an EGL web project.
        Creating an EGL plug-in project
        EGL plug-in projects, also called RCP projects, are useful for Console UI applications that you want to run in rich client platform (RCP) mode. You can create a new EGL plug-in project or convert an existing EGL project or EGL web project to an EGL plug-in project.
        Renaming an EGL project
        If you rename an EGL project, you must manually correct most of the references to that project.
        Features and facets of EGL projects
        EGL projects can have additional abilities, added through features and facets.
        Sharing projects
        This topic explains the options for sharing projects between computers, as well as some of the possible problems in doing so.
        Importing projects and files
        The workbench includes several ways to import EGL projects and files from your local file system.
        Exporting projects and files unrelated to EGLAR support
        The workbench includes several ways to export EGL projects and related files to your local file system. For details on exporting binary projects and EGLAR files, see the related tasks.
        Sharing projects in a repository
        These general guidelines describe EGL files that you will most likely share in a repository or source-control system. The guidelines also cover some common problems you might encounter when sharing EGL projects.
        The EGL build path
        EGL projects contain a build path, which lists EGL projects and EGLAR files that you want to reference from the current project.
      - Source folders
      - Packages
        Packages work like folders: they organize source files and prevent naming conflicts.
      - Files
      - Parts
        Parts are the building blocks of EGL applications.
      - Introduction to EGLAR files and binary projects
        An EGLAR file is a zip file that contains the compiled, intermediate representation (IR) version of one or more EGL parts.
      - Build parts
        Build parts control the generation process and set how an application will behave at run time. The kinds of build parts you need vary depending on the target platform of your application and the type of application that you have created.
      - Renaming parts
        You can use the refactoring function of the workbench to rename parts and correct references to those parts.
      - Moving parts
        You can use the refactoring function of the workbench to move parts between source files and correct references to those parts.
    - Properties
      Properties set specific options for parts. In general, you specify the properties when you create the part and then the properties are static. In certain circumstances, however, it is possible to change a property dynamically.
    - Import and use statements
      Use the EGL import and use statements to expand the visibility of code elements.
    - Working with EGL code
    - Accessing data with EGL code
    - Transfer of control across programs
    - Developing segmented programs in EGL
      Different runtime environments have different considerations for developing segmented programs.
    - Developing EGL programs for the IMS™ environment
    - Developing EGL programs for the CICS® environment
      There are specific design and development considerations when creating EGL programs for CICS® for z/OS® and CICS for VSE.
    - Developing EGL programs for the VSE environment
      Rational® Business Developer provides a Generation for VSE feature that you can use to generate EGL as COBOL source for the z/VSE® environment.
    - Developing programs for iSeriesC
      You can deploy EGL-generated COBOL programs targeted for the IBM® i environment.
    - Overview of EGL Rich UI
    - Services: a top-level overview
      The topics in this section describe service-oriented architecture (SOA) and related technologies, EGL support for SOA, and service-related procedures, with an emphasis on service access. For details about deployment, see “Introduction to EGL generation and deployment” and “Add web-service deployment entries in the EGL deployment descriptor.”
    - 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.
    - Building EGL Text User Interface applications
      A Text UI application presents a text-based user interface similar to that of a 5250 or 3270 terminal.
    - Creating reports with EGL
      EGL offers different ways to create reports, using external engines to generate the report contents.
    - Working with web transaction applications in EGL
    - Debugging EGL applications
    - z/OS Connect
  - 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.
  - 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

Sharing projects in a repository

These general guidelines describe EGL files that you will most likely share in a repository or source-control system. The guidelines also cover some common problems you might encounter when sharing EGL projects.

The way that you share your projects in a repository or source-control system depends on the type of repository or source-control system. In general, share source files and build files but not derived files, files that are created from other files. This way, the files in the repository are limited to only those necessary for the application. (If you edit a file directly, it is probably not derived.) For a discussion of derived files in the context of EGL, see Sharing projects.

Also, when you share projects in a repository, be aware of these possible problems:

If derived files are checked into a repository, they often lose their derived flags. In this case, files that you normally wouldn't check into a repository may appear to need to be stored in a repository.
Checking files into a repository can break connections between files. For example, if you check a UML model and a TPM file into a repository and then check them back out again, the workbench might not know that the two are associated. For information on this problem, see Linking a UML model to an existing TPM file.
When sharing projects in a repository, the projects are subject to the same potential errors as described in Sharing projects.