Rational Developer for System z, Version 7.6

Creating and populating generation properties files

This topic describes how to create generation properties files to use with the batch processor.
Using generation properties files and the batch processor has the following advantages over using the graphical user interface:
  • It allows you to regenerate artifacts without having to remember and reenter inputs to the launchpad and the single-service wizard.
  • It provides you with a record of the options that were specified when the artifacts were generated.

Creating generation properties files with the single-service wizards

To create these generation properties files using a single-service wizard:

  1. Start the Enterprise Service Tools Wizard Launchpad from a type of project other than a single-service project (see Starting the launchpad from a type of project other than a single-service project).

  2. On the launchpad, select Save generation properties (see Save generation properties).

  3. Start the wizard for the development scenario for which you want to create generation properties files.

  4. Work through the pages of the wizard, selecting for each option the value that you want to be specified in the properties file for the batch processor.

  5. On the File, data set, or member selection page, on the Properties tab, specify the path and names that you want to use for the three generation properties output files (see Properties tab).

  6. Click Finish when you are ready to close the wizard.

    The wizard does it processing as usual and also creates the three generation properties files.

  7. Run the batch processor using the three generation properties files that the wizard created (see Starting the batch processor).

If you are interested mainly in being able to regenerate the web service artifacts without having to reenter the launchpad and wizard inputs, The Enterprise Service Tools perspective provides a convenient way to take advantage of the generated properties files. The properties are kept in a runtime-specific project and are used to populate the single-service wizard when regeneration is desired. The projects allow iterative development, since it is possible to make a change to a single option, without having to reenter the rest.

Creating the generation properties files manually using the samples

Follow these steps to create the environment and populate the options in the properties files for the batch processor:

  1. Create a directory to hold the batch processor input files. The remaining steps refer to this directory as your input directory.

  2. In the PlatformProperties.xml file, set the default options properties that reflect your target runtime environment.
    You can copy the sample file (PlatformProperties.xml) to your input directory from the following location within the directory where the IBM® Rational® Developer for System z® is installed:

    wdz\wstools\eclipse\plugins\com.ibm.etools.xmlent.batch_7.0.0\Samples

    If you use this sample, modify it with a text editor (or a specialized XML editor) to suit your purpose.
  3. In the ServiceSpecification.xml file, put the options properties for generating the specific sets of converters and service definitions. You can also override certain options specified in the platform properties file.
    You can copy the sample file to your input directory from the following location within the directory where the IBM Rational Developer for System z is installed and rename the file as desired:

    wdz\wstools\eclipse\plugins\com.ibm.etools.xmlent.batch_7.0.0\Samples

    You can then edit the new file with a text editor (or a specialized XML editor) and set the options.
  4. In the Container.xml file, specify the options that globally affect the generation of converters and of service definitions. You can also specify the locations of platform properties files and files that control options for generating individual sets of converters and service definitions.
    You can copy the sample file Container.xml to your input directory from the following location within the directory where the IBM Rational Developer for System z is installed and rename the file as desired:

    wdz\wstools\eclipse\plugins\com.ibm.etools.xmlent.batch_7.0.0\Samples

    Open the resulting file with a text editor (or a specialized XML editor) and set the appropriate PlatformProperties.xml and, for each individual set of converter and service definition generation options (ServiceSpecification.xml) files that you created in the previous step, add a GenerationSpec element that references the file that you created.
When you have finished creating your options files, you can start the batch processor.

Related concepts

Batch processor

Related tasks

Starting the batch processor

Related references

Container.xml
PlatformProperties.xml
ServiceSpecification.xml


Terms of use | Feedback

This information center is powered by Eclipse technology. (http://www.eclipse.org)