IBM SC34-5764-01 - Manual (Page 360)

DEFTRNID
Note: This is an authorized command.
DEFTRNID trnid execname
CLEAR
DEFTRNID is a region-wide authorized command that can be used to define the name of an exec to be
invoked for a particular CICS transaction identifier.
Operands
trnid
specifies a one to four character CICS transaction ID.
execname
specifies a 1 to 17 character REXX/CICS exec name, in the form: filename.filetype if it is in the REXX
File System. If the exec exists in a VSE Librarian sublibrary, this is the name (a member type of .proc
is assumed).
CLEAR
is a keyword indicating that the definition be removed for this transaction ID.
Return Codes
0 Normal return
1202 Invalid operand
1222 Invalid option
1223 Error storing trantable information
1225 Error retrieving trantable information
1226 Exec name length error
1228 Error setting trantable value
1233 Transaction not found in table
Example
Define a new CICS transaction ID named XYZ, make it call exec TESTEXEC when it is started, then take the
following steps:
1. Create TESTEXEC in the RFS or in a VSE Librarian sublibrary.
2. Under REXX/CICS REXXTRY utility enter command DEFTRNID XYZ TESTEXEC and exit the REXXTRY
utility.
3. Under RDO, CEDA DEFINE TRAN(XYZ) PROGRAM(CICREXD) TWASIZE(32) GROUP(REXXCICS) and install
TRAN(XYZ) GROUP(REXXCICS) .
Note: TWASIZE is required on CEDA define
4. Clear the screen and type CICS transaction identifier XYZ and press ENTER. The TESTEXEC exec
should now run.
Notes
1. DEFTRNID definitions should usually be placed in the CICSTART exec that executes at REXX/CICS
startup.
2. The transaction ID has to be defined (by CEDA) to invoke the supplied CICREXD program.
Commands
338 CICS TS for VSE/ESA: REXX Guide