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:
- 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.
-
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
- 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
-
Start the SOAP Gateway server.
Use the z/OS
START command:
/START AEWIOGPR
Wait until the IOG30001I
message displays.
- Run the IVP:
- 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.
- 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.