EGL Reference Guide for iSeries

Generation in the workbench

To generate output in the Workbench, do the following:

To make generation easier, it is recommended that you first select a default build descriptor from these types:

For details on how to select a default build descriptor, see Setting the default build descriptors.

You can identify each of two build descriptors (debug and target system) in these ways:

A lower-level build descriptor of a particular kind takes precedence over any higher-level build descriptor of the same kind. For example, a target system build descriptor that was assigned to the current package takes precedence over a target system build descriptor that was assigned to the project. However, a master build descriptor takes precedence over all others, as described in Build descriptor part.

The following precedence rules are in effect for every file that contains a primary part:

For details on initiating generation, see Generating in the workbench.


Related concepts
Build descriptor part
Development process
Generated output


Related tasks
Generating in the workbench
Setting the default build descriptors


Related reference
Generated output (reference)

Generating in the workbench

Generating in the workbench is accomplished with either the generation wizard or the generation menu item. When you select the generation menu item, EGL uses the default build descriptor. If you have not selected a default build descriptor, use the generation wizard. For details on selecting the default build descriptor, see Setting the default build descriptors.

To generate in the workbench by invoking the generation wizard, do as follows:

  1. Right-click on a resource name (project, folder, or file) in the Project Navigator.
  2. Select the Generate With Wizard... option.

The generation wizard includes four pages:

  1. The first page displays a list of parts to generate based on the selection that the user made to start the generation process. You must select at least one part from the list before you can continue to the next page. The interface provides buttons to let you select or deselect all of the parts in the list.
  2. The second page lets you choose a build descriptor or build descriptors to be used to generate the parts selected on the first page. You have two options:
  3. The third page lets you set user IDs and passwords for both the destination machine and the SQL database used in the generation process, if IDs and passwords are necessary. These user IDs and passwords, if any, override the ones listed in the specified build descriptor for each part being generated. You may want to set user IDs and passwords on this page rather than the build descriptor to avoid keeping sensitive information in persistent storage.
  4. The fourth page lets you create a command file that you can use for generating an EGL program outside of the workbench. You can reference the command file in the workbench batch interface (by using the command EGLCMD) or in the EGL SDK (by using the command EGLSDK).

    To create a command file, do as follows:

    1. Select the Create a Command File checkbox
    2. Specify the name of the output file, either by typing the fully qualified path or by clicking Browse and using the standard Windows procedure for selecting a file
    3. Select or clear the Automatically Insert EGL Path (eglpath) check box to specify whether you want to include the EGL project path in the command file, as the initial value for eglpath; for details, see EGL command file
    4. Select a radio button to indicate whether to avoid generating output when creating the command file
  5. Click Finish.

To generate in the workbench using the generation menu item, do one of the following sets of steps:

  1. Select one or more resource names (project, folder, or file) in the Project Navigator. To select multiple resource names, hold down the Ctrl key as you click.
  2. Right-click, then select the Generate menu option.

or

  1. Double-click on a resource name (project, folder, or file) in the Project Navigator. The file opens in the EGL editor.
  2. Right-click inside the editor pane, then select Generate.


Related concepts
Generation in the workbench


Related tasks
Setting the default build descriptors


Related reference
EGLCMD
EGLSDK
Generated output (reference)

Generation Results view

The Generation Results view shows you code-preparation messages that are the result of generation performed in the workbench. These messages may be errors, warnings, or informational messages. This view is available only when generating from the Workbench. The format is as follows:

msgid message
msgid
Is the message identifier. For example, IWN.VAL.4610.e is the message ID for Enterprise Developer validation error number 4610.
message
Is the text of the message.

Generation results are displayed in the view by primary part (program, page handler, form group, data table, library), with a different tab for each part. The results can be a combination of validation results and generation results.

You can open this view at any time, but it displays data only after you generate output.


Related concepts
Development process
Generated output
Generation


Related reference
Generated output (reference)


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]