Rational Programming Patterns for System z

New Data Structure wizard

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

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.

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).

Name
Its maximum length is two 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 Data Structure to derive field, the name is automatically initialized with the name of the reference instance.

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)