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.
Debugging EGL applications
Remote VSAM support using DFM
You can use DFM to access remote VSAM files in the following cases: when you run the EGL debugger on a Windows™ platform, or when EGL-generated Java™ code is running on a 32-bit Windows platform or on AIX®.

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
    - 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
      - Stepping through an application in the EGL debugger
        This topic offers guidance on the basic steps of debugging a program in the EGL debugger.
      - Debugging an EGL batch program
      - EGL debugger controls
      - How build descriptor settings affect the EGL debugger
      - Using breakpoints in the EGL debugger
        This topic shows you how to use breakpoints in debugging your programs. You can manage breakpoints inside or outside of an EGL debugging session.
      - Viewing variables in the EGL debugger
        This topic shows you how to view variables in your program while your are debugging your programs.
      - Watch expressions in the EGL debugger
        Use a watch expression to track the value of an expression during debug.
      - Making code updates while debugging an application
      - Starting the EGL debugger for EGL projects
        To start the debugging process you need a launch configuration.
      - Debugging web projects with the EGL debugger
        Use the EGL debugger to debug web projects.
      - Debugging services with the EGL debugger
        You can debug your local EGL services similarly to the way that you debug other programs.
      - Using the EGL debugger to debug IMS™, ZOSBATCH, and DL/I with the stored procedure linkage
        You can debug EGL programs that call remote IMS™ or ZOSBATCH programs.
      - Using the EGL debugger to debug VSE DL/I applications
        You can debug EGL programs that access DL/I databases on z/VSE®.
      - Character encoding options for the EGL debugger
      - Remote VSAM support using DFM
        You can use DFM to access remote VSAM files in the following cases: when you run the EGL debugger on a Windows™ platform, or when EGL-generated Java™ code is running on a 32-bit Windows platform or on AIX®.
      - Remote VSAM support for z/OS® using TCP/IP
        You can use TCP/IP to access remote VSAM files when you run the EGL debugger or when EGL-generated Java™ code is running on any supported platform.
      - Remote VSAM support for z/VSE®
        You can access remote VSAM files that are defined under z/VSE® and z/VSE CICS® when you run the EGL debugger on a Windows™ platform.
      - Installing and configuring remote VSAM support for CICS®
        You can use TCP/IP to access a VSAM file on a remote z/OS® or z/VSE® system from EGL-generated Java™ code or from the EGL debugger. Use CICS® to control the operation if you typically access the file through CICS transactions.
      - Installing and configuring remote VSAM support for VSAM Connector Server
        You can use TCP/IP to access a VSAM file on a remote z/OS® system from EGL-generated Java™ code or from the EGL debugger. Use the VSAM Connector Server to control the operation if you typically access the file through a batch job.
      - Setting preferences for the EGL debugger
        The EGL debugger has two main pages of preferences: the first contains general preferences, and the second contains a list of programs or services to debug in generated code (Java™ or COBOL). An additional page is available if you have set the EGL DLI Developer capability.
    - 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

Remote VSAM support using DFM

You can use DFM to access remote VSAM files in the following cases: when you run the EGL debugger on a Windows™ platform, or when EGL-generated Java™ code is running on a 32-bit Windows™ platform or on AIX®.

To use DFM to access remote VSAM files, do as follows:

Satisfy the access prerequisites
Provide resource association information and reference the resource association part from the build descriptor that you use for debugging your program

Access prerequisites

To access VSAM files, you first define the VSAM file on the system where you want the file to reside.

Remote VSAM access requires that you install the Distributed File Manager (DFM) on the workstation. Additional capabilities are also available in the JAR file that contains the DFM installation code.

Do as follows:

Find the following subdirectory:
```
  installDir\eclipse\plugins
```
where installDir is the installation directory for your product.
In that directory, find the following JAR file:
```
  com.ibm.etools.egl.java.binaries_<version>.jar
```
where <version> is a version number, such as 7.1.101.v20090718_0331.

To gain remote VSAM access for use in debug sessions on the development platform or for use on a runtime platform, do as follows:

Find the file EGLRuntimes\win\bin\Vsamwin.zip within the JAR file
Extract Vsamwin.zip into a new directory (whether on the development or runtime platform)
Follow the directions in the extracted INSTALL.README file

Resource Association

When you create the resource association part to use when you debug your EGL program on Windows™, specify the file type and systemName as follows:

File type

Set the file type to ibmcobol.

systemName

Specify the system name in the following way:

  \\machineName\qualifier.fileName

machineName: The SNA LU alias name as specified in the SNA configuration
qualifier.fileName: The VSAM data set name, including a qualifier

The naming convention is similar to the Universal Naming Convention (UNC) format. For details on UNC format, refer to the Distributed FileManager User's Guide, which is included in the vsamwin.zip file.