An EGL build file (extension .eglbld) contains any number of build
parts and is written in Extensible Markup Language (XML). The build
file has a specific format; see EGL build file format.
When you create a new EGL project, EGL Web project, or EGL Plug-in
project in the workbench, the New Project wizards provide an option
to "Create new project build descriptor(s) automatically." This default
option does the following:
- Creates the basic Build Descriptor parts you need to generate
code based on whether you select Java™ or
COBOL under "Target Runtime Platform". However, in most cases you
must modify the Build Descriptor parts according to your particular
needs. For example, you might need to set the system build
descriptor option to specify the ZOSBATCH runtime environment.
- Sets the Debug build descriptor and Target
system build descriptor properties in the EGL
Default Build Descriptor category of the project properties.
You can review or change the default build descriptors as described
in Setting the default build descriptors. In addition,
if you use the menu option Generate With Wizard when
you generate your parts, you have the opportunity to override the
default build descriptor.
If you do not select the option to
Create new project
build descriptor(s) automatically, you can create your
own build file manually or specify your default build descriptors
manually at a later time.
Note: EGL build parts are written in XML. Therefore, you have the
choice of using the graphical EGL Build Parts Editor, or using a text
editor to edit the XML.
To create a build file manually, follow these steps:
- Identify a project or folder to contain the file. You must create
a project or folder if you do not already have one. The project should
be an EGL project, EGL Web project or EGL Plug-in project.
- In the workbench, click .
- Select the project or folder that will contain the EGL build file.
In the File name field, type the name of the
EGL build file, for example MyEGLbuildParts.
The extension .eglbld is required for the
file name. An extension is automatically appended to the end of the
file name if no extension is specified; if the extension is invalid
an error message is generated and the file is not created.
- Click Finish to create the build file with
no EGL build part declaration. The build file appears in the Project
Explorer view and automatically opens in the EGL Build Parts Editor.
- To add an EGL build part before creating the build file, click Next.
Select the type of build part to add, then click Next.
Type a name and a description for the build part, then click Finish.
The build file appears in the Project Explorer view and automatically
opens in the EGL Build Parts Editor.