Opening expanded source files

Use the Show Expanded Source menu item to open a COBOL or PL/I file in read-only mode in the System z® LPEX Editor, COBOL Editor, or PL/I Editor with copybooks and include files expanded.

Before you begin

  1. Associate a property group with the file. Specify these property group options:
    • In the SYSLIB field of the property group, specify a search path for copybooks and include files.
    • On the Local Preprocessors page, select -INC/++INCLUDE Preprocessor.
    • In the Preprocessor arguments field, specify CMT(ON).
  2. If you previously ran the local include preprocessor against the source file, open the file in an editor and select the Source > Preprocessor Statements > Clear Identifications menu item.

About this task

The Show Expanded Source action uses the local include preprocessor that is included with the product to open a source file with copybooks and include files expanded. The preprocessor runs in the background so that you can continue to use the product while the Show Expanded Source action completes. The expanded file is opened in the same editor from which you requested the action. If, for example, the file was open in the COBOL Editor when you requested the Show Expanded Source action, then the expanded file is also opened in read-only mode in the COBOL Editor. While the expended file is open, you can do any actions that are valid for files open in read-only mode.

Procedure

  1. Open a COBOL or PL/I source file in the System z LPEX Editor, COBOL Editor, or PL/I Editor.
  2. From the menu, select Source > Show Expanded Source or press Ctrl+Shift+E.

Results

The expanded source file is opened in read-only mode. Comments are added to the file to mark the beginning and end of copybooks or include files, as in this example:
* COPY ABC
01  XYZ     PIC X
01  FIRST  PIC 9

Feedback