EGL Reference Guide for iSeries

EGLSDK

The command EGLSDK gives you access to the EGL Software Development Kit (EGL SDK), as described in Generation from the EGL SDK.

Syntax

The syntax for invoking EGLSDK is as follows:



EGLSDK syntax diagram: java EGLSDK file_name [parameters ...]

generate
Indicates that the command itself references the EGL file and build descriptor part that are used to generate output. In this case, the command EGLSDK does not reference a command file.
cmdFile
Specifies the absolute or relative path of the file described in EGL command file. Relative paths are relative to the directory in which you run the command.

Embed the path in double quotes.

-eglpath eglpath
As described in eglpath, the eglpath option identifies directories to search when EGL uses an import statement to resolve the name of a part. You specify a quoted string that has one or more directory names, each separated from the next by a semicolon.
-generateFile genFile
The absolute or relative path of the EGL file that contains the part you want to process. Relative paths are relative to the directory in which you run the command.

Embed the path in double quotes.

-buildDescriptorFile bdFile
The absolute or relative path of the build file that contains the build descriptor. Relative paths are relative to the directory in which you run the command.

Embed the path in double quotes.

-buildDescriptorName bdName
The name of a build descriptor part that guides generation. The build descriptor must be at the top level of an EGL build (.eglbld) file.
-sqlID sqlID
Sets the value of build descriptor option sqlID.
-sqlPassword sqlPW
Sets the value of build descriptor option sqlPassword.
-destUserid destID
Sets the value of build descriptor option destUserID.
-destPassword destPW
Sets the value of build descriptor option destPassword.

The eglpath value that you specify when invoking the command EGLSDK takes precedence over any eglpath value in an EGL command file. Similarly, build descriptor options that you specify when invoking the command take precedence over options in any build descriptor that is listed in an EGL command file.

Examples

In the commands that follow, each multiline example belongs on a single line:

java EGLSDK "commandfile.xml"
 
java EGLSDK "commandfile.xml"
    -eglpath "c:\myGroup;h:\myCorp"
 
java EGLSDK generate 
    -eglpath "c:\myGroup;h:\myCorp"
    -generateFile "c:\myProg.eglpgm"
    -buildDescriptorFile "c:\myBuild.eglbld"
    -buildDescriptorName myBuildDescriptor
 
java EGLSDK "myCommand.xml"
    -sqlID myID -sqlPassword myPW
    -destUserID myUserID -destPassword myPass


Related concepts
Build descriptor part
Generation from the EGL SDK
Import
Master build descriptor


Related tasks
Generating from the EGL SDK


Related reference
destPassword
destUserID
EGL build path and eglpath
sqlID
sqlPassword
Syntax diagram

Format of eglmaster.properties file

The eglmaster.properties file is a Java properties file that the EGL SDK uses to specify the name and file path name of the master build descriptor. This properties file must be contained in a directory that is specified in the CLASSPATH variable of the process that invokes the EGLSDK command. The format of the eglmaster.properties file is as follows:

masterBuildDescriptorName=desc
masterBuildDescriptorFile=path

where:

desc
The name of the master build descriptor
path
The fully qualified path name of the EGL file in which the master build descriptor used by the EGL SDK is declared

The content of this file must follow the rules of a Java properties file. You can use either a slash (/) or two backslashes (\\) to separate file names within a path name.

You must specify both the masterBuildDescriptorName and masterBuildDescriptorFile keywords in the properties file. Otherwise the eglmaster.properties file is ignored.

Following is an example of the contents of an eglmaster.properties file:

# Specify the name of the master build descriptor:
masterBuildDescriptorName=MYBUILDDESCRIPTOR
# Specify the file that contains the master build descriptor:
masterBuildDescriptorFile=d:/egl/builddescriptors/master.egl


Related concepts
Master build descriptor


Related tasks
Choosing options for COBOL generation
Choosing options for Java generation


Related reference
Build descriptor options
EGLSDK
Format of master build descriptor plugin.xml file


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