Rational Developer for System z, Version 7.5

Pac Design view

The Pac Design view displays the design elements of the program (Program or Screen) whose code is currently open with the Pattern Driven Programming editor, and selected. It enables you to view and modify the design of a generated program and to generate the program again in order to take these modifications into account.

To see the content of this view, you must have generated a program (batch Program or online Screen). Then, in the Design explorer view of the Design perspective, right-click on the corresponding .cbl file, which contains the generated Cobol, and select Open with > Pdp Cobol System z LPEX Editor in the popup menu. The Cobol editor must remain open and currently selected.
Tip: You must be familiar with the concepts explained in Generating the Pac COBOL and modifying it: the various steps before reading this help.

The Pac Design View of a generated Pac Program

With the Pac Design View, you can add, modify or delete the resources called in the Program design, i.e. the Data Structures called in the -CD Lines and -W Lines tab, as well as the Macros called in the -CP Lines tab. The Pac Design View of a Pac Program looks like this:

You can see that the Pac Design View is constituted of two columns:
  • The Instances column shows a hierarchical tree with the resource types on the first level (input files, output files, input/output files, working files, working data and Macros) and the corresponding instances, down to the Data Elements in imbedded levels,
  • The Additional info column displays useful information on the instances.

The Working data and Macros levels are common to the design of Programs and Screens and are explained further down.

On the other hand, the file categories (input files, output files, input/output files, working files) are specific to the Pac Design View of a generated Program. If you expand one of the file levels, you can see:
  • Data Structures on the first level, with their codes in program in the first column. In the second column you can see their external names in the first position. If the Data Structure is called as an input file, the break level and the synchronization level are also displayed
  • Segments on the second level:
    • If the Segment is called in a composite Data Structure, '00' is indicated in the first column if the Segment does not belong to the principal Data Structure. The other Segments of the composite Data Structure bear no information in the first column.
    • If the Segment is part of a simple Data Structure, its name is displayed in the first column.
    In the second column, you can see the Segment name (if it is not displayed in the first column) and label, separated by a dash.
  • Data Elements on the third level, with their names displayed in the first column and labels displayed in the second column.

If you right-click on a file category, you can add a managed file. Selecting this choice opens a wizard which enables you to select a Data Structure. The selected Data Structure will then be inserted in the currently-selected file type.

If you right-click on one of the files, you can delete it. Moreover, if you right-click on a File-type Data Structure, you can duplicate the file or add a Data Structure to the file. You can also modify the file parameters in a wizard which displays the same information as the '-CD Line Definition' section of the '-CD Lines' tab of the Program.

The Pac Design View of a generated Screen

With the Pac Design View, you can add, modify or delete the resources called in the Screen design, i.e. the instances called in the -CS Lines, -W Lines and -CP Lines tabs. The Pac Design View of a Pac Screen looks like this:

You can see that the Pac Design View is constituted of two columns:
  • The Instances column shows a hierarchical tree with the resource types on the first level Managed files, working data and Macros) and the corresponding instances, down to the Data Elements in imbedded levels,
  • The Additional info column displays useful information on the instances.

The Working data and Macros levels are common to the design of Programs and Screens and are detailed further down.

On the other hand, the Managed files category is specific to the Pac Design View of a generated Screen. Expanding it reveals three subdivisions, which correspond to the three categories of the Screen (Header, Iteration and Footer), according to the information specified in the -CS Lines tab. Each category contains the called Segments.

The first line of the Segment call displays the Segment code in the program (as entered in the Segment code field of the Segment call section of the -CS Lines tab) in the first column, and the External name (as entered in -CS Lines tab) in the second column.

Then, expanding the first call line reveals the Segment name in the Repository and associated label, and, at the finest level, the names and labels of the Data Elements called in the Segment.

Common Information/Actions

The Working data and the Macros categories are common to a generated Program and Screen:
  • The Working data category displays:
    • In the first column, either Data Structures (with their selected Segments and Data Elements), with the code in program of each Data Structure, or Data Elements, at the same level as Data Structures, with the name of each Data Element.
    • In the second column, the COBOL position, line number and label.
    If you right-click on the Working data level, you can either add a working Data Structure or add a Data Element.
    If you right-click on one of the Working data lines, you can modify its call characteristics in a wizard which displays the same information as the:
    • 'Data Structure Call' section of the '-W Lines' tab if you select a Data Structure,
    • 'Data Element Call' section of the '-W Lines' tab if you select a Data Element.
  • The Macros category displays the Macros called in the Program/Screen, with the Macro name in the first column and the Macro label in the second column.

    If you right-click on the Macros category, you can either add a Macro.

    If you right-click on one of the Macro call lines, you can modify its call parameters in a wizard which displays the same information as the 'Macro call' section of the '-CP Lines' tab.

The Pac Design view also contains a toolbar which enables you to:
  • Open the design (open editor icon) of the current Program. This action opens the Program formatted editor, where you can see how the resources are called in the -CD Lines, -W Lines and -CP Lines tabs.
  • Generate the code and trigger the reconciliation (generate code and trigger reconciliation icon) after you have updated the Pac Design view of your Program. The newly-generated code will integrate the changes in the design, while keeping any specific changes entered in the code. This is called the reconciliation. This button can be activated only if the Program design is consistent.
  • Expand all (Expand all icon). This command expands every tree item in the Pac Design view.
  • Collapse all (Collapse all icon) This command collapses every tree item in the Pac Design view.
  • Save (save icon) your updates and all the instances involved in the Program design (the Program, Data Structures, Segments and Macros). You can activate this button, even if the design is inconsistent. Saving the design in the Pac Design view also saves the updates in the instances' editors, if these are open at the time of saving.
    Note: If you modify the Pac Design view, you can save it at any time, even if the design is erroneous, However, you cannot generate the program as long as it is not corrected.
Related tasks
Generating the Pac COBOL and modifying it: the various steps

Terms of use | Feedback

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