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.

The following actions are supported:
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
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(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
Table 2. TRANDEF FEEDBACK error codes
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
Table 3. TRANDEF resource table attributes
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