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.
Setting up your TSO Client environment
Before you use TSO Client, customize your environment by performing these tasks.
Verify and troubleshoot TSO Client connectivity
Make sure the distributed system where the TSO Client server is executing is properly identified and the TCP/IP configuration supports the hostname specified. The TCP/IP configuration must support the resolution of the hostname in both directions: system name to IP address and IP address to system name.

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.
      - Choosing views on the distributed system
        Use the TSO Client interface to choose the views on the distributed DevOps Code ClearCase® system that you want to work with.
      - Logging
        Use the TSO Client interface to set logging and working directory related configurations.
      - Creating copy areas on the remote system
        Allocate one copy area for each distributed view. If the structure of a mapped view changes, upload the files in the view again to reflect the change.
      - Configuring the TSO Client environment
        Your environment definition defines user-specific values for a particular software development project. For example, the host name, port number, and whether the project uses Unified Change Management (UCM) are values that you must set for the development environment. To use the client component of TSO Client, set up at least one environment definition.
      - Verify and troubleshoot TSO Client connectivity
        Make sure the distributed system where the TSO Client server is executing is properly identified and the TCP/IP configuration supports the hostname specified. The TCP/IP configuration must support the resolution of the hostname in both directions: system name to IP address and IP address to system name.
    - 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.
    - 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

Verify and troubleshoot TSO Client connectivity

Make sure the distributed system where the TSO Client server is executing is properly identified and the TCP/IP configuration supports the hostname specified. The TCP/IP configuration must support the resolution of the hostname in both directions: system name to IP address and IP address to system name.

Before you begin

Previous step: Configuring the TSO Client environment

Procedure

To verify the TSO Client environment definition, do these steps:

To verify that you have the correct hostname identified in the HOST parameter in the environment definition file, issue the following command from a command prompt on a different distributed system (other than the system where the TSO Client server is executing):
```
nslookup hostname
```
In this command, hostname is the value specified for the HOST parameter in the environment definition file.
If the connection is verified from another distributed system, then verify the connection from the z/OS® system by issuing the following command from ISPF:
```
TSO NSLOOKUP hostname
```
In this command, hostname is the value specified for the HOST parameter in the environment definition file.

Results

If these commands return information about the TSO Client server, then communication is working properly. If it is not working, you need to review the problem further by doing one of the following actions:

Set up the z/OS® system to communicate with the DNS server as described in the z/OS® Communications Server IP Configuration Reference, NSINTERADDR statement.
Add the distributed host name to the local host table as described in the z/OS® Communications Server IP Configuration Guide, MAKESITE command.

What to do next

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