Deploying CICS TX Advanced on Docker or Podman

Understand how to deploy CICS TX Advanced on Docker or Podman and verify the deployment by running an installation verification program. Follow the steps in the same order. Follow the steps in the same order.

If you are using Podman for container management, replace the command docker with podman.

Load the images by completing the following steps:
1. Load the CICS TX image by using the following command:
```
docker load -i ibm-cics-tx-advanced-image-11.1.0.0.tar.gz
```
2. Verify that the image is loaded successfully by running the following command:
```
docker images | grep ibm-cics-tx-advanced
```
  The ibm-cics-tx-advanced image name is returned in the repository list.
Create a network to which to attach the containers by using the following command syntax. This example creates a network that is called ibm-cics-tx.
```
docker network create ibm-cics-tx
```
Verify the network is successfully created by using the following command:
```
docker network ls
```
The ibm-cics-tx network name is returned.
Start the CICS TX container by using the following sample docker run command. You must accept the terms of IBM CICS TX license before you start using the image. To accept the license, you must set the LICENSE=accept environment variable when you run the image. View the license terms by setting the LICENSE=view environment variable when running the image. To view the license in a different language, set the LANG environment variable.
```
docker run -p CICSTELD_TARGET_PORT:3270 \
-p IPIC_LISTENER_TARGET_PORT:1435 \
-itd -e LICENSE=accept --name=advanced-aor1 \
--network=ibm-cics-tx ibm-cics-tx-advanced:11.1.0.0
```
The command starts a CICS TX container that is running with the default region TXREGION and SFS Server TXSFS. The Docker image has the following features provisioned:
- An IPIC port listening on 1435.
- A CICSTELD port listening on 3270
Where:
CICSTELD_TARGET_PORT is the port that you want to map with the container’s 3270 port and IPIC_LISTENER_TARGET_PORT is the port that you want to map with the container’s 1435 port. For example:
```
docker run -p 3270:3270 -p 1435:1435 \
-itd -e LICENSE=accept --name=standard-aor2 \
ibm-cics-tx-advanced:11.1.0.0
```
Verify that CICS® TX Advanced is running by using the docker ps command.
The container ID, container name, ports, image name, and status of the container is returned.
Verify the deployment by installing the CICS TX Advanced Application and running the Installation Verification Program (IVP). To run the IVP, connect to a CICS TX region that uses a 3270 terminal by completing the following steps. The IVP is an employee management application that adds, modifies, browses, and deletes employee details. The application uses SFS as the file server for storing employee data in VSAM files.
1. From the 3270 terminal, connect to Host IP Address:3270
2. Run the MENU transaction. Use the following example to help you to understand how to use the IVP:
  In the ENTER TRANSACTION field, type ADDS.
  In the NUMBER field, enter an employee number, for example, 111111.
  Press Return. CICS TX displays the FILE ADD screen.
  In the FILE ADD screen, enter values into the fields as required. When you finish entering values into the fields, press Return. The IVP stores the user data in a VSAM file.
  Browse to the newly added record by entering BRWS in the ENTER TRANSACTION field.
  Enter the required employee number, for example, 111111, in the NUMBER field and press Return.
  The IVP sample completes successfully, confirming that the CICS TX Docker image is correctly installed and configured.