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 following actions are supported:
The parameter data for the INSTALL action is described in Parameters for installing CICS Definitions.
API Actions
PARM(' [NOTIFY(value)] USAGE(value) [FORCEINS(value)] [STATECHK(value)] [MODE(value)] [OVERTYPE(value)] [OVERRIDE(override)] TARGET(value) [RELATED(value)] .')
PARM(' [ERRQUEUE] RESGROUP(value) .')
Code | Description | Code | Description |
DIFF_VERSION | Different version | INV_RESTYPE | Invalid resource type |
EARLY_NAMELIST_END | Early name list end | INV_RSCOPE | Invalid related scope |
INCONSISTENT_SET | Inconsistent set condition | INV_STATECHK | Invalid state check |
INV_ACTION | Invalid action | INV_STRNGTERM | Invalid string terminator |
INV_ATTRIBUTE | Invalid attribute | INV_TSCOPE | Invalid target scope |
INV_CONTEXT | Context not found | INV_USAGE | Invalid usage |
INV_DATA | Attribute data invalid | INV_VER | Invalid resource version |
INV_EMBEDTERM | Invalid embedded terminator | MISSING_RELSYSID | Missing related system identifier |
INV_FORCEINS | Invalid force install | MORE_THAN_1_RELSYS | More than one related system |
INV_LITERAL | Invalid literal | NODEFS_SELECTED | No definitions selected |
INV_MINNAME | Invalid minor name | NON_MP | Maintenance point CMAS not available |
INV_MODE | Invalid mode | NOTHING_INSTALLED | Nothing installed |
INV_NAME | Invalid name | NOTIFY | Notify |
INV_NAMELIST | Invalid name list | NO_RELATED | No related systems |
INV_NOTIFY | Invalid notify | NO_TARGETS | No targets |
INV_ORSTGNA | Invalid override string | PARTIAL_INSTALL | Partial install |
INV_ORSTRING | Invalid override string | REC_CHANGED | Resource definition already changed |
INV_OVERTYPE | Invalid overtype | REC_EXISTS | Resource already exists |
INV_OVRBLOCK | Invalid override block | REC_NOT_FOUND | Requested resource not found |
INV_RECADDR | Invalid record address | SCOPE_CONFLICT | Scope conflict |
INV_RECLEN | Invalid record length | SCOPE_REQUIRED | Scope required |
INV_RESGROUP | Resource group not found | USAGE_CONFLICT | Usage conflict |
Name | Datatype | Source | Len | Req | Sum | Description | Default | Value Range | Attr ID |
---|---|---|---|---|---|---|---|---|---|
CHANGETIME | DATETIME | CPSM | 8 | Yes | MAX | Last time the definition was changed | 1 | ||
DEFVER-2 | BINARY | CPSM | 1 | Yes | AVG | Definition version | 0 | 0-15 | 5 |
NAME-1 | CHAR | CPSM | 8 | Yes | DIF | Transaction definition name | 7 | ||
ALIAS | CHAR | CPSM | 4 | No | DIF | Alias name for transaction | 9 | ||
PROGRAM | CHAR | CPSM | 8 | No | DIF | First program name | 10 | ||
REMOTENAME | CHAR | CPSM | 8 | No | DIF | Remote transaction name | 11 | ||
REMOTESYSTEM | CHAR | CPSM | 4 | No | DIF | Remote system name | 12 | ||
PROFILE | CHAR | CPSM | 8 | No | DIF | Transaction profile | DFHCICST | 13 | |
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 | 15 | |
INDOUBT Input/Output Valid Values | BACKOUT COMMIT WAIT | ||||||||
CMDSEC | EYUDA | CPSM | 4 | Yes | LIKE | Command level security option | NO | 16 | |
CMDSEC Input/Output Valid Values | YES NO | ||||||||
SHUTDOWN | CVDAS | CPSM | 4 | Yes | LIKE | Shutdown run status | DISABLED | 17 | |
SHUTDOWN Input/Output Valid Values | ENABLED DISABLED | ||||||||
STATUS | CVDAS | CPSM | 4 | Yes | LIKE | Enabled status | ENABLED | 18 | |
STATUS Input/Output Valid Values | ENABLED DISABLED | ||||||||
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 | BELOW | 20 | |
TASKDATALOC Input/Output Valid Values | BELOW ANY | ||||||||
TASKREQ | CHAR | CPSM | 4 | No | N/A | Transaction initiation | 21 | ||
LOCALQ | EYUDA | CPSM | 4 | No | LIKE | Queueing on local system | N_A | 22 | |
LOCALQ Input/Output Valid Values | YES NO N_A | ||||||||
RESSEC | EYUDA | CPSM | 4 | Yes | LIKE | Resource security checking | NO | 23 | |
RESSEC Input/Output Valid Values | YES NO | ||||||||
STORAGECLEAR | EYUDA | CPSM | 4 | Yes | LIKE | Storage clearance status | NO | 24 | |
STORAGECLEAR Input/Output Valid Values | YES NO | ||||||||
RESTART | EYUDA | CPSM | 4 | Yes | LIKE | Transaction restart facility | NO | 25 | |
RESTART Input/Output Valid Values | YES NO | ||||||||
SPURGE | EYUDA | CPSM | 4 | Yes | LIKE | System purgeable option | NO | 26 | |
SPURGE Input/Output Valid Values | YES NO | ||||||||
TPURGE | EYUDA | CPSM | 4 | Yes | LIKE | Purgeable for terminal error option | NO | 27 | |
TPURGE Input/Output Valid Values | YES NO | ||||||||
WAIT | EYUDA | CPSM | 4 | Yes | LIKE | In-doubt wait option | YES | 28 | |
WAIT 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 | ||||||||
TRPROF | CHAR | CPSM | 8 | No | DIF | Transaction routing profile | DFHCICSS | 30 | |
TRANCLASS | CHAR | CPSM | 8 | No | DIF | Transaction class name | DFHTCL00 | 31 | |
TCLASS | CHAR | CPSM | 4 | No | DIF | Transaction class number | NO | 1-10 | 32 |
TCLASS Input/Output Valid Values | NO | ||||||||
TWASIZE | CHAR | CPSM | 8 | No | DIF | Size in bytes of transaction work area (TWA) | 0 | 0-32767 | 33 |
PARTITIONSET | CHAR | CPSM | 8 | No | DIF | Default application partition set | 34 | ||
XTRANID | CHAR | CPSM | 8 | No | DIF | Alternate name (in hex) for initiating transaction | 35 | ||
ISOLATE | EYUDA | CPSM | 4 | Yes | LIKE | Transaction isolation option | YES | 36 | |
ISOLATE Input/Output Valid Values | YES 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 | ||||||||
PRIORITY | CHAR | CPSM | 4 | No | DIF | Transaction priority | 1 | 0-255 | 39 |
RUNAWAY | CHAR | CPSM | 8 | No | DIF | Runaway timeout value | SYSTEM | 0-2700000 | 40 |
RUNAWAY Input/Output Valid Values | SYSTEM | ||||||||
DTIMOUT | CHAR | CPSM | 4 | No | DIF | Deadlock timeout value | NO | 1-6800 | 41 |
DTIMOUT Input/Output Valid Values | NO | ||||||||
WAITTIMEDD | CHAR | CPSM | 3 | No | DIF | In-doubt wait time (days) | 0 | 0-93 | 42 |
WAITTIMEHH | CHAR | CPSM | 2 | No | DIF | In-doubt wait time (hours) | 0 | 0-23 | 43 |
WAITTIMEMM | CHAR | CPSM | 2 | No | DIF | In-doubt wait time (minutes) | 0 | 0-59 | 44 |
TPNAME | CHAR | CPSM | 64 | No | DIF | APPC partner transaction name | 46 | ||
XTPNAME | CHAR | CPSM | 128 | No | DIF | Alternate partner transaction name (in hex) | 47 | ||
TRANSEC | CHAR | CPSM | 4 | No | DIF | Transaction security value | 1 | 1-64 | 48 |
PRIMEDSIZE | CHAR | CPSM | 8 | No | DIF | Primed storage allocation | 0 | 0-65520 | 49 |
EXTSEC | EYUDA | CPSM | 4 | No | LIKE | External security manager option | N_A | 50 | |
EXTSEC Input/Output Valid Values | YES NO N_A | ||||||||
SECURE | EYUDA | CPSM | 4 | No | LIKE | Operator sign-on required | YES | 51 | |
SECURE Input/Output Valid Values | YES NO | ||||||||
USEALTSCRSIZ | EYUDA | CPSM | 4 | No | LIKE | Use alternate screen size | NO | 52 | |
USEALTSCRSIZ Input/Output Valid Values | YES NO | ||||||||
RSLC | EYUDA | CPSM | 4 | No | LIKE | Resource security level check | NO | 53 | |
RSLC Input/Output Valid Values | YES NO | ||||||||
RSL | CHAR | CPSM | 8 | No | DIF | Resource security value | 0 | 0-24 | 54 |
RSL Input/Output Valid Values | PUBLIC | ||||||||
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 | Definition create time | 56 | ||
USERDATA1 | CHAR | CPSM | 8 | No | DIF | User data area 1 | 57 | ||
USERDATA2 | CHAR | CPSM | 8 | No | DIF | User data area 2 | 58 | ||
USERDATA3 | CHAR | CPSM | 8 | No | DIF | User data area 3 | 59 | ||
DESCRIPTION | CHAR | CPSM | 58 | No | DIF | Definition description | 60 | ||
BREXIT | CHAR | CPSM | 8 | No | DIF | Bridge exit name | 61 | ||
ROUTABLE | EYUDA | CPSM | 4 | Yes | LIKE | Dynamic routing status | NO | 63 | |
ROUTABLE Input/Output Valid Values | YES NO | ||||||||
OTSTIMEOUT | CHAR | CPSM | 6 | Yes | DIF | Object transaction service (OTS) timeout (HHMMSS) | NO | 64 |