WLMATAFF Resource Table

A CPSM Workload Manager object that describes an active affinity relationship for a dynamic transaction. An instance of this object exists for the duration of the affinity, which in many cases is a very short period of time.

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

APAR PQ30578

Documentation for APAR PQ30578 addedd 18/04/2000

   PARM('WORKLOAD(workload).')

where:

   workload = (Required) The name of an active workload.

The key for this resource class is a composite element.

The following action is supported:

FORCE
Force an affinity to be broken.

This action is provided for use when system failures occur and manual recovery of a workload is required. It is not intended for general use and may cause damage if used in an inappropriate manner. CICSPlex® SM makes no checks prior to the forced removal of an affinity relation.

Length
144
Usage
API
API view
No
CMAS context
No
SCOPE applies
No
Only query CMASs in workload
Yes
Object type
CPSM Manager
Copybook identifier
EYUt2487 or WLMATAFF
Valid API operations
GET and PERFORM

API Actions

FORCE
Force

Parameters: None

Table 508. WLMATAFF FEEDBACK error codes
Code Description Code Description
AFFINITY_NOT_FOUND Affinity not found TRANGRP_NOT_FOUND Transaction group not found
NO_TRANGRP No transaction group WORKLOAD_FROZEN Workload frozen
NO_WORKLOAD No workload WORKLOAD_NOT_FOUND Workload not found
Table 509. WLMATAFF resource table attributes
Name Datatype Source Len Sum Description Attr ID
 TRANGRP-3  CHAR CPSM 8 DIF Transaction group name 4
 WORKLOAD-1  CHAR CPSM 8 DIF Workload name 5
AFFINITY EYUDA CPSM 4 LIKE Affinity relationship 6
AFFINITY Output Valid Values GLOBAL LUNAME USERID BAPPL
LIFETIME EYUDA CPSM 4 LIKE Affinity lifetime 7
LIFETIME Output Valid Values LOGON PCONV PERMANENT SIGNON SYSTEM DELIMIT ACTIVITY PROCESS
 USERID-4  CHAR CPSM 8 DIF User identifier 9
 LUNAME-5  CHAR CPSM 17 DIF Terminal LU name 10
 TORNAME-6  CHAR CPSM 8 DIF Routing region name 11
 TERMID-7  CHAR CPSM 8 DIF Routing region terminal name 12
 RESERVD2-8  CHAR CPSM 11 DIF Last bytes of activity id, if CBTS-type affinity 15
AOR CHAR CPSM 8 DIF Target region 13
 WRKLOWNER-2  CHAR CPSM 4 DIF System ID of workload owner 14
CBTSKEY HEX CPSM 52 N/A BTS activity ID 16
[[ Contents Previous Page | Next Page Index ]]