![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
Overview Rational Apex/Summit, hereafter referred to as Apex, is a software-engineering environment that helps you develop large, complex projects. Apex offers:
- Rational Subsystems, which gives you architectural control over your development environment
- Rational Summit/CM, a sophisticated system for configuration management and version control used in Apex/Summit
- Rational ClearCase, a flexible version control and configuration management tool used in Apex/ClearCase
- An intelligent C/C++ editor (for C and C++ code)
- An intelligent Ada editor (for Ada code)
- Tools to aid in C/C++ build management
- An interactive debugger
- A modern graphical user interface (GUI) and a shell command-line interface
- Tools for customizing the user interface and behavior
- Features for integrating with other tools
- Tools for developing Java and HTML files (for the C/C++ and Duo products)
To help users start developing software using Apex as fast as possible, we have a set of tutorials:
- Getting Help
- Using the GUI
- Creating a Text File (Apex/Summit)
- Creating a Text File (Apex/ClearCase)
- Editing, Compiling, and Executing an Ada Program (Apex/Summit)
- Editing, Compiling, and Executing an Ada Program (Apex/ClearCase)
- Using the Ada Debugger
- Editing and Compiling a C++ Program (Apex/Summit)
- Editing and Compiling a C++ Program (Apex/ClearCase)
- Using the Debugger for C/C++ Programs
- Using Configuration Management and Version Control (Apex/Summit)
- Using ClearCase for Control and Configuration Management (Apex/ClearCase)
- Using the Tutorial
- Using Motif
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 StartedApex runs under the X Window System and is compliant with OSF/ Motif.
Prequisites for this Module
- Have Apex installed.
Topics in this Module
Average Time to Complete this Module
Bringing Up ApexSetting 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:
- For C shell (csh), execute a DISPLAY command written as follows:
- For the Bourne shell (sh) or Korn shell (ksh), enter the DISPLAY command as follows:
$ DISPLAY=local_host:0; export DISPLAY
where local_host is the unique network name of your local workstation.
- To provide a remote workstation with access to the X server on a local workstation, execute the following command on the local workstation:
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:
% su # mkdir /work1/vobstore # chmod 777 /work1/vobstore # exit
- 5. . Create the VOB structure:
Registry password: Comments for "/work1/vobstore/vob.test":
% cleartool mkvob -public -tag /vobs/test /work1/vobstore/vob.test
VOB for trying out ACCIVOBs have special data backup considerations. ...
.- 6. . Mount the VOB
% cleartool mount /vobs/test- 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.
% umask 022 # allow all members of our UNIX group to # create and modify view-private data
% mkdir $HOME/views
% chmod +w $HOME/views
% cleartool mkview -tag test_view $HOME/views/test.vws
- 2. . Activate your Clearcase view:
% cleartool setview test_view
Starting Apex/ClearCase
- 1. . If you installed Apex so that it runs with ClearCase by default, start up Apex/ClearCase using
% apexinit
Otherwise (Apex/Summit is the default), start up Apex using
% apexinit -clearcase
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 WindowWhen 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:
- Display the Setup window, used to create Apex projects (see the Getting Started Guide for details)
- Exit Apex, terminating your Apex session
- Open a Shell window, to use for entering Apex commands without the GUI.
- Display the Windows window, used to open, close, and manipulate Apex windows
- Display Help on using Apex
- Visit files using the directory-viewer window
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. |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |