Using the Outline view with HLASM

Edit online

The Outline view is a tree representation of the current Assembler file that you are editing. It is updated as text is modified in the editor.

About this task

This view displays a structural view of High Level Assembler items; such as, sections, macros, and using domains. When you select any of these items in the Outline view, the editor moves to the location of the item in the source file.

The z Systems® LPEX Editor also supports a quick outline while editing HLASM files by using the Ctrl+O keys.

When displayed in the Outline view, sections contain:
  • Undefined macros
  • Externally defined macros
  • Macros defined within the program
  • Symbols
  • Using domains
  • Embedded CICS® statements
  • Embedded SQL statements
When you select a section in the Outline view, the editor moves the cursor to the start of the section, highlights the section name, and then places emphasis on the whole section.
Note: Sections that do not have a name appear in the Outline view as >Unnamed< .
Macros that are defined within a program contain the following items in the Outline view:
  • Parameters
  • Symbols
  • Using domains
  • Undefined macros
  • Externally defined macros
  • Macros defined within the program
  • Embedded CICS statements
  • Embedded SQL statements
When you select a macro in the Outline view, the editor moves the cursor to the start of the section, highlights the section name, and then places emphasis on the whole macro.
Tip: By default, undefined macros are not displayed in the Outline view. To display undefined macros, click the Hide undefined macros view toolbar button to display undefined macros in the Outline view. Undefined macros are listed as they are found. When you select an undefined macro in the Outline view, the editor moves the cursor to the first use of the macro, and then highlights the macro name.
Tip: By default, the outline view only displays the first occurrence of a macro call. To display all occurrences, select Show all macro calls from the view menu.

Using domains are displayed in the Outline view and show their drop location as their child. When you select the Using start in the Outline view, the editor highlights the using instruction line and places emphasis on the whole using domain. When you select the drop statement, the editor moves the cursor to and places emphasis on the line where the using domain is dropped.

Procedure

You can perform the following actions in the Outline view:

  • You can match the start and end of a using domain by doing the following actions:
    • In the editor, press Ctrl+M when the cursor is positioned on a USING instruction. The appropriate DROP instruction is matched and the text between the USING and the DROP instructions is highlighted.
    • In the editor, press Ctrl+M when the cursor is positioned on a DROP instruction. The appropriate USING instruction is matched and the text between the USING and the DROP instructions is highlighted.
    • Use Ctrl+Shift+M to jump to the line of the matching instruction, rather than selecting the text in between.
  • You can customize the Outline view by ordering or filtering items according to certain criteria using the view toolbar and view menu. For example:
    • To sort all of the items in the Outline view, click the Sort view toolbar button.
    • To filter all references to a selected item in the editor, right-click the item in the Outline view and select Filter references from the popup menu. When you select an item in the Outline view, any existing filters are removed from the editor.
      Note: You cannot filter references on Using domains and their drops.
    • To have the outline view display a categorized list of items, rather than the default hierarchical view, select the Show categories menu option from the view menu. Note that selecting this option is not compatible with the Show all macros option.
    • To have items in the outline view automatically selected when you are editing in z Systems LPEX Editor, select the Link with Editor menu option from the view menu