Navigating in PL/I source files

The z Systems® LPEX Editor, PL/I Editor, and PL/I Compare Editor provide various ways to navigate to and from variable declarations, even when a variable is declared in a different file.

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 menu.
    If the declaration is 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 a hover information window to display details about the highlighted element. Hovering the cursor over this window causes a toolbar to be displayed. 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 by using the Annotations page. To access this preference, click General > Editors > Text Editor > Annotations or use the menu for the buttons on the toolbar.
    This action is available for the PL/I Editor only.
  • To jump to the location of the 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 (left arrow) icon to go back to a previous location and the right arrow (right arrow) icon to move forward. These icons are 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 menu, or as a hyperlink.
  • To open the include file that is referenced in an Include Statement, use the Open Include File action. The action is available in the editor menu, or as a hyperlink.
  • To open a procedure that is 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 cannot be determined statically, then these actions are not available.
    • If the procedure is located within the same compilation unit, you can navigate to the procedure by 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 menu, or as a hyperlink.