Starting the container by publishing all CICS TG exposed ports to random ports

Follow these steps to start CICS® TG container.

Start the CICS TG container using the docker run

It is mandatory to accept the terms of the IBM® CICS TG Container license before you start using the image. You can view the license terms by setting the ‘LICENSE=view’ environment variable when running the container. You can also view the license in a different language by setting the ‘LANG’ environment variable. To view the license, you must run the container in interactive mode so that the container does not start. To accept the license, you must set the ‘LICENSE=accept’ environment variable when you run the container.

docker run -d -p 2006:2006 -p 2810:2810 -e LICENSE=accept --name ctgcontainer ibm-cicstg-container-linux-x86:9.3

CICS TG container starts running using the preceding command in remote mode. The container has the following services provisioned:

  • CICS TG TCP handler port listening on 2006.
  • CICS TG Admin port listening on 2810.

    The docker run exposes port 2006 for connecting external CICS TG client applications and port 2810 for CICS TG administration.

Run ‘docker logs’ to retrieve the CICS TG logs and ‘docker ps’ output to verify that CICS TG container is running.

docker ps
Output of the docker ps command.
Characteristics of the Image

Following are the default characteristics of the docker image:

  • Liveness of container: A CICS TG container is alive as long as the Gateway daemon process is running.
  • Docker WORKDIR: ‘/work’ is the WORKDIR of the CICS TG container.
  • Docker USER: ‘cicstg’ is the docker user.
  • Docker HEALTHCHECK: CICS TG container is enabled with HEALTHCHECK command.
Note: Docker limits the default number of threads that can be created in a container to 4096. Based on your requirement for the number of threads in a container, you need to use --pids-limit option to increase the thread limit. For more information, see Docker documentation.