Rational Developer for System z

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 regeneration of artifacts without having to remember and reenter inputs to the launchpad and the single-service wizard.
  • It provides 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).

Note: If it is preferred to be 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

Perform the following 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 the input directory).

  2. In the PlatformProperties.xml file, set the default options properties that reflect your target runtime environment.

    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:

    plugins\com.ibm.etools.est.ui_??????????\BatchProcessorSamples\EISService

    Note: The question marks represent a specific version of the plugin. The version number depends on the level of the installation.

    If you use this sample, modify the sample 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. In addition, you can also override certain options specified in the platform properties file.

    Copy the sample file (ServiceSpecification.xml) to your input directory from the following location within the directory where the IBM Rational Developer for System z is installed. Rename the file as desired:

    plugins\com.ibm.etools.est.ui_??????????\BatchProcessorSamples\EISService

    Note: The question marks represent a specific version of the plugin. The version number depends on the level of the installation.

    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. In addition, you can also specify the locations of platform properties files and files that control options for generating individual sets of converters and service definitions.

    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. Rename the file as desired:

    plugins\com.ibm.etools.est.ui_??????????\BatchProcessorSamples\EISService

    Note: The question marks represent a specific version of the plugin. The version number depends on the level of the installation.

    Open the resulting file with a text editor (or a specialized XML editor), perform the following:

    1. Set the appropriate PlatformProperties.xml file
    2. For EACH individual set of converter and service definition generation options (ServiceSpecification.xml) files, created in the previous step, a GenerationSpec element that references the file that was created.
After creating the options files, 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)