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 where the instance is 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 that can be built, shared, or versioned.
A Rational® Programming Patterns project contains a subset of files that correspond to the design and the generated sources of an application.
- Name
- Enter the Program name in this field. Its maximum length is 6 characters. It must be constituted
of alphabetic or numeric characters only.
If Create a derived entity is selected, you must enter the name of the derived instance. Its length is controlled against the entity type. For example, the name of the derived instance of a Program is limited to 6 characters. If you do not enter a name, if you select Create a derived entity, and if you specify a reference instance in <Entity> to derive, the name is automatically initialized with the name of the reference instance. An error message informs that the instance already exists. So, you must overwrite the name of the reference instance with a new name that conforms to the maximum length of the selected entity.
- Generation parameters
- Generation parameters are specified in Libraries. These parameters
are related to the adaptation to the operating system in use.
Click Browse. In the selection wizard that opens, select a Library. You can also create a Library by clicking New Library.
- Label
- Enter the label that identifies the instance. It will constitute a search criterion upon a subsequent search.
- Open editor on finish
- Select this check box if you want to open the editor of the instance you are creating. The editor opens on the Overview tab. From there, you can access the other tabs to specify all the characteristics of the instance.
- Create a derived entity
- Select this check box if you want to create a derived entity instance
that points to a reference instance. The derived instance contains
a link to the reference instance and a link to a Library that contains
the generation parameters. From the derived instance, you can generate
the reference instance from a different Library, without duplicating
its design. The generation parameters of the derived instance Library
produce a COBOL source that is different from the source that is generated
from the reference instance Library.
If you select this box, the <Entity> to derive field is displayed. In the wizard, <Entity> is replaced by the actual entity (such as Program, Screen, or Data Structure). You must select the reference instance that contains the design for the derived instance.