Using APPC to Communicate with Other Systems › APPC Link Definition Examples › Run a Qualified Transaction

Run a Qualified Transaction

A database query application runs between two domains SYSA and SYSB. The DBQUERY transaction is invoked from SYSA to send an attach request for DB01 to SYSB, where the NCL procedure DBQRY01 is run. A new version of this procedure (DBQRY01T) needs to be tested using TPN DB01TEST and the transaction qualifier TEST.

To use the APPC link to test the new NCL procedure

1. Define the qualifier TEST in the DLT entry in SYSA by issuing the following command:

   DEFLINK LINK=B LU=SYSB TYPE=APPC QUAL=TEST
   

   Ensure that you stop and restart the link to put this qualifier into effect.

2. Define the qualified entry in the TCT entry in SYSA by issuing the following command:

   DEFTRANS TRANSID=DBQUERY TPN=DB01TEST QUAL=TEST
   

3. Define a TCT entry in the remote system (SYSB) for the procedure being tested by issuing the following command:

   DEFTRANS TRANSID=DBQUERY TPN=DB01TEST PROC=DBQRY01T
   

4. Issue an allocation request for DBQUERY.

The existing unqualified TCT entry is used to resolve the name of the destination. The destination name is used to determine that the qualifier TEST is in effect (as defined in the DLT). The TCT entry for DBQUERY qualified by TEST is located and used to complete the allocation request. An attach request for DB01TEST is sent to SYSB where the TCT entry for DB01TEST is found and DBQRY01T is run.