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.
Transfer of control across programs
Calling to and from Java™ programs
Using stored procedure linkage to call z/OS® batch from Java™
Whenever you generate Java™ code that does a remote call to z/OS® batch, do as follows:

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.
    - 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.
    - Annotating EGL Applications
      EGL developers can annotate their applications to indicate the version, authors as well as a general description.
    - 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
      - Reference information for special parameters on call or transfer statements
      - Calling programs in CICS® environments
      - Transferring control in CICS® environments
      - Calling programs in IMS™ and z/OS® batch environments
      - Transferring control in IMS™ BMP and z/OS® batch environments
      - Transferring control in the IMS/VS environment
      - Transferring to and from IMSADF II programs
      - Transferring control between EGL-generated COBOL and native programs on IBM® i
        This topic considers transfers between EGL-generated COBOL programs and native programs written in COBOL or RPG.
      - Calling to and from Java™ programs
        Calling a remote CICS® program from EGL-generated Java™ code or the debugger
        You can call a CICS® program remotely, from EGL-generated Java™ code or from the EGL debugger. The called program can be generated from EGL or VisualAge® Generator or can be written in another language.
        Calling a remote IMS™ program from EGL-generated Java™ code or the debugger
        You can call an IMS™ program remotely, from EGL-generated Java™ code or the EGL debugger. The called program can be generated from EGL or VisualAge® Generator or can be written in another language.
        Calling a remote IMS™ transaction from EGL-generated Java™ code or the debugger
        An EGL-generated Java™ program or the debugger can invoke a nonconversational, single-segment IMS™ transaction by way of IMS Connect. You must pass a separate input and output record, each of which includes details that are specific to IMS, and you must set the linkage part appropriately.
        Using stored procedure linkage to call z/OS® batch from Java™
        Whenever you generate Java™ code that does a remote call to z/OS® batch, do as follows:
        Configuring DB2® for stored procedure linkage
        Here are details on configuring DB2® when remote access of code on z/OS® involves a stored procedure linkage. The linkage is in effect when the calllink element, remoteComType attribute value is STOREDPROCEDURE.
      - How to pass structured records as individual fields
        You can set an EGL property so that a structured record is sent to a called program and received there in any of multiple ways: as a structured record, or as if the record were a set of individual fields that correspond to the leaf elements in that record, or as a sequential set of records and fields. The usage is especially appropriate when EGL-coded logic is interacting with EGL-coded logic that was migrated from code written in the Natural programming language.
      - How to pass structure field arrays
        You can pass a structure field array to a called program. You must follow a special convention in both the call statement and in the parameter list of the called program.
    - 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
      IBM 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 Logging for Java Application
    - 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
    - EGL Unit Testing
    - 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.
  - 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

Using stored procedure linkage to call z/OS® batch from Java™

Whenever you generate Java™ code that does a remote call to z/OS® batch, do as follows:

Configure a linkage options part with the remoteComType set to STOREDPROCEDURE. This will direct the call to the host through the stored procedure so it participates in the transaction.
Configure your build descriptor so that the build descriptor linkage option points to the linkage options part that you created.
Configure the host environment, as described in the next section.

Configuring the host environment

Ensure that the following applications are in use on z/OS®:

DB2® version 7 or higher.
Resource Recovery Services (RRS)
Workload Manager (WLM)

Carry out the following actions on your host system, fulfilling these steps only once:

Create the WLM (Workload manager) (ELADBWLM). For more information, see Workload manager in Configuring DB2® for stored procedure linkage.
Create the DB2® stored procedure (EZESP1CR and EZESP1GR). For more information, see DB2® stored procedure in Configuring DB2® for stored procedure linkage.

Configuring your local workspace for remote debugging

To enable remote debugging, do as follows in your local workspace:

You must have JDBC on the client system. The actual jar files you need depend on the version of JDBC that you are running.
Make sure that you have a functioning default JDBC DB2® connection to the host.
If you access a DB2® database in both the EGL-generated Java™ code and in a called program, ensure that the default JDBC connection is set to NOAUTOCOMMIT.