Verifying the configuration and installation of the API Exits

After you configure the IBM® WebSphere® MQ on IBM z/OS® and install the API Exits, you can verify if the configurations and the exits are installed correctly by running the installation verification jobs that are provided with the RIT.PROC.XMIT.BIN package. If you have set up HCL OneTest™ API to run with a single queue manager, use jobs RITIVP1, RITIVP2, and RITIVP3. If you have set up HCL OneTest API to run with a queue sharing group, use jobs RITIVP1G, RITIVP2G, and RITIVP3G.


  1. Edit the three jobs for your queue manager or queue sharing group according to the comments in the JCL and submit each of the jobs sequentially.
    Ensure that you get 0 as the return code for each job execution. This indicates that the installation and configuration is correct. You can then proceed with the creation of MQ connections in the HCL OneTest API and record the MQ traffic.
    Note: If there are errors in the verification steps, review the error code, reason code and resolve the errors before you continue.
  2. Optional: You can diagnose the problems by enabling the diagnosis option in the MQ exits. To enable the diagnosis option in the RITRUN JCL file and submit this file:
    1. Edit the RITRUN member in the user ID.RIT.PROC dataset.
    2. Remove the column 1 to 3 characters in the following lines:
      //*//*CEEOPTS  DD *                           
      //* ENVAR('RIT_DIAGNOSIS=1')                 
    3. Comment the original CEEOPTS DD line.
    4. Submit the job.
      • If RITRUN has been run as a JOB, use '/F RITJOB,STOP' command to stop the RITJOB and re-submit the RITRUN JCL.
      • If RITRUN has been run as a PROC, use 'F RITproc,STOP' or 'P RITproc' command to stop the RIT start PROC and 'S RITProc' to restart it.

What to do next