Scenario: getting started with the container images
This scenario covers everything that you need to know to get started with the CICS® TS resource builder container images. The CICS TS resource builder container images can be used on OCI-compliant container environments including the IBM® z/OS® Container Platform (zOSCP). The container images allow the CICS TS resource builder to be integrated into your automation or developer workflows without having to download and install a zip file, or install prerequisite software.
To run CICS TS resource builder in a container, you pull the CICS TS resource builder container images, verify the signatures, and run the container images by using Podman. The CICS TS resource builder container works identically to the CICS TS resource builder outside of the container and regardless of which of the images you choose, but the way you download and run the tool is different. You supply your own configuration files to CICS TS resource builder, and receive any output that is generated from the container when running the container. This information is passed into the container by mounting directories from the host system (z/OS or Linux®) into the container by using the -v (--volume) option.
The following table shows the available CICS TS resource builder container images:
| Image name | Location | Operating System |
|---|---|---|
| cics-resource-builder-zos | icr.io/ibm-cics-ts/cics-resource-builder-zos | z/OS |
| cics-resource-builder-ubi8 | icr.io/ibm-cics/cics-resource-builder-ubi8 | Linux (AMD64) |
Steps
The following steps show the recommended workflow for getting started with the CICS TS resource builder container images:
- Pull the container images to your local system, and push them to your internal registry for others to access them. For more information, see Planning for the CICS TS resource builder container images.
- Optional: The CICS TS resource builder container images are signed. You can verify the CICS TS resource builder container images signature. For more information, see Planning for the CICS TS resource builder container images.
- Run CICS TS resource builder in a container by using the podman run command, and pass the container input and output directories, and the build command, for example generate, build, or import. For more information, see Using the CICS TS resource builder container images.
- Build a DFHCSDUP file, that uses the example YAML files for the resource model and resource definitions, in a running containerized instance of CICS TS resource builder. See Tutorial: building a DFHCSDUP file using the CICS TS resource builder images.