Checking that z/OS Connect is correctly set up

How you check that z/OS® Connect is correctly set up.


Before you begin

Ensure that we have carried out the procedure detailed in Enabling z/OS Connect and the MQ Service Provider


z/OS Connect provides a RESTful API that can be used to query the services that are installed and perform administrative actions such as stopping and starting them.


Procedure

  1. Issue an HTTP GET against z/OS Connect to query the list of currently installed services. You do this with a web browser by entering a URL of the form 
    https://HOST_NAME:HTTPS_PORT/zosConnect/services
    where HOST_NAME and HTTPS_PORT are the values you entered in step 1 of Install IBM z/OS Connect EE.For example, 
    https://yourdomainname:12342/zosConnect/services
  2. Enter the user ID and password when prompted by the browser. These are the values you entered in the user element in step 2 of Enabling z/OS Connect and the MQ Service Provider.


Results

This results in the following JSON response, indicating that z/OS Connect is running, but has not got any services installed. Note, that if an existing z/OS Connect server was used, which had services installed, then those services would be displayed.
________________________________________
{ 
   "zosConnectServices":[    ]
}
________________________________________


What to do next

Set up a simple one way IBM MQ service on z/OS Connect EE.