TOC PREV NEXT INDEX DOC LIST MASTER INDEX



Overview

Rational Apex/Summit, hereafter referred to as Apex, is a software-engineering environment that helps you develop large, complex projects. Apex offers:

To help users start developing software using Apex as fast as possible, we have a set of tutorials:

This online tutorial teaches you how to start using Rational Apex. It follows a hands-on approach in which you perform a series of exercises. When you are finished, you will be able to start using Apex to edit, compile, and debug programs.

Note: Your menus and dialog boxes may include additional commands, fields, and/or options. These screen shots are provided for illustration purposes only.

To move to the next topic, click the Next button.


Getting Started

Apex runs under the X Window System and is compliant with OSF/ Motif.

Prequisites for this Module

Topics in this Module

Average Time to Complete this Module

15 minutes.


Bringing Up Apex

Setting up the Environment

This section covers the items needed to bring up Apex.

Apex is started and initialized by typing shell commands in an xterm window as follows:

1. . Start the X server and the window manager

2. . Set the display for your system as follows:

Additional Set up for Apex/ClearCase

To use Apex/ClearCase with Base ClearCase, you need to have a VOB and ClearCase view. To use Apex/ClearCase with UCM, please see the chapter on Developing a Program using ClearCase in Getting Started.

Creating a VOB

Note: The examples of Creating a VOB and Creating a ClearCase view are provided to get you up and running quickly. To establish your project development environment, please see the ClearCase Administrator Guide for details.

1. . Log into the VOB host

2. . Choose a location for the VOB storage directory. (/work1/vobstore)

3. . Choose a vob-tag for your VOB (/vobs/test). This cannot include symbolic links

4. . Login as superuser and create the directory and make it writable:

5. . Create the VOB structure:

6. . Mount the VOB

7. . If you want to verify your VOB, run cleartool lsvob which should list your VOB-tag, the VOB storage directory and the fact it is public.

Note: The VOB stays mounted until you explicitly unmount it with the cleartool umount command.

Creating and Activating a ClearCase View

Note: The examples of Creating a VOB and Creating a ClearCase view are provided to get you up and running quickly. To establish your project development environment, please see the ClearCase Administrator Guide for details.

Note: The ClearCase view storage directory must be accessible to all machines that need to use the Rational subsystems stored in that ClearCase view.

1. . Create a ClearCase view (working environment for individual developer or closely coordinated group). You need a view-tag and writable view storage directory. To determine the view access, set your UNIX umask BEFORE creating your view.

2. . Activate your Clearcase view:

Starting Apex/ClearCase

1. . If you installed Apex so that it runs with ClearCase by default, start up Apex/ClearCase using

Otherwise (Apex/Summit is the default), start up Apex using

Apex displays the Apex ClearCase Panel window and the Welcome help file in the Netscape Browser.

2. . Visit your home directory to display a directory-viewer window by entering ~ in the Visit field in the Apex ClearCase Panel and clicking the Visit button.

When a directory is visited or opened, Apex/ClearCase opens a directory-viewer window that displays a list of files and directories.

Starting Apex/Summit

1. . To initialize Apex from a command line, enter:


The Panel Window

When Apex starts, the Panel window is the first window to appear when starting Apex. The window displays the version of Apex you are running:

The controls in the Panel window allow you to:

In the Panel window, type your home directory or tilde (~) in the Visit field and click the Visit button. This brings up a Directory Viewer of your home directory.


Rational Software Corporation 
http://www.rational.com
support@rational.com
techpubs@rational.com
Copyright © 1993-2001, Rational Software Corporation. All rights reserved.
TOC PREV NEXT INDEX DOC LIST MASTER INDEX TECHNOTES APEX TIPS