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.
Working with EGL code
Common programming tasks
These topics contain information on how to complete several common programming tasks in EGL.
Calling C functions through EGL libraries
C data types and EGL primitive types

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.
    - 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
      - Common programming tasks
        These topics contain information on how to complete several common programming tasks in EGL.
        Turning lines of code into comment lines
        As in most languages, in EGL you can add comments in your code. EGL ignores any text that is commented.
        Calling Java™
        There are several ways to call Java™ code when you are generating Java from EGL. This topic covers a few of the most common ways, including using the system functions in the JavaLib system library such as javaLib.invoke(), and declaring an ExternalType part.
        Calling C functions with the call statement
        Calling C functions through EGL libraries
        Invoking a C function from an EGL program
        BIGINT functions for C
        DATE functions for C
        DATETIME and INTERVAL functions for C
        DECIMAL functions for C
        Stack functions for C
        Return functions for C
        C data types and EGL primitive types
        Working with substrings
        You can use brackets to treat a CHAR(n) or STRING variable as an array of characters.
        Encrypting passwords
        You can encrypt passwords with an EGL command-line utility. Password encryption is supported only for Java™ programs and the debugger, not for COBOL programs.
        Handling errors
        With EGL, you can decide how your program behaves in case of errors.
        Customizing EGL system runtime messages for Java™
      - The EGL editor
        The EGL code editor looks and works like a standard text editor or code editor for other languages, but it has additional features to help you edit EGL code. The code editor highlights invalid syntax, provides an explanation for problems in the code, colors keywords, strings, and comments, and helps you write EGL code.
      - Content assist
      - Using cheat sheets
        Cheat sheets can assist you with common tasks in the Workbench. They provide step-by-step instructions within a workbench view and can perform some of the steps in the task automatically.
      - Editing DataItem parts with the source assistant
      - Searching for EGL files and parts
        The workbench provides several options for searching for and viewing EGL files and parts.
      - Shortcuts in the EGL editor
        In the EGL editor, you can use the following shortcuts:
      - Preferences
        EGL preferences affect the way the workbench displays and works with EGL.
      - EGL Deferred Work view
    - 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

C data types and EGL primitive types

The following table shows the mapping between C data types, and EGL primitive types for use in a Library part with the stereotype nativeLibrary.


C data types	Equivalent EGL primitive type
char	UNICODE(1)
char	UNICODE(size)
char	STRING
char	STRING
int	INT
short	SMALLINT
ifx_int8_t	BIGINT
dec_t	DECIMAL(p)
dec_t	MONEY
double	FLOAT
float	SMALLFLOAT
loc_t	CLOB
loc_t	BLOB
int	DATE
dtime_t	TIMESTAMP
intvl_t	INTERVAL