Verifying the installation of SOAP Gateway and connection to IMS

To verify the installation of SOAP Gateway and connection to IMS, use the SOAP Gateway Installation Verification Program (IVP).

The SOAP Gateway IVP is a web service that is installed with SOAP Gateway. The IVP verifies the installation when you successfully access the target IMS environment. The IVP does not require a host IMS application.

To verify the installation:

  1. Update the connection bundle properties for use by the IVP to connect to your target IMS.
    The connection bundle contains information about the IMS host system, port number, and data store in order for SOAP Gateway to connect to the backend IMS system. The SOAP Gateway management utility provides a command to update the connection bundle.
    1. Change the directory to the install_dir/imsserver/deploy directory where the SOAP Gateway management utility is located.
      cd -PathPrefix-/usr/lpp/ims/imses/V3R2/soap_gw/deploy
    2. Update the connection bundle called imssoapivp. The connection bundle imssoapivp is provided with the SOAP Gateway IVP, but you must update it for the correct host name, port number and data store in your environment. Use the SOAP Gateway management utility iogmgmt -conn -u command.

      The following example demonstrates how to update (-u) the named connection bundle (-n) with the new host name (-h), port number (-p), and data store (-d).

      ./iogmgmt -conn -u -n imssoapivp -h YourHost -p YourIMSConnectPort -d YourDataStore
  2. Start the SOAP Gateway server.
    Use the z/OS START command:
    /START AEWIOGPR

    Wait until the IOG30001I message displays.

  3. Run the IVP:
    1. From a web browser, enter a URL in the following format to invoke the SOAP Gateway IVP web client.
      http://hostname:port/imssoap/imssoapivp.html

      The hostname is the host name of the target system and port is the port number where SOAP Gateway is running. The default port number is 8080.

      Tip: If you invoke the IVP from the same workstation where SOAP Gateway is installed, you can use the default port number. The URL is http://localhost:8080/imssoap/imssoapivp.html.
    2. Click Submit.
      The IVP is run successfully if you see one of the following messages:
      • DFS058I hh:mm:ss START COMMAND COMPLETED
      • DFS1292E SECURITY VIOLATION

      The objective of the IVP is to receive a message from IMS in reply to the /STA OTMA command. One of these messages is returned, depending on the level of security checking in place for your installation, and whether the user name, password, or group name is permitted to issue the /STA command. Either message indicates successful execution of the IVP, because IMS issues the DFS message. The IVP does not run an IMS application program, nor verify that IMS transactions can run successfully. It only verifies that the path to IMS is available.

If you are upgrading from IMS Enterprise Suite Version 3.1 SOAP Gateway, see Migrating from IMS Enterprise Suite Version 3.1 SOAP Gateway.