The System z® LPEX
Editor and COBOL Editor in IBM® Rational® Developer for System z provide
a variety of ways to navigate to and from data items.
About this task
You can navigate to and from data items as follows:
Procedure
- To navigate in a COBOL program from a data item reference
in the PROCEDURE division to the data item declaration in the DATA
division, perform one of the following actions:
- Position the text cursor on the data item reference, and press
the F3 key.
- Hold down the Ctrl key, position the text cursor on the data
item reference, and click.
- Right-click the data item reference, and select Open
Declaration.
In the COBOL Editor, if the declaration is located in the same
file as the reference, the editor navigates to the declaration in
the same editor. If the declaration is in a collapsed region, the
region is expanded. If the reference is in another file and the location
of the file can be determined, the source file is opened in a new
instance of the editor.
- To jump to the editor location of your most recent text
change, use the Last Edit Location (Ctrl+Q)
action. This action available for the COBOL Editor only.
- To jump to the location of the next or previous Division,
Section, or Paragraph. use the Go To Next Element (Ctrl+Shift+Down)
and Go To Previous Element (Ctrl+Shift+Up)
actions. This action available for the COBOL Editor only.
- To list all the occurrences of the selected language element
in the Search view, use the Occurrences in Compilation
Unit (Ctrl+Shift+U) action. Then you can use the Next (Ctrl+.)
and Previous (Ctrl+,) actions to jump to the
location of the next or previous occurrences. To return the focus
to the editor, press Enter.
- When you use another view, such as the Outline, Search,
or Perform Hierarchy views, a navigation history entry is created.
To jump to the previous editor locations visited by these navigation
commands, use the Backward History (Alt+Left)
and Forward History (Alt+Right) actions. You
can also use the left arrow (
) icon to go back
to a previous location and the right arrow (
) icon to move forward. These icons are located in the menu
bar.
- To navigate the annotations in the editor, use the Next
Annotation (Ctrl+.) and Previous Annotation (Ctrl+,)
actions. The types of annotations visited by these actions can be
configured using the Annotations page. To access
this preference click or use the drop down
menu for the buttons on the toolbar. This action available
for the COBOL Editor only.
- To navigate to the declaration of a language element, use
the Open Declaration (F3) action. The action
is also available in the editor context menu, or as a hyperlink.
- To open the copybook file referenced in a Copy Statement,
use the Open Copybook action. The action is
available in the editor context menu, or as a hyperlink.
- To open a program referenced in a CALL, EXEC CICS LINK,
or EXEC CICS XCTL Statement, use the Open Program action
. The name of the program or file available to be opened is determined
statically.
- If the name of the procedure of file can not be determined statically,
then these actions will not be available.
- If the program is located within the same compilation unit, you
can navigate to the program using the Open Program action.
Otherwise, you can use the Open File action
to search for and open a file. The action is available in the editor
context menu, or as a hyperlink.