z/OS Resources Table

The z/OS Resources Table provides a tabular view to interact with z/OS resources using your existing RSE API or z/OSMF Zowe profiles. It is an advanced capability available for users with an active license. It is designed to be both beginner-friendly for new mainframe application developers and to provide more experienced developers with the necessary tools and information to manage host resources.

Setting up profiles for the z/OS Resources Table

To use the z/OS Resources Table, you must create an RSE API or z/OSMF profile using Zowe Explorer. For more information on how to create profiles by using Zowe Explorer, see Connecting to z/OS with Zowe Explorer walkthrough.

Opening the z/OS Resources Table

You can open the z/OS Resources Table in one of the following ways:

  • Cmd ⌘/Ctrl + Shift + P to open the command prompt and run the command >IBM Z Open Editor: Open z/OS Resource Table.
  • After setting an active filter for a profile in the Zowe Explorer JOBS, DATA SETS, or USS view, right-click the active profile and select Show in z/OS Resource Table from the context menu. This will display items matching the filter in the table.
  • After setting an active filter for a profile in the Zowe Explorer JOBS, DATA SETS, or USS view, right-click a resource (e.g. a data set, a job) and select Show in z/OS Resource Table from the context menu. This will display the selected resource in the table.

The first two methods will open the table and display the default Profiles view. The third method will display the data sets or jobs matching that filter.

Views

Profiles View

The profiles view displays the RSE API and z/OSMF profiles defined in your Zowe Explorer team configuration file. To start accessing z/OS resources for a specific profile, click on the row of that profile.

After clicking on a profile, a view is displayed that allows the user to select a z/OS resource to access: MVS, USS, and JES. Clicking on one of these rows will load the MVS view, USS view, or JES view, respectively.

MVS View

The MVS view consists of the following rows that perform the following actions when clicked:

  • Default User Data Sets: Displays all data sets that have the selected profile's user ID as their high-level qualifier (only available for profiles using password or passphrase authentication)
  • Filters: Opens the Filters view where users can create and use custom patterns for viewing data sets.
  • Favorites: Opens a view that displays data sets favorited by the user.
  • History: Opens a view that displays the five most recently used patterns to filter data sets.

Clicking on the Default User Data Sets, a custom pattern in the Filters view, or a pattern in the History view will display data sets that match the selected pattern.

JES View

The JES view consists of the following rows that perform the following actions when clicked:

  • Default User Jobs: Displays all jobs that have the selected profile's user as their owner (only available for profiles using password or passphrase authentication)
  • Filters: Opens the Filters view where users can create and use custom patterns for viewing jobs.
  • Favorites: Opens a view that displays jobs favorited by the user.
  • History: Opens a view that displays the five most recently used queries to filter jobs.

Clicking on the Default User Jobs, a custom query in the Filters view, or a query in the History view will display jobs that match the selected query.

USS View

The USS view consists of the following rows that perform the following actions when clicked:

  • User Files: Displays all items in the /u/user directory, where user is the selected profile's user (only available for profiles using password or passphrase authentication)
  • Filters: Opens the Filters view where users can use and save paths for viewing UNIX items.
  • Favorites: Opens a view that displays UNIX items favorited by the user.
  • History: Opens a view that displays the five most recently viewed UNIX items.

Actions

When viewing resources, there are different kinds of actions available in the table. These include toolbar actions, batch actions, and overflow menu actions.

'zos-resource-table-actions'

  • Navigation actions are the same across all views. They can be used to navigate through the table's history or to return to the Profiles view.
  • Toolbar actions are unique to specific views. For example, the Create Data Set button is only available when viewing data sets. Hovering a toolbar action button will display popover text describing what the button does.
  • Overflow menu actions are available only in select views. Selecting an overflow menu action will perform the action for the selected resource. An overflow menu can be opened by clicking the three dots on the right side of a row. These dots appear on row hover, and will not appear on rows that do not use overflow actions.
  • The input area is a special field available while viewing jobs, UNIX files, or data sets that enables users to quickly change the active filter pattern and display an updated list of resources matching that pattern.

The last available kind of actions are batch actions.

'zos-resource-table-batch-actions'

Batch actions are only available for views with selectable rows. They are displayed after the user selects one or many rows using the checkboxes on the left side of the view. Batch actions are executed on every resource selected. For example, if you select the checkbox for multiple jobs and use the Delete batch action, all the selected jobs will be deleted.

Last Updated:
Contributors: Benjamin Santos, PETER HAUMER, Hestia Zhang, Saile Daimwood