Rational Programming Patterns

Sections tab

In this tab, you enter the Text content, which is structured in sections. You can assign the Text to instances of other entities to document them. You can also reference Data Elements or other Text instances.

This tab is constituted of the following elements:

You must save the Text instance to take into account the modifications.

You can carry out the following actions:
  • You can modify or create a section code. Select a section line or click Add section. The Sections category opens. Enter the new section code in the Section code field. This code must be on 2 characters. It is recommended to use letters or digits only.

    If you click More, you can see the section content through an interface that is similar to the Pacbase textual interface.

  • You can modify the content of a line or create a line that is part of a section. You can also associate a line with a Data Element. To carry out these actions, you must first expand the section.
    • To modify the content of a line, select the line in the tree. The Section lines category opens. Modify the line content in the Line text field.
    • To create a line, set the cursor at the insertion point in the tree and click Add line. The Section lines category opens.
      1. Select the Line type. A title line is required at the beginning of each section. To enter a simple text line, select the Update by substitution type.
        Note: Do not select a line type I, J, B, E, or Y. These line types are created when you add assignment lines or references to a Text.
      2. Enter the line content in the Line text field.
  • You can associate a line with a Data Element because a Text that describes an application often refers to individual Data Elements. These Data Elements are not necessarily defined.
    • If the Data Element is defined in the current network, click Data Element in the Section lines category, then click Change. Select a Data Element and click OK. The Data Element is displayed as a link. You can click it to open its editor.
    • If the Data Element is not defined in the current network, click Undefined Data Element in the Section lines category, then click Change. Enter the Name field. You can also indicate an Output format. Select Blank when zero to generate the BLANK WHEN ZERO COBOL clause for the numeric Data Elements that are retrieved from old versions. Click OK. The undefined Data Element is displayed but you cannot open its editor.
    The Data Element that is associated with the line is also displayed on the tree line, between square brackets.
  • You can specify assignment lines to assign a Text section or section part to instances of other entities. To do so, click Add assignment line. Text assignment starts at the beginning of the section that contains an I or a B type line. It ends implicitly at the end of the last section, or explicitly after a J or E type line.
    You can indicate an assignment line on two types of entity instances:
    • Instances that are defined in the current network by clicking Add an entity. Select one of the instances that are displayed in the selection box and click OK. This instance is displayed as a link. You can click it to open its editor.
    • Instances that are not defined in the current network (available from Rational Programming Patterns V9.0.1) by clicking Add an undefined instance. In the dialog box that opens, you must select the entity and enter the name of the instance that is the target of the assignment. The package name is optional. If the assignment targets a User Entity, you must indicate the name of its Meta Entity. Click OK. The undefined instance is displayed as an unresolved link.
    The entity instances that are the targets of the section are also displayed on the assignment line in the tree.

    You can remove an assignment to a defined or undefined instance. Select it in the Section referenced text lines and click the Remove button that is on the same line.

    Note: The instances of the Pacbase entities that are not managed in Rational Programming Patterns are displayed as unknown references at the end of the Section referenced text lines. You can select them and remove them by clicking the Remove button that is on the same line.
  • You can reference another Text or section by clicking Add reference to a Text. A dialog box opens then:
    • You can select a Text that is defined in the current network. Click Selection and select one of the Texts in the list. You can also select one of its sections. Click OK. The Text is displayed as a link in the Assigned Text field. You can click it to open its editor. The section is displayed in the Section field. If you click More, you can select another section.
    • You can also indicate a Text that is not defined in the current network (available from Rational Programming Patterns V9.0.1. Click Add an undefined instance. Enter the name of a Text. The package name is optional. Click OK. The Text is displayed in the Assigned Text field as an unresolved link
    The referenced Text is also displayed on the reference line in the tree.

    In the Section referenced text lines, you can click the Change button to change the reference to another defined Text. You can click Remove to remove the displayed reference.


Terms of use | Feedback

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