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 RITIVP1, RITIVP2 and RITIVP3 files that are provided with the RIT.PROC.XMIT.BIN package.

Procedure

  1. Edit RITIVP1, RITIVP2 and RITIVP3 according to the comments in the file and submit each of the jobs sequentially.

    Ensure that you get 0 as the output for each job execution. This output indicates that the installation and configuration is correct.

    You can then proceed with the creation of MQ connections in the Rational® Integration Tester 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


Feedback