The Generation Manager
The generation manager lists all the instances that must be generated again in the location. A pdp file must exist for all of them. The generation manager indicates all the files whose code is desynchronized with the design of the instance itself or of an instance that is involved in its generation. You must use it to request a multiple or global regeneration of the desynchronized files in the local workspace. To limit the number of the required regenerations, you can force the resynchronization between the design and the generated code for non-functional design modifications.
To display this view, select
.
A file is considered desynchronized when the design modifications that are responsible for this desynchronization are saved.
If a file is generated with the generation process implemented from Rational® Programming Patterns version 9.6.1, some design modifications are not considered meaningful and do not cause any desynchronization. Such is the case, for example, for the modifications in the -GC Lines or the Keywords.
Content of the table
- Design displays all the instances to be generated again in the opened location. These are the instances of the generatable entities such as Programs, Screens, Copybooks, or Error Messages. The instances are displayed with their extensions. The extensions of all the entities are listed in Icons, extensions, and generation patterns of entities.
- Generation product displays the generated files of the instances that are displayed in the Design column. Several files can be generated for one instance. For example, the COBOL file and the map file are generated for a Screen. The extensions of the generated files according to the entities are documented in the embedded help pages of Starting the various generation types.
- Pattern displays the pattern that was used for each generation. For the list of all the generation patterns, see Icons, extensions, and generation patterns of entities.
- Modified design displays the instances whose design was modified. These
instances are the generatable instances themselves, or instances that are called in generatable
instances.
If several modifications were brought to the same design, only one line is displayed for the first modification. The number of additional modifications is displayed between parentheses. The tooltip that is associated with the column displays the first 10 modifications.
- Status displays To regenerate if the instance of
the Design column must be generated again. So, if a design that is used in
the generation of an instance was modified, all the instances that use this modified design are
marked as to be regenerated.
However, you can limit the number of the required regenerations by forcing the resynchronization between the design and the generated code for non-functional design modifications. See Resynchronization management. In this case, the Status column displays the work item that contain the non-functional modifications.
- Error in design indicates whether the instance that is displayed in the Design column contains an error. If so, it cannot be generated again.
You can select multiple lines. You can also select all the lines with Ctrl + A. The number of the selected lines is indicated.
With the contextual menu, you can open the design or the COBOL editor of the instance, or generate the instance again. If you select more than one line, you can then start a multiple regeneration.
Forcing the resynchronization
You can force the resynchronization between the design and the generated code for non-functional design modifications that have an impact on the generated code. Then, the impacted generated files are not marked as to be generated again.
Click in the toolbar to specify a resynchronization request. See the explanations in Resynchronization management.
Sorting the table
You can sort the columns in the ascending or descending order of their line values by clicking the arrow in the header of each column. You can also click the triangle (View menu) in the view toolbar and select Sort by. You can specify a sort order for each column. For example, the first column can be sorted in an ascending order while the second column is sorted in a descending order. When the same value is displayed on several lines, the column is sorted on the previous columns.
Displaying the short labels in the table
By default, the long labels are displayed in all the columns.
You can display the short labels in the Design, Generation product, Pattern, and Modified design columns. To do so, click the triangle (View menu) in the view toolbar and select Display the short labels. The list of the four columns is displayed. By default, none of the columns is preceded by a check mark, which indicates that they do not display the short labels. Click a column to select it. It will then display the short labels. If you click the column again to remove its check mark, it will then display the long labels again.
If you choose to display the short labels, the location and the project hierarchy are not displayed in the first three columns. In the Pattern column, only the pattern name is displayed.
Filtering the table
You can filter the display of the lines in the table by entering a character string in the filter text input field that is located before the table. Only the lines where a column contains the filter text are displayed.
By default, the filter applies to the content of all the columns. However, you can limit the filter scope to some columns. To do so, click the triangle (View menu) in the view toolbar and select Filter scope. All the columns are listed. The columns that are preceded by a check mark are included in the filter scope. Click a column to clear its check mark. It will then be excluded from the filter scope. If you click the column again, it will be included in the filter scope again.
The filter applies to all the content of the Modified design column. It even applies to the content that is displayed in the tooltip or that is not visible because it is beyond the 10th modification.
If the columns display the long labels, the slashes that are included in the labels act as word separators. The filter then applies individually to all the words of the labels.
When you start typing in the filter field, a button becomes available. Clicking it clears the field and restores the list as it was initially displayed.
Exporting the result in a CSV format
You can export the data that is displayed in the Generation Manager view
by clicking in the toolbar. In the export wizard, you must select a file with a
.CSV extension. Then, if you click Next, you can select
the data to be exported. The data is then exported in a CSV format that can be
used in a spreadsheet program.
The lines of the .CSV document are sorted according to the sort order of the view. All the lines are included in the document, even the lines that are displayed in the tooltip or that are not visible because they are beyond the 10th modification. All the lines are also included in the document, even if the result that is displayed in the view is partial because a filter is applied.