Installing the z/OS deployment tools

Before you deploy to the IBM® z/OS® platform, you must install the z/OS deployment tools and configure the z/OS server for communication with IBM UrbanCode Deploy. If the build process runs on a different logical partition (LPAR), then you must additionally install the deployment tools on the build LPAR.

Procedure

  1. Click the Help icon, and then click Tools. The tools that are available for download from the IBM UrbanCode Deploy server are displayed.
  2. Download the z/OS deployment tools and the IBM UrbanCode Deploy client archive. Extract the archive file that contains the deployment tools to the UNIX file system of the z/OS server. For example, type the following text at the command line to extract the archive file: pax -r -pp -vf ucdtoolkit.zip.
  3. Create and run a job in job control language (JCL) that loads the SBUZENV, SBUZEXEC, SBUZMENU, and SBUZSAMP libraries. Use the sample BUZEXPD job in the tool_installation_directory/mvs directory as a model. Change #HLQ, #TVOLSER, and -PATH-PREFIX- as required for your system.
  4. Extract the archive file that contains the IBM UrbanCode Deploy client, and then copy the udclient.jar file to the tool_installation_directory/lib directory. If you copy the udclient.jar file over FTP, use binary mode.
  5. Create a repository directory in the UNIX file system of the z/OS server where you run builds. The repository directory is where the version artifacts are stored. Ensure that there is sufficient space for the repository directory and that the user who runs the z/OS deployment tools has read and write access to the directory.
  6. Create a token to use for secure communication between the IBM UrbanCode Deploy server and the z/OS server. In IBM UrbanCode Deploy, click Settings > Tokens > Create New Token. For more information, see Tokens.
  7. Update the property file. Open the high_level_qualifier.SBUZENV(BUZPROF) data set, and change the following values:
    Parameter Description
    java.home The location of the Java Runtime Environment (JRE)
    ucd.toolkit.usshome The deployment tools installation directory
    ucd.toolkit.mvshlq The high-level qualifier for toolkit z/OS libraries
    ucd.server.url The URL of the IBM UrbanCode Deploy server
    ucd.server.accesstoken The security token that you created previously
    ucd.repository The location of the repository directory
    For example, a property file might contain the following lines:
    #Thu Apr 03 15:07:08 EDT 2014
    java.home=/usr/lpp/java/J7.0_64
    ucd.toolkit.usshome=/usr/lpp/ucd/ucdtoolkit
    ucd.toolkit.mvshlq=BUZ.BUZ610
    ucd.repository=/usr/lpp/ucdtoolkit/repo
    ucd.server.url="https://192.0.2.0:8444"
    ucd.server.accesstoken="2f615f22-01d1-4d5f-99a5-a12f2c2968e4"
  8. Use the authorized program facility (APF) to authorize the checkaccess utility. In the /bin directory under the directory where you installed the deployment tools, type the following text at the command line: extattr +a checkaccess. You must have read access to the BPX.FILEATTR.APF resource in the FACILITY class profile to run this command.

What to do next

After you install and configure the deployment tools, configure the ISPF gateway.

Feedback