WLMATGRP Resource Table

A CICSPlex SM Workload Manager object that describes a transaction group installed in an active workload.

This object is referenced within the scope of a workload. The workload name must be explicitly identified in the PARM option of the API GET command by coding the following text string:

PARM('WORKLOAD(workload).')
workload is the name of an active workload and is required. Alternatively, you can code the following text string:
PARM('WORKLOAD(*).')
You can specify a workload name of * as a wildcard. Using this wildcard returns a WLMATGRP record for every workload with which the target region is associated. No other generic form of workload name can be specified - it must be an explicit workload name or the wildcard.

You can specify other parameters, but the workload name is required.

The Primary key field for this resource class is WORKLOAD.

The Secondary key field for this resource class is WRKLOWNER.

The Tertiary key field for this resource class is TRANGRP.

The following actions are supported:
ACTIVE
Activate the Transaction Group.
DORMANT
Make the Transaction Group dormant.
SET
Modify attributes of the Active Transaction Group.

These actions require no unique parameter data.

A transaction group in the dormant state does not make affinity relation decisions about AOR target selection. It does, however, record static affinity relations. This allows a transaction group to be installed before activating dynamic transaction routing to record affinities based on the existing static routing configuration. When the transaction group is made active, it then has a valid representation of affinities created using static facilities.

External resource name
CICSWLMActiveTransactionGroup
Length
64
Usage
API or WUI or CICS Management Client Interface
API view
No
CMAS context
No
SCOPE applies
No
Only query CMASs in workload
Yes
Object type
CICSPlex SM Manager
Copybook identifier
EYUt2486
Table 1. Valid CPSM operations
Operations Actions Parameters Required
GET   WORKLOAD(value) No
PERFORM SET ACTIVE WORKLOAD(value) No
  DORMANT WORKLOAD(value) No
SET   None N/A
Table 2. WLMATGRP FEEDBACK error codes
Value Code Description
21 WLMATGRP_NO_WORKLOAD No workload
22 WLMATGRP_NO_TRANGRP No transaction group
23 WLMATGRP_WORKLOAD_FROZEN Workload frozen
24 WLMATGRP_INVALID_ALGORITHM Invalid algorithm type
Table 3. WLMATGRP resource table attributes
Name Datatype Source Len Sum Set Description Default Attr ID
ABENDCRIT BINARY CPSM 1 AVG No Acceptable abend level   10
ABENDTHRESH BINARY CPSM 1 AVG No Acceptable target region load level   11
AFFAUTO EYUDA CPSM 4 LIKE No Automatic affinity creation   15
AFFAUTO Input/output valid values YES, NO, N_A
AFFINITY EYUDA CPSM 4 LIKE No Affinity relationship   8
AFFINITY Input/output valid values GLOBAL, LUNAME, USERID, NONE, N_A, BAPPL, LOCKED
AFFLIFE EYUDA CPSM 4 LIKE No Affinity lifetime   9
AFFLIFE Input/output valid values LOGON, PCONV, PERMANENT, SIGNON, SYSTEM, DELIMIT, NONE, N_A, ACTIVITY, PROCESS, UOW
ALGTYPE EYUDA CPSM 4 LIKE Yes Algorithm type INHERIT 16
ALGTYPE Input/output valid values INHERIT, QUEUE, LNQUEUE, GOAL, LNGOAL
EVENTNAME CHAR CPSM 8 DIFF No Event name   12
FILTER EYUDA CPSM 4 LIKE No Primary search criterion   7
FILTER Input/output valid values LUNAME, USERID
STATUS EYUDA CPSM 4 LIKE Yes Transaction group status   6
STATUS Input/output valid values ACTIVE, DORMANT
TRANCNT BINARY CPSM 4 AVG No Active transaction count   17
 TRANGRP-3  CHAR CPSM 8 DIFF No Transaction group   4
 WORKLOAD-1  CHAR CPSM 8 DIFF No Workload   5
 WRKLOWNER-2  CHAR CPSM 4 DIFF No Workload owner   13