Loading a Docker image from a .tar file on the z/OS UNIX System Services file system

Load a Docker image from a .tar file on the z/OS®UNIX System Services file system by running the JCL job BIPXDLI.

About this task

You can load a Docker image from a .tar file on the z/OS UNIX System Services file system by running the JCL job BIPXDLI.

For more information about building your own image, see Building your own Docker image.

Procedure

To load a Docker image from a .tar archive in the z/OS UNIX System Services file system, complete the following steps:

  1. Set the environment variables in the environment file, STDENV. For more information, see Environment variables in STDENV and BIPENVS. You must set the zCX access environment variables and the environment variables that are specific to Loading a Docker image from a .tar file on the z/OS UNIX System Services file system. Specify the name and location of the .tar file that you want to load, by setting the environment variables ACE_DOCKER_IMAGE_TAR_DIR, and ACE_DOCKER_IMAGE_TAR_NAME.
    For example:
    ACE_DOCKER_IMAGE_TAR_DIR=/u/aceadmin
    ACE_DOCKER_IMAGE_TAR_NAME=ace-s390x.tar
  2. Customize the JCL job BIPXDLI as advised in the job comments. For more information, see Customizing the JCL.
  3. Submit the job BIPXDLI.

Results

The job BIPXDLI runs and the Docker image is loaded from the z/OS UNIX System Services file system into zCX, and is ready to use.

What to do next

You can then use either JCL or z/OS console commands to manage your integration servers and to run IBM App Connect Enterprise commands (with the naming convention mqsi*), as described in Administering IBM App Connect Enterprise on IBM z/OS Container Extensions (zCX) by using JCL and Administering IBM App Connect Enterprise on IBM z/OS Container Extensions (zCX) by using IBM z/OS console commands.