Rational Developer for System z

Flow mode: Outline view and Properties view

When the Terminal tab in the host editor is selected, and the host editor is in flow mode, and a flow file is loaded or has been recorded then: (a) you can use the Outline view in the host editor to view names of the nodes in the flow, to view mapping routines their mappings, and to delete mappings from mapping routines; and (b) you can use the Properties view to view the properties of the items in the Outline view.
This topic contains the following subtopics:

Outline view

When flow recording is not in progress, the host editor displays in the Outline view a hierarchical tree containing icons that correspond to the nodes in the flow. The nodes are displayed in the order in which they were added to the flow, whether they were added during flow recording or in the flow editor.

You can use the Outline view to view mapping routines and mappings in Assign nodes and Invoke screen operations nodes.

(a) Assign nodes:

Table 1 shows the operations that you can perform on mappings in Assign nodes:
Table 1. Assign nodes -- operations in the Outline view
Operation: Steps: Result:
View the mappings contained in the mapping routine for the Assign node. Expand the Assign node. The mappings in the mapping routine of the Assign node are displayed under the Assign node in the hierarchical tree.
View the properties of a mapping. Select the mapping. The properties are displayed in the Properties view.
Remove a mapping
  1. Right-click the mapping.
  2. Select Remove mapping.
The mapping is deleted from the mapping routine.

Recall that an Assign node has associated with it a mapping routine that can contain one or mappings (see Assign, Switch, and While nodes). For each mapping in the Assign node the host editor displays in the Outline view the name or names of the source fields and the name of the target field. The names of the messages in which the source and target fields are located are not displayed. If there are multiple source fields then they are displayed in a comma-separated list.

(b) Invoke screen operation nodes:

Table 2 shows the operations that you can perform on mapping routines and mappings in Invoke screen operation nodes:
Table 2. Invoke screen operation nodes -- operations in the Outline view
Operation: Steps: Result:
View the mapping routines associated with the input and output terminals of the Invoke screen operation node. Expand the Invoke screen operation node. The mapping routines are displayed underneath the Invoke screen operations node in the hierarchical tree.
View the mappings in a mapping routine. Expand the terminal. The mappings are displayed underneath the mapping routine in the hierarchical tree.
View the properties of a mapping. Select the mapping. The properties are displayed in the Properties view.
Remove a mapping
  1. Right-click the mapping.
  2. Select Remove mapping.
The mapping is deleted from the mapping routine.

Recall that an Invoke screen operation node has one input terminal, one or more output terminals for valid branches to other Invoke screen operation nodes, and one output terminal for the situation in which no screen is recognized (see Invoke nodes in the flow editor). (An input terminal or an output terminal is named after the screen message on which it performs its operations.)

Each terminal has a mapping routine associated with it. Typically the mapping routine for an input terminal contains one or more mappings that are created for an AID Key action, for an Input action, and possibly for one or more Insert actions. Actions are displayed in an input terminal of an Invoke screen operation node as follows:
  • For an AID Key action the name of the AID Key and the cursor position are displayed.
  • For a Input action the input text and the name of the input field are displayed.
  • For an Insert action or an Extract action the name of the source field and the name of the target field are displayed.
The mapping routine for an output terminal can contain one or more mappings that are created for Extract actions (see Overview of the actions). Extract actions are displayed in an output terminal of an Invoke screen operation node as follows:
  • For an Extract action the name of the source field and the name of the target field are displayed

The names of the messages in which the source or target fields are located are not displayed, only the names of the fields (see Overview of the actions).

Outline view: Flow recording in progress

This subtopic describes two additional considerations in the Outline view that arise when flow recording is in progress: (a) the Actions in Progress node; and (b) r emoving an Insert action or an Extract action during flow recording.

(a) Actions in Progress node:

When you are recording a flow, and you create a Input action (that is, you type input) or you create an Insert action, then in the hierarchical tree in the Outline view the host editor does not immediately display the mapping for the new action in the usual location (under the node representing the input terminal of the current Invoke screen operation node).

Instead, the host editor opens the Actions in Progress node at the end of the hierarchical tree in the Outline view and displays in it the mapping for the new Input action or the new Insert action.

The host editor treats the mapping or mappings in the Actions in Progress node as follows:

  • If you press an AID key, then the host editor moves the mappings into the mapping routine for the input terminal and closes the Actions in Progress node.

  • If you stop recording the flow without having pressed an AID key, then the host editor discards the mappings in the Actions in Progress node before stopping the flow recording.

(b) Removing an Insert action or an Extract action during flow recording:

The capability of removing a mapping from a mapping routine associated with an Assign node (see (a) Assign nodes) or removing a mapping from a mapping routine associated with a terminal of an Invoke screen operation node (see (b) Invoke screen operation nodes) is enabled even when you are recording a flow.

This capability is extremely useful during flow recording if you have just recorded an Extract action or an Insert action that you want to remove or replace (for example, if by accident you created an Extract action or an Insert action for the wrong field).

If you are still recording the flow and if you are still displaying the same application screen for which you created the Extract action or the Insert action (you have not navigated to a different application screen), then you can follow the steps described in the following troubleshooting topics to remove the Extract action or Insert action:

Properties view

If you select a mapping in the Outline view, then the host editor displays in the Properties view the properties of the currently selected mapping.


Terms of use | Feedback

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