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 following actions are supported:

INSTALL
Install a Transaction Definition.

The parameter data for the INSTALL action is described in Parameters for installing CICS Definitions.

Length
Start of change544End of change
Usage
API or Batch Utility
API view
No
CMAS context
No
SCOPE applies
No
Only query CMASs in workload
No
Object type
CICS Definition
Copybook identifier
EYUt3813 or TRANDEF
Valid API operations
GET CREATE UPDATE REMOVE and PERFORM
Parameters
GET
[RESGROUP] [CICSSYS]
CREATE
[RESGROUP]

API Actions

INSTALL
Install

PARM(' [NOTIFY(value)] USAGE(value) [FORCEINS(value)] [STATECHK(value)] [MODE(value)] [OVERTYPE(value)] [OVERRIDE(override)] TARGET(value) [RELATED(value)] .')

ADDTOGRP
Add to resource group

PARM(' [ERRQUEUE] RESGROUP(value) .')

Table 466. TRANDEF FEEDBACK error codes
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
Table 467. TRANDEF resource table attributes
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
[[ Contents Previous Page | Next Page Index ]]