Opening JCL procedures

You can open a JCL procedure that is referred to in a JCL file in edit, browse, or view mode.

Supported Editors:
  • JCL Editor
  • z Systems® LPEX Editor

Before you begin

The product locates JCL procedures 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 JCL procedures 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 JCL procedures 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 or browsing a JCL procedure

About this task

The Open JCL Procedure action opens a file in edit mode and locks the file. The Browse JCL Procedure action opens it in read-only mode.

Procedure

To open or browse a JCL procedure from the editor:

  1. Select a JCL procedure name in a program file open in the editor and right-click.
  2. From the menu, select Open JCL Procedure or Browse JCL Procedure.
    The JCL procedure opens in the editor.

Viewing a JCL procedure

About this task

The View JCL Procedure action opens the JCL procedure in edit mode, but does not lock the file. You cannot save the changes in the same file, but you can save the file with a different name.

Procedure

  1. Select a JCL procedure name in a JCL file open in the editor.
  2. Right-click and select View JCL Procedure from the menu.
    The JCL procedure opens in the editor.
  3. If you modify the file, you are prompted to save the file with another name.
    Note: The Save as feature cannot be used to create a member or sequential data set. The file is saved in your local workspace project.