Test HA for connections to IBM z/OS Connect

Test the HA configuration and validate that it is distributing work across both servers.

Procedure

  1. Start up both IBM z/OS Connect servers.
  2. Invoke an API to send a request to your System of Record (SoR).
    1. For CICS users, invoke the catalog API from the z/OS Connect API toolkit by using the "Try it out!" function in the Swagger UI that is embedded in the editor, as described in Test the CICS catalog manager API.
    2. For IMS users, invoke the contacts API from the z/OS Connect API toolkit by using the "Try it out!" function in the Swagger UI that is embedded in the editor, as described in Test the IMS contacts API.
  3. Your request to your SoR should have been successful, but which IBM z/OS Connect server did it use? There are various ways we could ascertain which server was used, but the simplest way is:
    1. Shut down IBM z/OS Connect server 1.
    2. Invoke your API again. This should be successful and use IBM z/OS Connect server 2.
    3. Restart IBM z/OS Connect server 1.
    4. Shut down IBM z/OS Connect server 2.
    5. Invoke your API again. This should be successful and use IBM z/OS Connect server 1.
    6. Restart IBM z/OS Connect server 2.

Results

You have verified that your two IBM z/OS Connect servers have been configured and successfully work in a high availability environment.

What to do next

For CICS users, follow the steps in Configure HA for connections into CICS to configure HA for connections into CICS.

For IMS users, see IMS and IMS Connect high availability for information about configuring HA for connections into IMS.