TRANDEF Resource Table
A CICS® Definition that describes how a transaction is to run.
The Primary key field for this resource class is NAME. Note that a transaction name can be only 4 characters long. The remainder of the 8-character NAME field should be padded with blank spaces.
The Secondary key field for this resource class is DEFVER.
The Tertiary key field for this resource class is CSDGROUP.
- INSTALL
- Install a Transaction Definition.
The parameter data for the INSTALL action is described in Parameters for installing CICS definitions using BAS.
- External resource name
- CICSDefinitionTransaction
- Length
- 576
- 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
- EYUt3813
| 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(DYNAM, STAT) | 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, REMOTE) | Yes | ||
| ADDTOGRP | RESGROUP(value) | Yes | |
| CSDINSTALL | None | N/A | |
| CSDCOPY | AS_RESOURCE(value) | No | |
| DUPACTION(DUPERROR, DUPNOREPLACE, DUPREPLACE) | No | ||
| TO_CSDGROUP(value) | No |
| Value | Code | Description |
|---|---|---|
| 1 | TRANDEF_INV_DATA | Attribute data invalid |
| 2 | TRANDEF_REC_NOT_FOUND | Requested resource not found |
| 4 | TRANDEF_REC_EXISTS | Resource already exists |
| 5 | TRANDEF_REC_CHANGED | Resource definition already changed |
| 6 | TRANDEF_INV_RESTYPE | Invalid resource type |
| 7 | TRANDEF_INV_VER | Invalid resource version |
| 11 | TRANDEF_NON_MP | Maintenance point CMAS not available |
| 12 | TRANDEF_INV_CONTEXT | Context not found |
| 13 | TRANDEF_INCONSISTENT_SET | Inconsistent set condition |
| 14 | TRANDEF_INV_RESGROUP | Resource group not found |
| 21 | TRANDEF_INV_ACTION | Invalid action |
| 22 | TRANDEF_INV_RECADDR | Invalid record address |
| 23 | TRANDEF_INV_RECLEN | Invalid record length |
| 24 | TRANDEF_DIFF_VERSION | Different version |
| 25 | TRANDEF_EARLY_NAMELIST_END | Early name list end |
| 26 | TRANDEF_INV_NAMELIST | Invalid name list |
| 27 | TRANDEF_INV_NAME | Invalid name |
| 28 | TRANDEF_INV_MINNAME | Invalid minor name |
| 29 | TRANDEF_NOTIFY | Notify |
| 30 | TRANDEF_PARTIAL_INSTALL | Partial install |
| 31 | TRANDEF_NOTHING_INSTALLED | Nothing installed |
| 32 | TRANDEF_NO_TARGETS | No targets |
| 33 | TRANDEF_NO_RELATED | No related systems |
| 34 | TRANDEF_INV_TSCOPE | Invalid target scope |
| 35 | TRANDEF_INV_RSCOPE | Invalid related scope |
| 36 | TRANDEF_INV_USAGE | Invalid usage |
| 37 | TRANDEF_INV_MODE | Invalid mode |
| 38 | TRANDEF_INV_STATECHK | Invalid state check |
| 39 | TRANDEF_INV_FORCEINS | Invalid force install |
| 40 | TRANDEF_INV_NOTIFY | Invalid notify |
| 41 | TRANDEF_INV_OVERTYPE | Invalid overtype |
| 42 | TRANDEF_INV_OVRBLOCK | Invalid override block |
| 43 | TRANDEF_INV_ORSTRING | Invalid override string |
| 44 | TRANDEF_INV_STRNGTERM | Invalid string terminator |
| 45 | TRANDEF_INV_EMBEDTERM | Invalid embedded terminator |
| 46 | TRANDEF_INV_ATTRIBUTE | Invalid attribute |
| 47 | TRANDEF_INV_LITERAL | Invalid literal |
| 48 | TRANDEF_INV_ORSTGNA | Invalid override string |
| 49 | TRANDEF_SCOPE_REQUIRED | Scope required |
| 50 | TRANDEF_USAGE_CONFLICT | Usage conflict |
| 51 | TRANDEF_NODEFS_SELECTED | No definitions selected |
| 52 | TRANDEF_MORE_THAN_1_RELSYS | More than one related system |
| 53 | TRANDEF_MISSING_RELSYSID | Missing related system identifier |
| 54 | TRANDEF_SCOPE_CONFLICT | Scope conflict |
| 55 | TRANDEF_INV_CSDGROUP | Invalid CSD group |
| 56 | TRANDEF_REC_NOT_REMOVED | Record not removed |
| 57 | TRANDEF_INV_RESOURCE | Invalid resource |
| 58 | TRANDEF_INV_CICS_RESTYPE | Invalid CICS restype |
| 59 | TRANDEF_PARTIAL_ACTION | Partial action |
| 60 | TRANDEF_NOTHING_ACTIONED | Nothing actioned |
| 61 | TRANDEF_INV_BOTHTOAS | TO_CSDGROUP and AS_RESOURCE are mutually exclusive |
| 62 | TRANDEF_INV_NOTTOAS | Either TO_CSDGROUP or AS_RESOURCE is required |
| 63 | TRANDEF_CSD_ERROR | CSD access error |
| Name | Datatype | Source | Len | Req | Sum | Description | Default | Value Range | Get Invalid | Attr ID |
|---|---|---|---|---|---|---|---|---|---|---|
| ALIAS | CHAR | CPSM | 4 | No | DIFF | Alias name for transaction | 9 | |||
| BREXIT | CHAR | CPSM | 8 | No | DIFF | Bridge exit name | 61 | |||
| CHANGEAGENT | CVDAS | CPSM | 4 | No | LIKE | Last modification agent | E640 E650 | 66 | ||
| CHANGEAGENT Input/output valid values | DREPAPI | |||||||||
| CHANGEAGREL | CHAR | CPSM | 4 | No | DIFF | Last modification agent release | E640 E650 | 68 | ||
| CHANGETIME | DATETIME | CPSM | 8 | Yes | MAX | Last modification time | 1 | |||
| CHANGEUSRID | CHAR | CPSM | 8 | No | DIFF | Last modification user ID | E640 E650 | 67 | ||
| CMDSEC | EYUDA | CPSM | 4 | Yes | LIKE | Command level security option | NO | 16 | ||
| CMDSEC Input/output valid values | YES, NO | |||||||||
| CONFDATA | EYUDA | CPSM | 4 | No | LIKE | Suppress user data in trace entries | NO | 55 | ||
| CONFDATA Input/output valid values | YES, NO | |||||||||
| CREATETIME | DATETIME | CPSM | 8 | Yes | MAX | Time created | 56 | |||
| CSDGROUP-3 | CHAR | CPSM | 8 | Yes | DIFF | CSD group | E640 E650 | 70 | ||
| DEFVER-2 | BINARY | CPSM | 1 | Yes | AVG | Version | 0 | 0-15 | 5 | |
| DESCCODEPAGE | BINARY | CPSM | 4 | No | DIFF | Description code page | 37 | 0-99999999 | 65 | |
| DESCRIPTION | CHAR | CPSM | 58 | No | DIFF | Description | 60 | |||
| DTIMOUT | CHAR | CPSM | 4 | No | DIFF | Deadlock timeout value | NO | 1-6800 | 41 | |
| DTIMOUT Input/output valid values | NO | |||||||||
| DUMP | EYUDA | CPSM | 4 | Yes | LIKE | Transaction dump option | YES | 37 | ||
| DUMP Input/output valid values | YES, NO | |||||||||
| DYNAMIC | EYUDA | CPSM | 4 | Yes | LIKE | Dynamic routing option | NO | 38 | ||
| DYNAMIC Input/output valid values | YES, NO | |||||||||
| EXTSEC | EYUDA | CPSM | 4 | No | LIKE | External security manager option | N_A | E330+ | 50 | |
| EXTSEC Input/output valid values | YES, NO, N_A | |||||||||
| FAILACTION | CVDAS | CPSM | 4 | No | LIKE | CICS failure action | BACKOUT | 14 | ||
| FAILACTION Input/output valid values | BACKOUT, COMMIT | |||||||||
| INDOUBT | CVDAS | CPSM | 4 | No | LIKE | In-doubt failure processing action | BACKOUT | E510+ | 15 | |
| INDOUBT Input/output valid values | BACKOUT, COMMIT, WAIT | |||||||||
| ISOLATE | EYUDA | CPSM | 4 | Yes | LIKE | Transaction isolation option | YES | 36 | ||
| ISOLATE Input/output valid values | YES, NO | |||||||||
| LOCALQ | EYUDA | CPSM | 4 | No | LIKE | Queueing on local system | N_A | 22 | ||
| LOCALQ Input/output valid values | YES, NO, N_A | |||||||||
| NAME-1 | CHAR | CPSM | 8 | Yes | DIFF | Name | 7 | |||
| OTSTIMEOUT | CHAR | CPSM | 6 | Yes | DIFF | Object transaction service (OTS) timeout (HHMMSS) | NO | 64 | ||
| PARTITIONSET | CHAR | CPSM | 8 | No | DIFF | Default application partition set | 34 | |||
| PRIMEDSIZE | CHAR | CPSM | 8 | No | DIFF | Primed storage allocation | 0 | 0-65520 | E330+ | 49 |
| PRIORITY | CHAR | CPSM | 4 | No | DIFF | Transaction priority | 1 | 0-255 | 39 | |
| PROFILE | CHAR | CPSM | 8 | No | DIFF | Transaction profile | DFHCICST | 13 | ||
| PROGRAM | CHAR | CPSM | 8 | No | DIFF | First program name | 10 | |||
| REMOTENAME | CHAR | CPSM | 8 | No | DIFF | Remote transaction name | 11 | |||
| REMOTESYSTEM | CHAR | CPSM | 4 | No | DIFF | Remote system name | 12 | |||
| RESSEC | EYUDA | CPSM | 4 | Yes | LIKE | Resource security checking | NO | 23 | ||
| RESSEC Input/output valid values | YES, NO | |||||||||
| RESTART | EYUDA | CPSM | 4 | Yes | LIKE | Transaction restart facility | NO | 25 | ||
| RESTART Input/output valid values | YES, NO | |||||||||
| ROUTABLE | EYUDA | CPSM | 4 | Yes | LIKE | Dynamic routing status | NO | 63 | ||
| ROUTABLE Input/output valid values | YES, NO | |||||||||
| RSL | CHAR | CPSM | 8 | No | DIFF | Resource security value | 0 | 0-24 | E330+ | 54 |
| RSL Input/output valid values | PUBLIC | |||||||||
| RSLC | EYUDA | CPSM | 4 | No | LIKE | Resource security level check | NO | E330+ | 53 | |
| RSLC Input/output valid values | YES, NO | |||||||||
| RUNAWAY | CHAR | CPSM | 8 | No | DIFF | Runaway timeout value | SYSTEM | 0-2700000 | 40 | |
| RUNAWAY Input/output valid values | SYSTEM | |||||||||
| SECURE | EYUDA | CPSM | 4 | No | LIKE | Operator sign-on required | YES | EALL | 51 | |
| SECURE Input/output valid values | YES, NO | |||||||||
| SHUTDOWN | CVDAS | CPSM | 4 | Yes | LIKE | Shutdown run status | DISABLED | 17 | ||
| SHUTDOWN Input/output valid values | ENABLED, DISABLED | |||||||||
| SPURGE | EYUDA | CPSM | 4 | Yes | LIKE | System purgeable option | YES | 26 | ||
| SPURGE Input/output valid values | YES, NO | |||||||||
| STATUS | CVDAS | CPSM | 4 | Yes | LIKE | Enabled status | ENABLED | 18 | ||
| STATUS Input/output valid values | ENABLED, DISABLED | |||||||||
| STORAGECLEAR | EYUDA | CPSM | 4 | Yes | LIKE | Storage clearance status | NO | 24 | ||
| STORAGECLEAR Input/output valid values | YES, NO | |||||||||
| TASKDATAKEY | CVDAS | CPSM | 4 | Yes | LIKE | Task data key | USER | 19 | ||
| TASKDATAKEY Input/output valid values | USER, CICS | |||||||||
| TASKDATALOC | CVDAS | CPSM | 4 | Yes | LIKE | Task data location | ANY | 20 | ||
| TASKDATALOC Input/output valid values | BELOW, ANY | |||||||||
| TASKREQ | CHAR | CPSM | 4 | No | LIKE | Transaction initiation | 21 | |||
| TCLASS | CHAR | CPSM | 4 | No | DIFF | Transaction class number | NO | 1-10 | E410+ | 32 |
| TCLASS Input/output valid values | NO | |||||||||
| TPNAME | CHAR | CPSM | 64 | No | DIFF | APPC partner transaction name | 46 | |||
| TPURGE | EYUDA | CPSM | 4 | Yes | LIKE | Purgeable for terminal error option | YES | 27 | ||
| TPURGE Input/output valid values | YES, NO | |||||||||
| TRACE | EYUDA | CPSM | 4 | Yes | LIKE | Trace transaction activity option | YES | 29 | ||
| TRACE Input/output valid values | YES, NO | |||||||||
| TRANCLASS | CHAR | CPSM | 8 | No | DIFF | Transaction class name | DFHTCL00 | 31 | ||
| TRANSEC | CHAR | CPSM | 4 | No | DIFF | Transaction security value | 1 | 1-64 | E330+ | 48 |
| TRPROF | CHAR | CPSM | 8 | No | DIFF | Transaction routing profile | DFHCICSS | 30 | ||
| TWASIZE | CHAR | CPSM | 8 | No | DIFF | Size in bytes of transaction work area (TWA) | 0 | 0-32767 | 33 | |
| USEALTSCRSIZ | EYUDA | CPSM | 4 | No | LIKE | Use alternate screen size | NO | EALL | 52 | |
| USEALTSCRSIZ Input/output valid values | YES, NO | |||||||||
| USERDATA1 | CHAR | CPSM | 8 | No | DIFF | User data area 1 | 57 | |||
| USERDATA2 | CHAR | CPSM | 8 | No | DIFF | User data area 2 | 58 | |||
| USERDATA3 | CHAR | CPSM | 8 | No | DIFF | User data area 3 | 59 | |||
| WAIT | EYUDA | CPSM | 4 | Yes | LIKE | In-doubt wait option | YES | 28 | ||
| WAIT Input/output valid values | YES, NO | |||||||||
| WAITTIMEDD | CHAR | CPSM | 3 | No | DIFF | In-doubt wait time (days) | 0 | 0-99 | 42 | |
| WAITTIMEHH | CHAR | CPSM | 2 | No | DIFF | In-doubt wait time (hours) | 0 | 0-23 | 43 | |
| WAITTIMEMM | CHAR | CPSM | 2 | No | DIFF | In-doubt wait time (minutes) | 0 | 0-59 | 44 | |
| XTPNAME | CHAR | CPSM | 128 | No | DIFF | Alternate partner transaction name (in hex) | 47 | |||
| XTRANID | CHAR | CPSM | 8 | No | DIFF | Alternate name (in hex) for initiating transaction | 35 | |||