Viewing related WLM resources in the Workload Map view

Edit online

The Workload Map view shows related definitional workload management (WLM) resources in a CICSplex, making it easier to understand the complex relationships between WLM resources and how and where they are being used.

To use the Map view for BAS resources, see Viewing related BAS resources in the Map view.

As the following screen capture shows, for a workload group, the Map view shows its associated workload specifications and workload definitions (also known as non-default routing rules in the CICS Explorer® terminology), and from here you can then explore the associated routers, targets, and transaction groups for each workload specification and workload definition. For more information about workload management in CICS Explorer, see Workload management with CICS Explorer.
A sample Map view with a workload group at the root
You can open the Map view from any of the following views and editors:
  • CICSplex Explorer view (applicable to workload specifications, system definitions, and system group definitions)
  • Managed Regions view
  • Workload Definitions view
  • Workload Groups view
  • Workload Specification editor
  • Workload Specification view
  • Workload Transaction Groups view

The Map view provides information about your WLM setup. For example, if you want a new transaction to behave the same as an existing one, before adding it to a transaction group, you can use the Map view to examine the behavior of the existing transaction.

Prerequisite:

The Map view for BAS resources is supported in IBM® CICS Explorer for Aqua 3.21 or later and CICS Explorer on Eclipse Marketplace. In CICS, the CMCI JVM server provides the underlying CMCI GraphQL API that supports the Map view function. In CICS Explorer, to enable the Map view for BAS resources in the CICSPlex SM environment, the WUI region that CICS Explorer connects to must be at Version 5.5 or later and be configured to use the CMCI JVM server. For instructions, see Setting up CMCI in CICS TS documentation.

Open the Map view for a WLM resource

You can open the Map view from any workload-management-related view or editor that supports this function. Either click the Map button (Map button) in the view or editor, or right-click a resource and select Map or Show in Workload Map.
Open the Map view of a transaction from the Transaction Group view

The Map view places the selected resource at the root of a tree structure, with its related resources as child nodes. The following screen capture shows the Map view of a transaction (CIOE).
A sample transaction shown at the root in the Map view

You can repeat the action against any WLM resource in the Map view by right-clicking it and selecting Show in Workload Map. That resource then becomes the root of the tree structure, allowing you to investigate further.
Switch the root of the map to the transaction group

As shown in the following screen capture, switching the root to the transaction group shows details about its behavior, such as the routers of the workload specification.
A sample transaction group shown at the root of the map

View or edit the attributes of a WLM resource from the Map view

To view or edit the attributes of a resource in the Map view, right-click it and select Open, or simply double-click it. This opens an editor for that resource, where you can make changes.

Open a resource from Map view by right-clicking

Attributes editor

View map history

To review maps that have been previously shown in the Map view, click the Backward (Backward button on the toolbar of the Map view) or Forward button (Forward button on the toolbar of the Map view) on the view toolbar. You can also click the arrows beside those two buttons to jump to a specific map in the history.
Show the list of previous maps by clicking the arrows beside the Backward button

What's next

For an example of using the Map view, see Example: viewing relationship of a routing rule in the Workload Map view.

1 Aqua refers to IBM Explorer for z/OS® Aqua.