This blog gives you an overview on how to run a MQ .NET Framework Application on docker containers.

Create Project Folder:

  1. Create a new folder by name “SimplePut”.
  2. Copy SimplePut.cs and SimplePut.csproj files to the SimplePut folder created in Step 1 from the following location:

  3. Remove the following line from SimplePut.csproj file
  4. Copy amqmdnetstd.dll file to the SimplePut folder created in Step 1 from the following location:

Create a DockerFile for MQ .NET Framework Application:

  1. Create a file by name “DockerFile” in SimplePut project folder which will be used as Dockerfile for sample application to build docker image.
  2. Add the below mentioned text to your DockerFile for Windows Containers as follows:
    FROM microsoft/windowsservercore
    COPY /bin/debug/ /root/
    ENTRYPOINT /root/SimplePut.exe

Build the Docker Image:

  1. Open command prompt to build the docker image.

  2. To verify whether docker is installed or not, issue the following command on command line as follows:
    docker -v
    Docker version 18.09.0, build 4d60db4
    If not, please install Docker for windows containers from Docker website.

  3. Navigate to your project folder and use the below command to build your Docker image.
    docker build -t simpleput .
    Note: Image_name should be lowercase alphabets.

  4. Docker image with simpleput will be successfully created. Output as follows:

    Sending build context to Docker daemon  2.381MB
    Step 1/3 : FROM microsoft/windowsservercore
    ---> 81d80198a492
    Step 2/3 : COPY /bin/debug/ /root/
    ---> Using cache
    ---> 5d81394da6f4
    Step 3/3 : ENTRYPOINT /root/SimplePut.exe
    ---> Using cache
    ---> f250db37f272
    Successfully built c9e02535kz8e
    Successfully tagged app:latest
  5. By issuing the following command, you can view the latest docker image created.

    docker images

  6. Output for the above command as follows:

simpleput latest c9e02535kz8e 35 seconds ago 1.54 GB

Running the Docker Image:

  1. Run the docker image by passing arguments as follows:
    docker run simpleput -qm Test1 -q Q1 -h 9.yyy.zzz.ww -p 1423
  2. Program will be putting messages successfully onto the queue which is mentioned as arguments.
    Start of SimplePut Application
    MQ Parameters
    1) queueName = Q1
    2) keyRepository =
    3) cipherSpec =  
    4) host = 9.yyy.zzz.ww 
    5) port = 1423
    6) channel = SYSTEM.DEF.SVRCONN
    7) numberOfMsgs = 1
    8) sslPeerName =
    9) keyResetCount = 0
    10) sslCertRevocationCheck = False
    Connecting to queue manager.. done 
    Accessing queue Q1.. done
    Message 1 <test message>.. put
    Closing queue.. done
    Disconnecting queue manager.. done
    End of SimplePut Application

Installing IBM MQ classes for .NET Standard

Join The Discussion

Your email address will not be published.