Start of change

Installing SOAP Gateway on one mount point

Use the provided installation roadmap to guide your installation. Installation must be completed by a system programmer who is familiar with installation tasks on z/OS®.

  • You must have gone through the SMP/E process by following the instructions in the Program Directory.
  • The IBM® Installation Manager instance must be able to access the file system where the SOAP Gateway repository file is located.
Use the following installation roadmap to guide your installation.
Table 1. Roadmap for installing and configuring SOAP Gateway on z/OS
Step Description of task
1 Configure the SOAP Gateway installation properties file, installVars.properties, to specify all the variable values that are required to install, configure, and start SOAP Gateway.
2 Run the SGWInstall.jar script to generate the installation and configuration jobs based on the variable values that are defined in the properties file.
3 Submit the generated jobs in sequence.
4 Ensure that the user that starts the SOAP Gateway server is set up for RACF. See Defining the OMVS segment and user ID to set up RACF for the SOAP Gateway started task for more information.
5 Start the SOAP Gateway server to check if the installation is successful.
To start the server, use the z/OS START command:
/START AEWIOGPR
The IOG30001I message is displayed, indicating that the server is up and running.
6 Configure IMS Connect for SOAP Gateway.

IMS Connect manages the translation of message headers on input and output messages and provides a point of control to modify, route, and check security for messages from and to SOAP Gateway.

7 Verify the installation by using the SOAP Gateway Installation Verification Program (IVP).
8 (Optional) Configure SOAP Gateway , such as the server port numbers or the log file location.
9 (Optional) If you are upgrading from IMS Enterprise Suite Version 3.1 SOAP Gateway, migrate your web services. See Migrating from IMS Enterprise Suite Version 3.1 SOAP Gateway.
10 (Optional) Clone the SOAP Gateway server.
11 (Optional) Install multiple SOAP Gateway server instances that share one JVM.
End of change