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:
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:
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.
API Actions
Parameters: None
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 |
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 |