Transaction group affinities - WLMATAFF

The Active workload transaction group affinities (WLMATAFF) views display information about the active affinities for a transaction group installed in a workload within the CICSplex identified as the context. An affinity becomes active when the first transaction associated with the transaction group is routed to a target region.

Supplied views

To access from the main menu, click:

Active workload views > Transaction group affinities

Table 1. Views in the supplied Active workload transaction group affinities (WLMATAFF) view set
View Notes
Active workload transaction group affinities

EYUSTARTWLMATAFF.DETAILED

 Detailed information about a selected active affinity.
Active workload transaction group affinities

EYUSTARTWLMATAFF.FORCE

 Discard an affinity entry.

The affinity is reestablished when the next transaction within the affected transaction group is encountered.

Active workload transaction group affinities

EYUSTARTWLMATAFF.TABULAR

 Tabular information about the active affinities for a transaction group associated with a workload within the CICSplex identified as the context.

Actions

Table 2. Actions available for WLMATAFF views
Action Description
FORCE Discard an affinity entry.

The affinity is reestablished when the next transaction within the affected transaction group is encountered.

Fields

Table 3. Fields in WLMATAFF views
Field Attribute name Description
Affinity relationship AFFINITY The affinity relationship used when processing a transaction associated with the transaction group. The affinity relationship values are:
  • GLOBAL - All users at all terminals.
  • LUNAME - Terminal logical unit name.
  • USERID - User ID.
  • BAPPL - CICS BTS 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.
Key that identifies creator of affinity AFFKEY Up to 64 characters identifying who invoked a transaction, comprising the transaction group and their location. Depending on the affinity relation and lifetime values, this key will be some combination of the user ID, logical unit name, routing region name, and terminal ID, in the following format: userid.luname.rtrname.termid. If one or more of these values does not apply to the affinity, that part of the key is left blank.

For BAPPL affinities, this field contains the Activity ID of the CICS BTS activity.

For LOCKED affinities, this field contains the combination of the routing region name with the network and local unit-of-work identifiers.

A value of GA is displayed for global affinities.

Target region AOR The name of the CICS system to which transactions associated with the transaction group are to be routed.
BTS activity ID CBTSKEY The hexadecimal representation of the Affinity Key. It is shown in this additional format because part of the key may not be displayable in normal character representation.
Affinity lifetime LIFETIME The affinity lifetime used when processing a transaction associated with the transaction group. The affinity lifetime values are:
  • DELIMIT - Until the pseudoconversation mode is END.
  • LOGON - For the duration of the terminal session.
  • NONE - No affinity lifetime was defined.
  • PCONV - For the duration of the pseudoconversation.
  • PERMANENT - As long as the workload is active.
  • SIGNON - As long as the user session is active.
  • SYSTEM - As long as the target region is active.
  • ACTIVITY - As long as the CICS BTS activity is active.
  • PROCESS - As long as the CICS BTS process is active.
  • UOW - For as long as the unit-of-work is active
Local unit-of-work ID LOCUOWID The hexadecimal representation of the CICS local unit-of-work identifier. It is shown in this additional format because part of the key may not be displayable in normal character representation.
Terminal LU name LUNAME The logical unit name of the terminal of the CICS system to which transactions associated with the transaction group are to be routed.
Network unit-of-work ID NETUOWID The hexadecimal representation of the CICS network unit-of-work identifier. It is shown in this additional format because part of the key may not be displayable in normal character representation.
The activity ID of the CBTS activity RESERVD2 The ID of the CBTS activity.
Routing region terminal TERMID The terminal ID of the CICS system to which transactions associated with the transaction group are to be routed.
Routing region TORNAME The name of the CICS system to which transactions associated with the transaction group are to be routed.
Transaction group TRANGRP The name of an active transaction group. A value of $$DTGA$$ represents the default transaction group, which is used for any transactions that are not associated with a transaction group.
User identifier USERID The user identifier ID.
Workload name WORKLOAD The name of the workload in which the transaction group is active.
System ID of workload owner WRKLOWNER The 4-character CICS system ID of the CMAS that created the workload.