Opening a file reference

You can open a file reference from a JCL file that is open in the JCL Editor or z Systems® LPEX Editor in edit, browse, or view mode.

Supported Editors:
  • JCL Editor
  • z Systems LPEX Editor

Before you begin

The product locates file references in these ways:
  • If the JCL file contains a statement like // JCLLIB ORDER=USERXX.PROCLIB, then it checks the defined JCLLIB location first.
  • If the file reference is not found in the JCLLIB location, then it checks the locations specified in the Include and procedure search libraries field of the associated property group.
To configure include and procedure search libraries in a property group:
  1. To open the remote property group that is associated with the JCL file that you are editing, right-click the file name and select Property Group > Edit Associated Property Group.
  2. Click the JCL tab.
  3. Scroll to the Editor Configurations section of the page.
  4. To add data sets that contain referenced files to the property group, drag a remote data set into the Include and procedure search libraries field.
  5. Save the property group.

About this task

The product opens file references in the default editor for the file type. If there is no z/OS® file system mapping associated with the include or procedure search library, the product opens the referenced file in the z Systems LPEX Editor.

Opening and browsing a file reference

Procedure

  1. In the editor, highlight the file that you want to open and right-click.
  2. Click Open file_reference or Browse file_reference. The file_reference displays the name of the file that is requested to be opened.
    The file opens in the editor.

Viewing a file reference

About this task

The View file_reference action opens a remote file in edit mode without obtaining a lock. You cannot save the changes into the original file. You must save the file with a different name.
Note: Because local files are not locked for editing, this action is not available for local referenced files.

Procedure

  1. Select the reference to the file that you want to open.
  2. Right-click and select View file_reference from the menu.
    The file opens in the editor.
  3. If you modify the file, you are prompted to save the file with another name.