Rational Programming Patterns for System z

New Program wizard

Enter the fields of this wizard to create a Program or the derived instance of a Program.

Project
Select a project in the list or enter the name of the project in which the instances are to be saved.

A project represents the physical distribution of your instances in your workspace. It groups directories and files. It is used to organize resources which can be built, shared, or stored as a version.

A Pacbase project contains a subset of files which correspond to the models and the generated sources which make up an application.

There can be various projects for each location (a location is the equivalent of a database).

Package
Select a package in the list or enter the name of a new package.

A package corresponds to a logical group of information.

The logical resources contained in a package can be distributed into various projects.

The packages represent the branches of the projects. Each package contains its own instances.

For the resources transferred from Pacbase, the naming convention of a package is: {location name}.{Library path}.{Library name}. To reflect the Library hierarchy, you can enter the Library names (starting from the highest-level Library), and separate each with a period (example: COM.CIF). This way, there will be a first-level branch (COM) with its instances, and a second-level branch (CIF) with its own instances.

Name
Enter the name here. Its maximum length is six characters. It must be constituted of alphabetic or numeric characters only.

If the Derive box is checked, you can use the whole length of the edit field. The name of the derived instance can start with the name of its reference instance. If you have selected a Design derivation, the name can also include the generation Library. If you do not enter a name and specify a reference instance in the Program to derive field, the name is automatically initialized with the name of the reference instance.

Generation parameters
Generation parameters are specified in Libraries. These parameters are related to the adaptation to the operating system in use.

You select the Library by clicking Browse.

Label
Enter the label, which identifies the new instance. It constitutes a search criterion for a subsequent search.
Open editor on finish
Check this box if you want the editor of the instance you are creating to open up automatically. The editor opens up on the Overview tab. From there, you can access the other tabs to specify all the characteristics of the instance.
Derive
Check this box if you want to create a derived instance which points to a reference instance. The derived instance contains a link to the reference instance and possibly a link to a generation Library. From the derived instance, you can generate the reference instance without duplicating its design. If you check this box, two fields are displayed:
  • Derivation type. Depending on the entity, there can be one or two derivation types:
    • Design derivation is available on Programs, Dialogs/Screens, Server Dialogs/Servers, Data Structures (for the generation of the Copybooks). With this derivation type, you use the derived instance to generate the reference instance from a different Library, without duplicating its design. The generation parameters of the Library indicated in the derived instance produce a COBOL source different from the source generated from the Library of the reference instance.
    • Code derivation is available on entities which can contain specific code: Programs, Screens, and Servers. With this derivation type, you use the derived instance to generate the reference Program, Screen, or Server. The complete source code (the generated code and the specific code) of the reference instance becomes the generated code in the derived instance. Moreover this generated code is reconciled with the specific code of the derived instance. In turn, the derived instance can also become the reference instance for a new derived instance and the same process applies.
  • <Entity> to derive. In the wizard, <Entity> can be Program, Screen, Data Structure or Dialog. You select the reference instance, which contains the design and, possibly, the specific code needed by the derived instance

Terms of use | Feedback

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