WLMAWORKRecordType

WLMAWORK Record

Fields

abendcrit (Long)

The abend probability for a transaction associated with the default transaction group that should cause a target region to be considered unhealthy.

A value of 0 means WLM is not calculating abend probabilities for the workload.

abendthresh (Long)

The abend probability for a transaction associated with the default transaction group that should cause a target region's load level to be doubled.

A value of 0 means WLM is not calculating abend loads for the workload.

activeRoutingRegions (Long)

The number of active CICS systems, identified as routing regions, that are associated with the workload.

activeTargetRegions (Long)

The number of active CICS systems, identified as target region for the workload.

algorithmType (String)

The algorithm to be applied to all transactions that are not associated with any installed transaction group:

  • QUEUE - Routes transactions to the target region that has the lowest routing weight at the time of the routing evaluation. The routing weight of a target region is a combination of factors that include:

    • The current task load
    • The current target health state
    • The link speed from the router to the target
    • The probability of transaction abend at the target
    • The effect of any outstanding RTA events at the target

  • LNQUEUE - Routes transactions to the target region that has the lowest routing weight at the time of the routing evaluation. The routing weight of a target region is a combination of factors that include:

    • The current task load
    • The current target health state
    • The effect of any outstanding RTA events at the target
    • The probability of transaction abend at the target

    Note - The link speed from the router to the target is not factored into the routing weight calculation for the LNQUEUE algorithm

  • GOAL - Routes transactions to the target region which is best able to meet the transaction's average response time goal, as predefined using z/OS Workload Manager.

    • If a specific target region cannot be resolved from the evaluated GOAL set, then the QUEUE algorithm is applied to the remaining target set.

  • LNGOAL - Routes transactions to the target region which is best able to meet the transaction's average response time goal, as predefined using z/OS Workload Manager.

    • If a specific target region cannot be resolved from the evaluated GOAL set, then the LNQUEUE algorithm is applied to the remaining target set.
automaticAffinityCreation (String)

Indicates whether CICSPlex SM is to automatically create an affinity relationship for transactions that are not associated with any installed transaction group.

YES : An affinity is created using the values in the Affinity Relation and Affinity Lifetime fields.

NO : An affinity is not automatically created (but can be created by a customized version of the dynamic routing program EYU9WRAM).

N/A : There are no values in the Affinity Relation and Affinity Lifetime fields, therefore, no affinity is created.

defaultAffinityLifetime (String)

The default affinity lifetime used with the default affinity relation. This value is applied to transactions that are not associated with any installed transaction group. After the first instance of a transaction, subsequent instances of the transaction are run on the same target region:

  • DELIMIT - Until the pseudoconversation mode is END
  • LOGON - For the duration of the terminal session
  • PCONV - For the duration of the pseudoconversation
  • PERMANENT - For as long as the workload is active
  • SIGNON - Until the terminal user signs off
  • SYSTEM - Until the target region terminates
  • ACTIVITY - For as long as the CICS BTS activity is active
  • PROCESS - For as long as the CICS BTS process is active
  • UOW - For as long as the unit-of-work is active
  • NONE - No affinity lifetime was defined
defaultAffinityType (String)

The default affinity relation applied to transactions not associated with any installed transaction group. The affinity relation values are:

  • GLOBAL - All users at all terminals
  • LUNAME - Terminal logical unit name
  • USERID - User ID
  • BAPPL - Business Application
  • Locked - LOCKED affinities can arise only between dynamically linked programs. A LOCKED affinity is created when a called program retains state data that is to be preserved after returning to its caller. Programs with this type of affinity are routed to the same target region until end of unit of work occurs. LOCKED can be used only for dynamic program link (DPL) requests with an associated affinity lifetime of UOW.
  • NONE - No affinity relation was defined
defaultTargetScope (String)

The name of the CICS system or CICS system group that is to be the target for any dynamic transactions or programs not associated with a transaction or program group.

description (String)

The description of the workload.

eventName (String)

The name of a real-time analysis event that will affect the routing of transactions in this workload. If a real-time analysis event is generated, WLM uses the information as part of the target selection criteria.

An event can optionally be associated with a workload when the workload specification is created. If this field is blank, no event is associated with the workload.

The name of an event is the same as an installed real-time analysis definition (RTADEF) or status definition (STATDEF)

name (String)

The name of the workload. This is also the name of the installed workload specification definition.

optimizationStatus (String)

This field reports the sysplex optimization status of the current workload. The value is an amalgamation of all of the workload router optimization statuses, and all of the workload target optimization statuses.

The possible values are:

ACTIVE : All targets and routers in the workload are executing in optimized workload state.

PARTIAL : At least one target and one router are executing in optimized workload mode. Use the Active routing regions and Active target regions hyperlinks to determine which regions are not running in an optimized state.

INACTIVE : The workload is not running in an optimized state, for one or more of the following reasons:

* No routing regions in the workload are running in an optimized state
* No target regions in the workload are running in an optimized state
* No regions in the workload are running in an optimized state
* The optimised workload routing function is DISABLED for the current target region
* The workload was designated as being non optimized by specifying a value of 0 for the RS server update frequency on the CICSplex definition or CICS system definition for this workload.
owningSystemID (String)

The CICS system ID of the CMAS that created the workload.

reportingCMAS (String)

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 workload.

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 workload from each CMAS that manages the workload.

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

shared (String)

Indicates whether the workload has been shared with a back level CMAS which does not support the installation of CICS BTS related definitions.

waffcnt (Long)

The number of active transaction group affinities that are associated with the workload.

wdefcnt (Long)

The number of active workload definitions that are associated with the workload.

workloadStatus (String)

The status of the workload:

  • ACTIVE - All the target and routing region connections that this workload depends upon are available
  • FROZEN - A target or routing region connection that this workload depends upon has been lost

As long as a workload remains frozen:

  • Transactions will continue to be routed according to any existing affinities
  • New affinities can be created as long as they do not involve other CMASs. Global or permanent affinities, which require other CMASs to be notified, cannot be created
  • Install and discard action commands are not allowed for any aspect of the workload

The cause of a lost connection could be the target or routing region, one of the CMASs that manage the workload or a connection between the CMASs. To determine why a workload is frozen:

  • Check the contact status in the Target region in active workload (WLMAWAOR) and Active workload routing regions (WLMAWTOR) views to determine which target or routing region is affected
  • Check the MAS view to determine the status of the target or routing region
  • Check the status of all connections for the target or routing region Determine which connection(s) were lost and take appropriate action to re-establish the connections.
wtgpcnt (Long)

The number of active transactions groups that are associated with the workload.

wtrncnt (Long)

The number of active dynamic transactions that are associated with the workload.