DEFTRNID
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, and then take the following steps:
- Create TESTEXEC in the RFS or in a VSE Librarian sublibrary.
- Under REXX/CICS REXXTRY utility enter command DEFTRNID XYZ TESTEXEC and exit the REXXTRY utility.
- Under RDO, issue CEDA DEFINE TRAN(XYZ) PROGRAM(CICREXD) TWASIZE(32)
GROUP(REXXCICS) and install TRAN(XYZ) GROUP(REXXCICS). Note: TWASIZE is required on CEDA define
- Clear the screen and type CICS transaction identifier XYZ and press ENTER. The TESTEXEC exec should now run.
Notes
- DEFTRNID definitions should usually be placed in the CICSTART exec that executes at REXX/CICS startup.
- The transaction ID has to be defined (by CEDA) to invoke the supplied CICREXD program.
