egl.generate

This task generates the specified part using the workspace Generation mode.

Parameters

To specify the Generation mode, you can use either of the following two methods:

Attribute Description Required
project The name of the project that includes the part to be generated. Yes
part The part that is to be generated. The value can be generic. For example, to generate the whole project, set the value to *. To generate all parts within the pkg package, set the value to pkg.*. No, the default is *.
buildDescriptorFile The default build descriptor file to generate the file.
  • For Generate the main part and its associates, yes.
  • For Generate by part, no. If buildDescriptorName is specified, this is required.
buildDescriptorName The build descriptor name in the build descriptor file.
  • For Generate the main part and its associates, yes.
  • For Generate by part, no. If buildDescriptorName is specified, this is required.
bdoption The build descriptor option to override the build descriptor file settings. Multiple values can be set. Valid format is as follows:

{$bdoption1}=value1,
{$bdoption2}=value2

Valid values are:
  • desthost
  • destport
  • destuserid
  • destpassword
  • destdirectory
  • destlibrary
  • gendirectory
  • sqlid
  • sqlpassword
  • sqldb
  • sqljndiname
  • genproject
  • tempDirectory
  • templatedir
  • reservedword
  • projectid
No
symparm A symbolic parameter and the related value. If the value includes a space, embed the value in quotation marks. If multiple symparm entries reference the same symbolic parameter, the last entry is in effect. Valid format is as follows:

{$symparm}=value1,
{$symparm}=value2

No
generationListenerClass String, the Java class name created by the EGL user which responds to events at the generation time.

To create a customized generation listener class, follow these steps:

  1. Create a Fragment project with Eclipse or RBD and set the host plug-in to com.ibm.etools.edt.ant.
  2. Create your generation listener class implements GenerationResultsListener.
  3. Export the plug-in fragment. Right click the project, click Export > Deployable plug-ins and fragments.
  4. Copy the .jar file to the dropins folder of the RBD installation directory.
  5. Restart RBD with the -clean option. Ensure that the listener fragment jar is picked up by RBD.

See Writing Java code to capture details of code generation for all the generation events and how to implement GenerationResultsListener.

No
failOnError Whether or not the build should fail if there is an error. No, the default is true.
verbose If true, show all the logs. If false, only show important logs. No, the default is true.

Feedback