A CICS® Definition that describes
the operational characteristics for transactions belonging to a given
class.
The Primary key field for this resource class
is NAME.
The Secondary key field for this resource
class is DEFVER.
The Tertiary key field for this resource class is CSDGROUP.
- External resource name
- CICSDefinitionTransactionClass
- Length
- 152
- Usage
- API or Batch Utility or WUI or CICS Management Client Interface
- API view
- No
- CMAS context
- No
- SCOPE applies
- No
- Only query CMASs in workload
- No
- Object type
- CICS Definition
- Copybook identifier
- EYUt3814
Table 1. Valid CPSM operations
| Operations |
Actions |
Parameters |
Required |
| GET |
|
CICSSYS(value) |
No |
| |
|
CSDGROUP(value) |
No |
| |
|
RESGROUP(value) |
No |
| CREATE |
|
CSD |
No |
| |
|
RESGROUP(value) |
No |
| UPDATE |
|
CSD |
No |
| REMOVE |
|
CSD |
No |
| PERFORM SET |
INSTALL |
FORCEINS(YES, NO) |
No |
| |
|
MODE(value) |
No |
| |
|
NOTIFY(NO, INACTIVE, RELEASE, FULL) |
No |
| |
|
OVERRIDE |
No |
| |
|
OVERTYPE(TARGET, RELATED, BOTH, NONE) |
No |
| |
|
RELATED(value) |
No |
| |
|
STATECHK(YES, NO) |
No |
| |
|
TARGET(value) |
Yes |
| |
|
USAGE(LOCAL) |
Yes |
| |
ADDTOGRP |
RESGROUP(value) |
Yes |
| |
CSDINSTALL |
None |
N/A |
| |
CSDCOPY |
AS_RESOURCE(value) |
No |
| |
|
DUPACTION(DUPERROR, DUPNOREPLACE, DUPREPLACE) |
No |
| |
|
TO_CSDGROUP(value) |
No |
|
Table 2. TRNCLDEF FEEDBACK error codes
| Value |
Code |
Description |
| 1 |
TRNCLDEF_INV_DATA |
Attribute data invalid |
| 2 |
TRNCLDEF_REC_NOT_FOUND |
Requested resource not found |
| 4 |
TRNCLDEF_REC_EXISTS |
Resource already exists |
| 5 |
TRNCLDEF_REC_CHANGED |
Resource definition already changed |
| 6 |
TRNCLDEF_INV_RESTYPE |
Invalid resource type |
| 7 |
TRNCLDEF_INV_VER |
Invalid resource version |
| 11 |
TRNCLDEF_NON_MP |
Maintenance point CMAS not available |
| 12 |
TRNCLDEF_INV_CONTEXT |
Context not found |
| 13 |
TRNCLDEF_INCONSISTENT_SET |
Inconsistent set condition |
| 14 |
TRNCLDEF_INV_RESGROUP |
Resource group not found |
| 21 |
TRNCLDEF_INV_ACTION |
Invalid action |
| 22 |
TRNCLDEF_INV_RECADDR |
Invalid record address |
| 23 |
TRNCLDEF_INV_RECLEN |
Invalid record length |
| 24 |
TRNCLDEF_DIFF_VERSION |
Different version |
| 25 |
TRNCLDEF_EARLY_NAMELIST_END |
Early name list end |
| 26 |
TRNCLDEF_INV_NAMELIST |
Invalid name list |
| 27 |
TRNCLDEF_INV_NAME |
Invalid name |
| 28 |
TRNCLDEF_INV_MINNAME |
Invalid minor name |
| 29 |
TRNCLDEF_NOTIFY |
Notify |
| 30 |
TRNCLDEF_PARTIAL_INSTALL |
Partial install |
| 31 |
TRNCLDEF_NOTHING_INSTALLED |
Nothing installed |
| 32 |
TRNCLDEF_NO_TARGETS |
No targets |
| 33 |
TRNCLDEF_NO_RELATED |
No related systems |
| 34 |
TRNCLDEF_INV_TSCOPE |
Invalid target scope |
| 35 |
TRNCLDEF_INV_RSCOPE |
Invalid related scope |
| 36 |
TRNCLDEF_INV_USAGE |
Invalid usage |
| 37 |
TRNCLDEF_INV_MODE |
Invalid mode |
| 38 |
TRNCLDEF_INV_STATECHK |
Invalid state check |
| 39 |
TRNCLDEF_INV_FORCEINS |
Invalid force install |
| 40 |
TRNCLDEF_INV_NOTIFY |
Invalid notify |
| 41 |
TRNCLDEF_INV_OVERTYPE |
Invalid overtype |
| 42 |
TRNCLDEF_INV_OVRBLOCK |
Invalid override block |
| 43 |
TRNCLDEF_INV_ORSTRING |
Invalid override string |
| 44 |
TRNCLDEF_INV_STRNGTERM |
Invalid string terminator |
| 45 |
TRNCLDEF_INV_EMBEDTERM |
Invalid embedded terminator |
| 46 |
TRNCLDEF_INV_ATTRIBUTE |
Invalid attribute |
| 47 |
TRNCLDEF_INV_LITERAL |
Invalid literal |
| 48 |
TRNCLDEF_INV_ORSTGNA |
Invalid override string |
| 49 |
TRNCLDEF_SCOPE_REQUIRED |
Scope required |
| 50 |
TRNCLDEF_USAGE_CONFLICT |
Usage conflict |
| 51 |
TRNCLDEF_NODEFS_SELECTED |
No definitions selected |
| 52 |
TRNCLDEF_MORE_THAN_1_RELSYS |
More than one related system |
| 53 |
TRNCLDEF_MISSING_RELSYSID |
Missing related system identifier |
| 54 |
TRNCLDEF_SCOPE_CONFLICT |
Scope conflict |
| 55 |
TRNCLDEF_INV_CSDGROUP |
Invalid CSD group |
| 56 |
TRNCLDEF_REC_NOT_REMOVED |
Record not removed |
| 57 |
TRNCLDEF_INV_RESOURCE |
Invalid resource |
| 58 |
TRNCLDEF_INV_CICS_RESTYPE |
Invalid CICS restype |
| 59 |
TRNCLDEF_PARTIAL_ACTION |
Partial action |
| 60 |
TRNCLDEF_NOTHING_ACTIONED |
Nothing actioned |
| 61 |
TRNCLDEF_INV_BOTHTOAS |
TO_CSDGROUP and AS_RESOURCE are mutually exclusive |
| 62 |
TRNCLDEF_INV_NOTTOAS |
Either TO_CSDGROUP or AS_RESOURCE is required |
| 63 |
TRNCLDEF_CSD_ERROR |
CSD access error |
|
Table 3. TRNCLDEF resource table attributes
| Name |
Datatype |
Source |
Len |
Req |
Sum |
Set |
Description |
Default |
Value Range |
Get Invalid |
Attr ID |
| CHANGEAGENT |
CVDAS |
CPSM |
4 |
No |
LIKE |
No |
Last modification agent |
|
|
E640 E650 |
16 |
| CHANGEAGENT Input/output valid values |
DREPAPI
|
| CHANGEAGREL |
CHAR |
CPSM |
4 |
No |
DIFF |
No |
Last modification agent release |
|
|
E640 E650 |
18 |
| CHANGETIME |
DATETIME |
CPSM |
8 |
Yes |
MAX |
No |
Last modification time |
|
|
|
1 |
| CHANGEUSRID |
CHAR |
CPSM |
8 |
No |
DIFF |
No |
Last modification user ID |
|
|
E640 E650 |
17 |
| CREATETIME |
DATETIME |
CPSM |
8 |
Yes |
MAX |
No |
Time created |
|
|
|
10 |
| CSDGROUP-3 |
CHAR |
CPSM |
8 |
Yes |
DIFF |
Yes |
CSD group |
|
|
E640 E650 |
20 |
| DEFVER-2 |
BINARY |
CPSM |
1 |
Yes |
AVG |
Yes |
Version |
0 |
0-15 |
|
5 |
| DESCCODEPAGE |
BINARY |
CPSM |
4 |
No |
DIFF |
No |
Description code page |
37 |
0-99999999 |
|
15 |
| DESCRIPTION |
CHAR |
CPSM |
58 |
No |
DIFF |
No |
Description |
|
|
|
14 |
| MAXACTIVE |
CHAR |
CPSM |
4 |
Yes |
DIFF |
No |
Maximum number of active transactions allowed in class |
0 |
0-999 |
|
8 |
| NAME-1 |
CHAR |
CPSM |
8 |
Yes |
DIFF |
Yes |
Name |
|
|
|
7 |
| PURGETHRESH |
CHAR |
CPSM |
8 |
No |
DIFF |
No |
Purge threshold |
NO |
1-1000000 |
|
9 |
| PURGETHRESH Input/output valid values |
NO
|
| USERDATA1 |
CHAR |
CPSM |
8 |
No |
DIFF |
No |
User data area 1 |
|
|
|
11 |
| USERDATA2 |
CHAR |
CPSM |
8 |
No |
DIFF |
No |
User data area 2 |
|
|
|
12 |
| USERDATA3 |
CHAR |
CPSM |
8 |
No |
DIFF |
No |
User data area 3 |
|
|
|
13 |