Creating a connection bundle entry for callout applications

Create a connection bundle entry that describes the connection properties for accessing IMS by using the SOAP Gateway management utility. The connection bundle entries are stored in the connbundle.xml file.

You must create a new connection bundle entry or modify an existing connection bundle entry to specify the following properties:

The connection properties for IMS Connect
The names of the tpipes that hold the synchronous and asynchronous callout requests that are sent by your IMS application

If a response message is expected from the web service, you must either create an additional connection bundle entry or reuse an existing connection bundle entry to specify connection properties for sending the output response message. The connection bundle entry with the connection properties for the response message is specified separately from the connection bundle entry with the connection properties for the callout message. Each is specified with a separate entry in the callout correlator XML file. However, both sets of properties can be stored in the same connection bundle entry.

Gather the required information for the connection bundle entry.
A connection bundle entry for a callout application must contain the following information:
- Name for the connection bundle entry
- Name of the callout tpipe for the application
- IMS Connect host name
- IMS Connect listening port number (default is 9999)
- IMS Connect datastore name
Optional: To enable callout basic authentication, gather the following information:
- Callout basic authentication user ID
- Callout basic authentication password
This option configures SOAP Gateway to perform basic authentication with the target web service as part of a callout request.
Optional: To enable server SSL authentication for the callout request, gather the following information:
- Callout SSL truststore name
- Callout SSL truststore password
This option configures SOAP Gateway to confirm the identity of the server by verifying the information in the server truststore.
Optional: To enable client SSL authentication for the callout request, gather the following information:
- Callout SSL keystore name
- Callout SSL keystore password
This option configures SOAP Gateway to send the server a client certificate that the server can use to confirm the identity of the SOAP Gateway server. Server SSL authentication must also be configured in the connection bundle entry to use client SSL authentication.
Issue the iogmgmt -conn -c command to create the connection bundle entry.
Example 1. No security. The following example creates a connection bundle entry named connbundle1 that connects to an IMS Connect host named ICONHOST1 on port 9998 and that uses a callout tpipe named tpipe1. Security is not enabled.
```
iogmgmt -conn -c -n connbundle1 -h ICONHOST1 -p 9998 -d IMSSTOR1 -i tpipe1 
```
Example 2. Basic authentication. The following example creates a connection bundle entry named connbundle2 that connects to the IMSSTOR2 data store on an IMS Connect host named ICONHOST2 on port 9995. The callout tpipe is tpipe2. Basic authentication user ID and password is specified for basic authentication.
```
iogmgmt -conn -c -n connbundle2 -h ICONHOST2 -p 9995 -d IMSSTOR2 -i tpipe2
 -m basicAuthID  -b basicAuthPwd
```
Example 3. Client authentication and basic authentication. The following example creates a connection bundle entry named connbundle3 that connects to the IMSSTOR3 data store on an IMS Connect host named ICONHOST3 on port 9992. The callout tpipe is tpipe3. In addition to basic authentication, target keystore and truststore information is provided for client authentication.
```
iogmgmt -conn -c -n connbundle3 -h ICONHOST3 -p 9992 -d IMSSTOR3 -i tpipe3
-l callout_target_ks_name -y callout_target_ks_pwd 
-v callout_target_ts_name -q callout_target_ts_pwd
-m basicAuthID -b basicAuthPwd
```

A message indicates that the connection bundle entry is created.