ECI and CICS transaction IDs

The transaction ID of the mirror transaction for an ECI call can be controlled through the parameters TPNName and TranName.

Specify TPNName to change the name of the CICS® mirror transaction that the called program will run under. For example, you can specify TPNName if you need a transaction definition with different attributes from those defined for the default mirror transaction. This option is like the TRANSID option on an EXEC CICS LINK command. The transaction ID is available to the server program in the EXEC interface block (EIB). You must define a transaction on the CICS server for this transaction ID that points to the DFHMIRS program. Note that TPNName takes precedence if both TranName and TPNName are specified. If neither TPNName nor TranName is specified, the ECI Program Link call is attached to the default mirror transaction on the server. The default mirror transaction is CSMI.

If TranName is specified, the called program runs under the default mirror transaction, but is linked to under the TranName transaction ID. This name is available to the called program in the (EIB) for querying the transaction ID.

Table 1 shows the name of the CICS mirror transaction and the name stored in EIBTRNID in the EIB according to whether or not TPNName and TranName are specified.
Table 1. Specifying TPNName and TranName
TPNName specified TranName specified Mirror transaction name Name in EIBTRNID
Y Y TPNName TPNName
Y N TPNName TPNName
N Y default TranName
N N default default

Information Information

Feedback


Timestamp icon Last updated: Wednesday, 27 August 2014


https://ut-ilnx-r4.hursley.ibm.com/tgzos_latest/help/topic/com.ibm.cics.tg.zos.doc//progguide/topics/dfhp8eci.html