Navigating to a data set

Use the Navigate to Data Set action in the editor to highlight a data set name declared in a DD statement in the Retrieved Data Sets filter of the Remote Systems view.

Procedure

  1. In the editor, highlight a data set name.
  2. Right-click and select Navigate to Data Set.
    The data set is highlighted in the Retrieved Data Sets filter of the Remote Systems view.

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.

Opening an include member

You can open a member that is referred to in an INCLUDE statement 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.JCL, 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 Remote include and procedure search libraries in a Remote 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. Select Remote JCL options on the JCL Settings.
  4. Scroll to the Editor Configurations section of the page.
  5. To add data sets that contain include group members to the property group, drag a remote data set into the Include and procedure search libraries field.
  6. Save the property group.
The remote property group can also be configured to open a local JCL include member from a remote JCL file in the JCL Editor only. To configure Local include libraries (SYSLIB) in a Remote 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. Select Local JCL options on the JCL Settings.
  4. Select Add to select or manually input the local directory for the local JCL include members to the SYSLIB table.
  5. Save the Property Group.

The Local JCL Property Group supports opening a Local JCL include member or a Remote JCL include member from a local JCL file in the JCL Editor only.

For information on configuring a property group to support opening a local or remote JCL include member from a local JCL file, see Defining libraries for local projects and files.

Limitations: The JCL Editor does not support include members that are referenced using & variable substitution.

Opening and browsing

About this task

The Open Member action opens a member in edit mode and locks the file. The Browse Member action opens a member in read-only mode.

Procedure

  1. In the editor, place the cursor over the MEMBER attribute of an INCLUDE statement and right-click.
  2. Click Open Member or Browse Member.
    The member opens in the editor.
    Note: If using the JCL Editor to open the JCL file, you may also use the mouse to hover over the Include Member name and open the include member file with the Pencil icon.
    Limitations: The Open Member and Browse Member option are unavailable for local included members defined in the Remote Property Group.
    Workaround: You can select the include member name and use the mouse to hover and open the file using the Pencil icon.

Viewing

About this task

The View Member action opens a member 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 the reference to the member that you want to open.
  2. Right-click and select View Member 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.
    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.

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.

Using the JCL Outline view

When you open a file in the editor, an outline of the file opens in the Outline view. You can expand or collapse file divisions, sort file divisions by name, or filter file divisions by name.

About this task

The divisions in a JCL file are identified by icons in the Outline view:
Icon Outline element
DD statement icon DD statement
EXEC statement icon EXEC statement
JOB statement icon JOB statement

Procedure

  • To expand and collapse sections in the Outline view, click Expand outline or Collapse outline next to the program section you want to expand or collapse. When you place the cursor on a line in the editor, the outline expands or collapses the corresponding node.
  • To sort sibling nodes in the outline in ascending order by name, click Sort elements by name toolbar button.
  • To hide parts of the JCL file according to their name:
    1. Select Filters from the drop-down menu.
      The JCL Element Filters window opens.
    2. Type a name pattern in the field.
      You can use the * and ? wildcard characters in the filter string. Separate multiple filter strings with commas.
    3. Click Ignore case to match strings in upper, lower, or mixed case.
    4. Click OK.
      The Outline view hides any JCL elements that match the filter strings entered.
    5. To show any of these filtered elements, select Filters again, delete the filter strings from the field, and click OK.

Submitting a JCL file to JES

You can submit a JCL file to the JES subsystem.

Before you begin

Supported Editors:
  • JCL Editor
  • z Systems LPEX Editor
You must be connected to a remote system.

Procedure

  1. Open a JCL file in the editor.
  2. Right-click and select Submit > remote system name.
    The job is submitted to the remote system that you selected. The Job Submission Confirmation window opens.
  3. To locate the job in the Remote Systems view, click Locate Job.
    The job is highlighted in the Retrieved Jobs folder of the JES subsystem in the Remote Systems view.

What to do next

For information about working with jobs in the JES subsystem, see Working with JES jobs.