Adding the CICS Transaction Gateway agent to a client application

To record or virtualize requests in a CICS® Transaction Gateway Java™ client, you must add the CICS Transaction Gateway Agent that is provided with HCL Quality Server to the client application.

About this task

To add the CICS Transaction Gateway agent to the client application, do the following steps:

Procedure

  1. Download and extract the CICS Transaction Gateway exits package (IBMCICSTransactionGateway.zip) that is provided with HCL Quality Server into a location. For information about the package, see HCL OneTest™ API tool packages.
  2. Modify the classpath for the client application to include com.ibm.rational.rit.ctg.jar, which is located in the extracted CICSTransationGateway folder.
  3. Edit the registration.xml file, which is located in the same directory as the com.ibm.rational.rit.ctg.jar file. Verify that the server base-url attribute has the correct URL for an instance of HCL Quality Server. If necessary, correct the value.
  4. If you moved the com.ibm.rational.rit.ctg.jar file from its default installation location, do one of the following steps:
    • Copy the registration.xml file into the same directory as the com.ibm.rational.rit.ctg.jar file.
    • Specify the following Java system property when running the client application:

      -Dcom.ibm.rational.rit.registration=<location of registration.cicstg>

      where <location of registration.cicstg> is the full path to the registration.cicstg file.

Feedback