Active routing regions - WLMAWTOR

The Routing regions in an active workload (WLMAWTOR) views display information about all active routing regions that are associated with a workload that is within the CICSplex identified as the context.

Supplied views

To access from the main menu, click:

Active workload views > Active routing regions

Table 1. Views in the supplied Active workload routing regions (WLMAWTOR) view set
View Notes
Active workload routing regions

EYUSTARTWLMAWTOR.DETAILED

 Detailed information about a selected active routing region.
Active workload routing regions

EYUSTARTWLMAWTOR.TABULAR

 Tabular information about all active routing regions that are associated with a workload.

Actions

Table 2. Actions available for WLMAWTOR views
Action Description
GET The name of the workload specification. You can specify a workload name of '*', which returns details of all routing regions in all workloads. No other type of generic workload name may be specified.

Fields

Table 3. Fields in WLMAWTOR views
Field Attribute name Description
Routing region contact status CON_STATUS The status of the connection between the routing region and the CMAS. Values are:
  • LOSTCON - The connection between the routing region and the CMASs has been lost.
  • N_A - The connection between the routing region and the CMASs managing the workload is available.
Optimization status OWSTATE This field reports the status of the current routing region for the optimized workload routing function.

The possible values are:

  • ACTIVE
    • This router region is executing in an optimized workload state.
  • INACTIVE
    • This region is capable of executing in an optimized workload state, however, is not currently optimized for one or more of the following reasons:
      • The region has no connection to an RS Server
      • The region is connected to an RS Server, however, the server has not been able to connect to the coupling facility
      • The optimised workload routing function is DISABLED for the current target region
      • The RS server update frequency value for this region is 0, which means that the optimization capabilities for this region are not enabled
      • The connection between the routing region and the reporting CMAS has been lost, i.e. the routing region's contact status is LOSTCON
  • N_A
    • The router region is not configured to provide optimized workload management. Only non optimized WLM routing decisions can be made.

If the CMAS that your WUI is using is not connected to a Region Status (RS) server, the optimization status for remote regions will not be updated and defaults to INACTIVE. Where this situation occurs, either connect all reporting CMASs to the RS server or use the Active target regions view to check the optimization state.

Reporting CMAS RPTCMAS The name of the CMAS that provided the information in this record.

If the GET operation optional parameter EXPLODE is not specified or is specified as NO, then this attribute will be set to blanks and only one record will be returned for the routing region.

If the GET operation optional parameter EXPLODE is specified as YES, then this attribute will be set with the name of the CMAS that provided the information in this record. A separate record will be returned for the routing region from each CMAS that manages the workload associated with the routing region.

When the IBM distributed WUI menus and views are used to request the WLMAWTOR tabular view, the EXPLODE parameter will be set to YES.

Routing region name TOR The name of an active CICS system, acting as a routing region, to which the workload is associated.
Name of controlling CMAS TOROWNER The name of the controlling CMAS.
Workload name WORKLOAD The name of the workload specification.
System ID of workload owner WRKLOWNER The 4-character CICS system ID of the CMAS that created the workload.