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).
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.
Preparing to work with files
After you set up your TSO Client environment and start the client component of TSO Client, you must complete these tasks before you can work with your files.

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.
  - 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.
    - Quick reference for TSO Client
      This topic provides a synopsis of the functionality of TSO Client commands and panels.
    - Displaying TSO Client help
      This topic describes how to update your ISPF profile to display TSO Client helps. You need to do this task only if have used a previous version of z/OS® Extensions and your installation has upgraded to version 7.1.0.2.
    - Setting up your TSO Client environment
      Before you use TSO Client, customize your environment by performing these tasks.
    - Starting and stopping the server and client components of TSO Client
    - Working with views and streams
      Use the options on the View and Stream panel to select a view, create a stream, create a view, and synchronize a view with a stream.
    - Preparing to work with files
      After you set up your TSO Client environment and start the client component of TSO Client, you must complete these tasks before you can work with your files.
      - Selecting a profile
      - Selecting a user specification
        Use the TSO Client interface to set the remote user name and password on distributed system and the ClearQuest credentials when the UCM project is ClearQuest integrated.
      - Selecting a view
        When you set up your profile, you must map files from distributed DevOps Code ClearCase® views. Before working with those files, you must first select your view. You can select only one view at a time.
      - Creating or selecting UCM activities
        UCM verifies that the activity name is in accordance with rules that are documented in the IBM® Rational® ClearCase® Command Reference (A-L). If you are using UCM, you must create or select an activity before you can check in or check out files.
      - Uploading files to a copy area on z/OS®
        The Upload function is for setup operations where a large number of files are needed to populate a partitioned data set. This function uploads files of all states (checked in, etc.).
    - Working with files
      After you set up your environment, choose your view, and upload your files to the remote system, you can use the client component of TSO Client to perform basic file tasks with the files associated with your chosen view.
    - Query files
      Once you set up your environment and choose your view, you can use the client component of TSO Client to perform query tasks by specifying certain criteria.
    - Building with TSO Client
      You can create either a local or a remote build by using the TSO Client feature.
    - Getting help with errors
      TSO Client displays short and long error messages to help you troubleshoot problems.
    - Opening the TSO Client log file
      TSO Client records messages in a log file to help you troubleshoot problems.
  - 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

Preparing to work with files

After you set up your TSO Client environment and start the client component of TSO Client, you must complete these tasks before you can work with your files.

Before you begin

Previous step: Starting and stopping the server and client components of TSO Client

Procedure

Select a profile.
Select a view.
Optional: Create or select UCM activities (if you are using UCM).
Upload files to the remote system.
Note: If you are preparing to work with files using parameterized build, you do not need to complete this step. The parameterized build scripts perform the file upload.

What to do next

Next step: Working with files