The IBM z/OS Provisioning Toolkit V1.1 (z/OS PT) is a command-line utility for UNIX System Services (USS) that leverages the IBM Cloud Provisioning and Management templates to give application developers access to self-service provisioning and deprovisioning of an Information Management System Database Manager/Transaction Manager (IMS DB/TM) system in minutes. The following instructions will help get you set up z/OS PT and use it to provision a new IMS DB/TM instance–historically called IMS Database Manager/Data Communications (DB/DC).

Download and install z/OS PT

You can download z/OS PT from the z/OS Provisioning Tookit website.
The downloaded zip file contains license information along with a readme and a .pax file. The .pax file contains the z/OS PT runtime binaries. The .pax file needs to be transferred in binary format to the target system where z/OS PT will run. Follow the detailed instructions in the Knowledge Center to complete the installation and configuration of z/OS PT.

Download IMS z/OSMF templates

To download and configure the IMS z/OSMF templates, follow the IMS DB/TM tutorial on GitHub.

Contents of IMS DB/TM tutorial on GitHub
Contents of IMS DB/TM tutorial on GitHub

Create an IMS template

You need to create an IMS template by using the z/OSMF Cloud Provisioning Software Services. This template will be used by z/OS PT when you build the image. Follow the detailed instructions in the Knowledge Center to create and configure Cloud Provisioning and Management template for z/OS PT.

In this tutorial, we will be using the following values:

  • Template source file: /u/bpanyar/zospt/workflows/ims/ims.mf
  • Template name: zosptimsprov
  • Domain: default
  • Tenant: default

Create a zosptfile

Before you can build a z/OS PT image, you need to create a file called zosptfile to define the base image and corresponding IMS provisioning template. In this example, you will create a base image (from scratch) with the IMS provisioning template that you created in the previous step (ENV_ZOSMF_TEMPLATE=zosmptimsprov):

Note: The zosptfile must be encoded in UTF-8.

Contents of zosptfile
Contents of zosptfile

Build an IMS z/OS PT image

  1. Use the zospt build command to build a new image:
    zospt build -t [imageName] [directory path of zosptfile]

    In this case, the command gives the z/OS PT image a name of zospt_ims_demo and the zosptfile exists in /u/bpanyar/zospt/samples/ims.

    zospt build -t zospt_ims_demo /u/bpanyar/zospt/samples/ims

    Build a new imsage called zospt_ims_demo
    Build a new imsage called zospt_ims_demo
  2. Verify that the image zospt_ims_demo was successfully built by running the command: zospt images.
    Verify using zospt images
    Verify using zospt images

Run the IMS z/OS PT image

  1. Issue the zospt run command to run the newly built image zospt_ims_demo, which will provision a new IMS instance using the zosptimsprov template that you previously created. You should see an output for each workflow step defined in the template (There is also a --draft option on the zospt run command to run the image if the template is in Draft approved state within Cloud Provisioning).
    After the provisioning of the IMS instance has completed, a message that the container has been created along with the container name is displayed.

    Provision a new IMS instance using zospt run
    Provision a new IMS instance using zospt run
  2. Issue the zospt ps command to display the currently running containers and verify that the container IMS_DD03 was brought up successfully.
    Verify that the IMS instance was provisioned successfully
  3. Verify that IMS and IMS Connect is up and running by viewing the syslog. See the IMS CONNECT READY message in the syslog.
    VVerify that IMS and IMS Connect is up and running
    Verify that IMS and IMS Connect is up and running
  4. Stopping and starting the z/OS PT container

    Use the zospt stop and zospt start commands to start and stop the provisioned instance respectively. Running these commands will invoke the template’s stop and start actions.

    Stop the provisioned instance
    Stop the provisioned instance
    Start the provisioned instance
    Start the provisioned instance

    Deprovision the IMS instance

    To deprovision the IMS instance and delete the z/OS PT container, issue the command zospt rm IMS_DD03 -f. The completed deprovisioning workflow steps will be displayed and, as a result, all of the allocated data sets and resources will be deleted.

    Deprovision the IMS instance

    Summary

    In this short tutorial, you should now know how to install and use z/OS PT to provision a new IMS DB/TM system and how to issue various z/OS PT commands to invoke actions on the provisioned IMS instance.

    To find out more information about the IBM z/OS PT or z/OSMF Cloud Provisioning and Management, visit:
    Introducing the IBM z/OS Provisioning Toolkit
    IBM z/OS Provisioning Toolkit Knowledge Center
    IBM Cloud Provisioning and Management

Join The Discussion

Your email address will not be published. Required fields are marked *