Configuring connections to IMS with Docker Desktop and Basic Authentication

Connect to IMS with Basic Authentication.

About this task

This topic is applicable to:

In this task, you create the IMS.xml file. This file uses the environmental variables that are defined in the docker-compose.yaml file as inputs for the IPIC connection when you start your container at run time.

With this configuration, the z/OS Connect Designer can use basic authentication to authenticate with IMS. It is assumed that the target IMS region is configured to expect basic authentication credentials. That is, USERAUTH(VERIFY) is specified on the IMS IPCONN resource.

Tip: This tutorial demonstrates Basic Authentication. For other security configuration, see Configuring security for IMS connections.

You provide your user ID and password, then z/OS Connect Designer passes your credentials to IMS for authentication.

1. In your text editor, create a file with the following content.

   <zosconnect_imsConnection id="imsConn"
           connectionFactoryRef="imsConnectionFactory"
           imsDatastoreName="IMS1"/>
   
       <connectionFactory id="imsConnectionFactory" containerAuthDataRef="IMSCredentials">
           <properties.gmoa hostName="${IMS_HOST}" portNumber="${IMS_PORT}" />
       </connectionFactory>
   
       <authData id="IMSCredentials" user="${IMS_USER}" password="${IMS_PASSWORD}" />

2. Save the file as ims.xml in the directory ZCWorkspace/PhonebookApi/src/main/liberty/config.
3. Verify that the new files and directories are listed correctly.
   The following screen image shows the resulting project structure:

   /ZCWorkspace
   |-- /certs
   |-- /logs
   |-- /PhonebookApi/src/main/liberty/config/ims.xml
   |-- docker-compose.yaml