Rational Programming Patterns for System z

The generation target of a Program, Screen, or Server

By default, the generated COBOL files are stored with the design files, in a folder whose default name can be changed. However you can separate them from the design files inside the generation project, or even change the generation project and folder.

What are the generated files?

Generating a Program or a Screen produces the following files:
  • A .cbl file for Programs and Screens,
  • A map description file for Screens (.bms, .mfs or .map),
  • A .cblpdp metadata file for Programs and Screens, and a .mappdp metadata file for Screen maps.
Important: These files are generated under the name indicated in the COBOL program ID (for Programs) or Program external name (for Screens) of the Definition. The name of the generated file can then differ from the instance name.

Generation target of the generated files

You can separate these files in the project by indicating a generation root path for them. This path will be taken into account only for the instances which have kept their default COBOL folder (folder of the design files) in their Definition tab.

You indicate this path in the properties of the project. These properties are accessed from the Definition tab of the generatable instance or of its Library in the Design Explorer view, or from the properties of the project in the Package Explorer view.

This path is the first level (or levels) of the folders tree for the generated files in the Package Explorer view. In the Definition tab of the generatable instance or of the Library, it is automatically inserted at the beginning of the COBOL folder field. For example, if the COBOL folder is CAN/IBM/PRO and if you indicate a gen root path, the generated files will be stored in gen/CAN/IBM/PRO.

If you indicate a root path after the generation, the generated files will be immediately and automatically moved to the new target.

Generation target of the metadata files

These files are technical files which contain the location of the design file, and information required to process the generated COBOL code. They can be viewed in the Package Explorer view only

You can separate them from the other generated files by indicating a specific root path in the properties of the project. These properties are accessed from the Definition tab of the generatable instance or of its Library in the Design Explorer view, or from the properties of the project in the Package Explorer view.

However you must be very careful because these files are required to re-generate and edit the COBOL code. Moreover, they must be synchronized with the corresponding .cbl files. So, you must always upload or download these files together with their corresponding generated files.

If you indicate a root path after the generation, the metadata files will be immediately and automatically moved to the new target.

Changing the generation target

You can also indicate a generation project and folder different from those of the design files. You can then structure your Rational Programming Patterns for System z projects like Rational® Developer for System z® projects and easily map them to System z.

You can select a project and a folder from the Definition tab of the instance to be generated or of its Library.


Terms of use | Feedback

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