The System z® LPEX
Editor, PL/I Editor, and PL/I Compare Editor provide a variety of
ways to navigate to and from variable declarations, even when a variable
is declared in a different file.
About this task
To enable the
Open Declaration and
hyperlink functions for PL/I source files, you need to enable Annotations
and Tooling. See the related links for more information.
Procedure
To navigate to and from variable declarations:
- To navigate in a PL/I program from a variable or method
name, perform one of the following actions:
- Position the text cursor on a field or paragraph name and
press the F3 key.
- Hover the cursor over a variable or method name, hold down
the Ctrl key, and click.
- Right-click the data item reference, and select Open
Declaration from the pop-up menu.
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.
- Hovering the cursor over a variable or procedure causes
hover help to display details about the highlighted element. Hovering
the cursor over this help causes a toolbar to appear. The toolbar
contains a toolbar button for opening the declaration of the hovered
element.
- 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 PL/I Editor only.
- 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 by use the drop
down menu for the buttons on the toolbar. This action available
for the PL/I Editor only.
- To jump to the location of the next or previous next or
previous Package or Procedure use the Go To Next Element (Ctrl+Shift+Down)
and Go To Previous Element (Ctrl+Shift+Up)
actions. This action available for the PL/I 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 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 include file referenced in an Include Statement,
use the Open Include File action . The action
is available in the editor context menu, or as a hyperlink.
- To open a procedure referenced in a CALL, EXEC CICS LINK,
or EXEC CICS XCTL Statement, use the Open Procedure and Open
File actions. The name of the procedure 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 procedure is located within the same compilation unit,
you can navigate to the procedure using the Open Procedure action.
Otherwise, you can use the Open File action to search for and open
a file. The name of the procedure or file available to be opened
is determined statically. The action is available in the editor context
menu, or as a hyperlink.