EGL Reference Guide for iSeries
To generate output in the Workbench, do the following:
- Load parts to generate, along with any parts that are referenced during
generation.
- Select parts to generate. If you invoke the generation process for
a file, folder, package, or project, EGL creates output for every primary
part (every program, page handler, form group, data table, or library)
that is in the container you selected.
- Initiate generation.
- Monitor progress.
To make generation easier, it is recommended that you first select a
default build descriptor from these types:
- Debug build descriptor (as appropriate when you are using the EGL
debugger)
- Target system build descriptor (as used for generating parts and deploying
them in a run-time environment)
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:
- As a property at the file, folder, package, and project level
- As a Workbench preference
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:
- A property that is specific to the file takes precedence over all others
- The related folder property takes precedence over the package, project, or
Workbench property
- The related package property takes precedence over the project or
Workbench property
- The related project property takes precedence over the Workbench property
- The Workbench property is used if no others are specified
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 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:
- Right-click on a resource name (project, folder, or file) in the Project
Navigator.
- Select the Generate With Wizard...
option.
The generation wizard includes four pages:
- 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.
- 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:
- Choose from a drop-down list of all the build descriptors that are in the
workspace, and use that build descriptor to generate all of the parts.
- Select a build descriptor for each of the parts selected on the first
page. You use a table to select the build descriptors for each
part. The first column of the table displays the part names; the
second column displays a drop-down list of build descriptors for each
part.
- 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.
- 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:
- Select the Create a Command File checkbox
- 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
- 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
- Select a radio button to indicate whether to avoid generating output when
creating the command file
- Click Finish.
To generate in the workbench using the generation menu item, do one of the
following sets of steps:
- 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.
- Right-click, then select the Generate menu option.
or
- Double-click on a resource name (project, folder, or file) in the Project
Navigator. The file opens in the EGL editor.
- 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)
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 ]
(C) Copyright IBM Corporation 1992, 2005. All Rights Reserved.