How to use buztool to create new Component Versions in IBM UrbanCode Deploy to support Mainframe Deployments

Author: Randy Langehennig

Overview

In this video, you will learn how to create new component versions in IBM UrbanCode Deploy (now DevOps Deploy) that support mainframe deployments.   For the mainframe, UrbanCode Deploy (UCD) component versions are always of type “incremental”.

You may be familiar with the “udclient” command that is used to make REST API calls to the IBM UrbanCode Deploy Server.   This command line client helps you to create new component versions to support deployments in the “open systems” world.  For the mainframe, we have provided another command line client that is called “buztool” and it is installed and available as part of the IBM UrbanCode Deploy Agent installation on the mainframe.

You will find the “buztool.sh” script in your ${agent-installation-root}/bin folder as shown below:

The video will show you an example of how to use the buztool command to create a new component version using a “shiplist.xml” which describes the artifacts to be deployed.   Here is an example of a shiplist.xml file:

On line 3, you see the dataset name and the type of dataset which is “PDS”.   On line 4, it specifies the “member” to be deployed that is inside the dataset you provided.  On line 7, you see an easier way to specify all the members inside a dataset using a “*” wildcard.

To run the buztool, here is the command example:

    # ./buztool.sh createZOSVersion -c zOS-Component -s /opt/ibm/ucd/agent/zossamples/my_shiplist.xml

The buztool command does leverage an authentication token that you create in the IBM UrbanCode Deploy web console to authenticate before it creates the new component version.   You will have to create a token, and then edit the “installed.properties” file for your agent installation under ${agent-installation-root}/conf/agent.   Edit the “server.token=” line to include the authentication token value and then save your changes. 

The end result is:

If you login to the IBM UrbanCode Deploy web console, you will find the new component version as shown below:

If you examine the contents of this version, you will see the PDS datasets and the members you specified as shown below:

Congratulations!   Of course, the buztool command line can be incorporated into a build process to do this automatically.

Link to the Video

Please go here to learn more:  how-to-use-buztool

#UrbanCodeDeploy