DEFTRNID

Note:
This is an authorized command.
Read syntax diagramSkip visual syntax diagram>>-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.