Verifying the setup for the IMS synchronous callout function

To verify that SOAP Gateway is set up property to pull IMS callout requests from IMS OTMA hold queues, update the provided connection bundle in SOAP Gateway, and run the provided IMS Installation Verification Program (IVP) jobs to issue a synchronous callout request.

See the prerequisites described in Verifying the setup for the consumer (callout) usage scenario.

To verify the proper setup for the IMS synchronous callout function:

In SOAP Gateway, update the imssoapcalloutivp connection bundle to specify the IMS host system, port number, and data store in your environment.
1. Navigate to the install_dir/imsserver/deploy directory.
2. Issue the following SOAP Gateway management utility command:
```
iogmgmt -conn -u -n imssoapcalloutivp -h YourHostName -p YourPortNumber
 -d YourDataStore -i  IVPPIPE6
```
  - The connection bundle named imssoapcalloutivp is provided with the SOAP Gateway installation. This connection bundle name is already specified in the callout web service that is automatically deployed when the SOAP Gateway server starts.
  - YourHostName is the name or IP address of the host system where IMS Connect is running.
  - YourPortNumber is the port number to access IMS Connect.
  - YourDataStore is the data store name.
  - The tpipe name must be set to IVPPIPE6. This tpipe name is specified in the OTMA destination description that is provided in the IMS callout IVP sample.
Start the SOAP Gateway server.
- On z/OS®, use the z/OS START command:
```
/S AEWIOGPR
```
Important: If the server is already started, you must restart the server for the changes to take effect.

Wait until the IMS Enterprise Suite SOAP Gateway server is now up and running message displays.
In IMS, run the IMS callout application by running job IV_S231J.
Job IV_S231J runs the JCL that uses the DFSDDLT0 test program to issue a DL/I ICAL call to send a message to tpipe IVPPIPE6. The callout request looks as follows:
```
ICAL  SENDRECV IVPDTOR6 001000 00028 00030
```
IVPDTOR6 is the OTMA destination descriptor name that is also provided by the IMS callout IVP sample.
The IVP callout application input is:
```
THIS IS A SYNCHRONOUS CALLOUT MESSAGE SENT FROM IMS
```

If you receive the following response message in the SOAP Gateway log, you have successfully issued a synchronous callout request from an IMS application, through SOAP Gateway, to an external web service. The SOAP Gateway imssoapcalloutivp web service returns:

HELLO FROM SOAP GATEWAY

Tips:

By default, the SOAP Gateway log file imssoap.log is stored in install_dir/imsbase/logs.
In this sample, the imssoapcalloutivp web service is hosted on the same SOAP Gateway server.