Welcome
Installing
Learn how to install the product.
Installing and using z/OS® Extensions
z/OS® Extensions is a component of IBM® Rational® ClearCase® that enables mainframe users to perform select DevOps Code ClearCase operations. z/OS Extensions include Remote Build, TSO Client, and ClearCase RAM (CCRAM).
Configuring z/OS® Extensions
z/OS® Extensions include basic configuration tasks required to use the z/OS Extensions features and some optional configuration tasks. Some of these options need to be configured by an administrator and some need to be configured by individual users for their client environment.
Configuring the Remote Build server
This topic describes how to configure and run a Remote Build server. It also explains how to verify client/server communication.
Customizing the Remote Build server JCL
Remote Build server options are passed to the server in JCL members that you modify before starting the server. These members are specific to the platform on which the server runs: z/OS® MVS™ or z/OS UNIX® System Services.
Editing the z/OS® UNIX® System Services rccbldw.sh script

Overview
Learn general information about the product.
Installing
Learn how to install the product.
- DevOps Code ClearCase® Release Notes
  The release notes provide you with information that you might want to know before you install the product.
- Deploy DevOps Code ClearCase®
  Read these topics for information about planning, installing, and configuring your DevOps Code ClearCase® deployment.
- Use IBM® installation and packaging utilities
  Use IBM installation and packaging utilities to download and install IBM® software.
- Installing and using z/OS® Extensions
  z/OS® Extensions is a component of IBM® Rational® ClearCase® that enables mainframe users to perform select DevOps Code ClearCase operations. z/OS Extensions include Remote Build, TSO Client, and ClearCase RAM (CCRAM).
  - Reading roadmap
  - Installing z/OS® Extensions
    Use these instructions to plan for, complete, and check the progress of installation and configuration tasks for z/OS® Extensions.
  - Configuring z/OS® Extensions
    z/OS® Extensions include basic configuration tasks required to use the z/OS Extensions features and some optional configuration tasks. Some of these options need to be configured by an administrator and some need to be configured by individual users for their client environment.
    - Configuring the Remote Build server
      This topic describes how to configure and run a Remote Build server. It also explains how to verify client/server communication.
      - Configurable Remote Build server options
        You can configure the Remote Build server by setting runtime options. This topic provides background information on how the Remote Build server works and which runtime options you can configure.
      - Customizing the Remote Build server JCL
        Remote Build server options are passed to the server in JCL members that you modify before starting the server. These members are specific to the platform on which the server runs: z/OS® MVS™ or z/OS UNIX® System Services.
        Editing the RCCRUNM or RCCRUNU member
        The RCCRUNM (for z/OS® MVS™ platforms) or RCCRUNU (for z/OS UNIX® System Services ) JCL member contains customizable options that are passed to the server when it starts. To customize these options, you make changes to this member.
        Editing the RCCMVS member
        Editing the z/OS® UNIX® System Services rccbldw.sh script
        Editing the RCCUSS member
        Running Remote Build JCLs on a sysplex
        If your z/OS® MVS™ or z/OS UNIX® System Services system runs as part of a sysplex, then you also need to customize the RCCRUNM and RCCMVS or RCCRUNU and RCCUSS JCL members to ensure that these JCLs are all running on the same system.
      - Starting and stopping the Remote Build server
      - Verifying client/server communication
    - Configuring the TSO Client feature
      This topic describes TSO Client configuration tasks.
    - Installing and configuring CCRAM
      This topic provides instructions for installing and configuring ClearCase® Repository Access Manager (CCRAM).
    - Using secure password protection
      Secure password protection stores encrypted passwords for use by the Remote Build client and the server component of the TSO Client feature.
    - Working with the Role-based Resource Manager
      The Role-based Resource Manager adds a layer of security for accessing system resources.
  - Using the Remote Build feature
    The Remote Build feature submits build requests from DevOps Code ClearCase® client platforms running on Windows®, Linux®, and the UNIX® system to z/OS® (MVS™ and z/OS UNIX System Services). This feature consists of both server and client components.
  - Using the TSO Client feature
    Use the TSO Client feature to perform DevOps Code ClearCase® operations on the distributed system without leaving the mainframe system environment.
  - Managing builds with impact analysis
    z/OS® Extensions provides impact analysis tools that you can use to manage COBOL, PL/I, and High Level Assembler (HLASM) builds.
  - Using the TSO Client API
    The TSO Client API enables you to perform Remote Build functionality by using a TSO Client API application. Use the TSO Client API to create your own custom TSO Client calls to a distributed system running DevOps Code ClearCase®.
  - Using the ClearCase® Repository Access Manager
    ClearCase® Repository Access Manager (CCRAM) provides a seamless interface that enables those who use IBM® Rational® Developer for System z® to access assets stored in ClearCase.
  - Automating builds with parameterized build scripts
    Parameterized build is a script-based, sample-driven approach to automating Remote Build scripts. It provides you with sample scripts that you can use as a starting point for developing your own approach to automating Remote Build scripts. These sample scripts are provided as-is and require customization and alteration before they can be used in your z/OS® Extensions environment.
  - Reference
    The reference topics in this section provide material that is helpful while using z/OS® Extensions features.
Upgrading and migrating
Learn how to upgrade and migrate data for the product.
Administering
Learn how to administer the product.
Developing
Learn how to develop software with DevOps Code ClearCase® and ClearCase Remote Client.
Managing change and releases
Learn how to manage change and release in the product.
Integrating
Learn how to integrate DevOps Code ClearCase® with other products.
Tutorials
Complete tutorials with specific learning objectives for the product.
Extending product function
Learn how to extend the product.
Reference
Review reference information for the product.
Glossary

Editing the z/OS® UNIX® System Services rccbldw.sh script

About this task

The rccbldw.sh shell script resides in the HFS directory -PathPrefix-/usr/lpp/ZosExtensions. -PathPrefix- is the path prefix of the HFS directory that z/OS® UNIX® System Services Remote Build was installed in.

To edit the rccbldw.sh script, replace all instances of the -PathPrefix- string with the actual path prefix of the HFS directory where the z/OS® UNIX® System Services Remote Build was installed.

Note: The default HFS directory is -PathPrefix-/usr/lpp/ZosExtensions. If you changed this installation path in any way, that change must also be reflected here.

To activate tracing, modify the shell script rccbldw.sh by performing the following procedure:

Change export RCCTRACE=* to export RCC_TRACE=*.
Add the command export RCC_TRACEFILE=~/filename, where filename specifies the trace file.