LU 6.2 API Application Programmer's Reference Guide (30294-90008)

214 AppendixF

Migrating Transaction Programs

TPs In Transact

MPE XL Node Manager’s Guide for information on TP conﬁguration.

The remote TP must send this conﬁgured TP name in the allocate

request. In older versions of LU 6.2 API, the remote TP sends the

name of the job ﬁle that runs the local TP. In order to avoid changing

the remote TP, make the conﬁgured TP name (and the

LocalTPName

parameter) match the job ﬁle name.

4. If you want your TPs to receive multiple (queued) allocate requests

from remote TPs, modify them to call the MCGetAllocate intrinsic

multiple times — once for each allocate request.

You can write a TP to receive a predetermined number of allocate

requests, or you can write it to loop through the conversation

intrinsics, from MCGetAllocate to MCDeallocate, until no more

allocate requests arrive from the remote system. (See the

MCGetAllocate intrinsic description in Chapter 5 , “Intrinsic

Descriptions.”)

A time-out value for the MCGetAllocate intrinsic may be conﬁgured

through NMMGR. If no allocate request arrives from the remote TP

before the time-out value expires, the MCGetAllocate intrinsic

returns with a status info value of +29. If you want your TP to

receive an unknown number of allocate requests, you can design it to

loop through the conversation intrinsics until +29 is returned in the

Status

parameter of the MCGetAllocate intrinsic. See the APPC

Subsystem on MPE XL Node Manager’s Guide for information on

conﬁguring the time-out value.

TPs In Transact

On MPE V, TPs written in Transact must pass a parameter mask in

each intrinsic call, telling the intrinsic which parameters are being

passed and which are being omitted. When you migrate a Transact TP

from MPE V to MPE XL, you must remove the parameter mask from all

intrinsic calls. The parameter mask is described in Appendix E ,

“Transact Parameter Masks.”