TOC PREV NEXT INDEX DOC LIST MASTER INDEX



Creating a Text File (Apex/ClearCase)

This module guides you through the steps needed to create a simple text file. All Apex components (code, documentation, etc.) .

Prerequisites

The Topics in this Module

Average Time to Complete this Module

20 minutes.


Creating Subsystems

Apex supports the dividing of a software-development effort into high-level components called subsystems, each containing a group of logically related objects. Subsystems let you group related files, Ada packages and other compilation units together, hiding those that contain only implementation details.

Note: In UNIX, a Rational subsystem is a directory with a .rss filename extension.

Models

One important characteristic of a Rational subsystem is its model. A model is a Rational subsystem that serves as a prototype for another Rational subsystem. The model provides a base structure of subdirectories, policies (compiler options, target keys, etc., by way of switches), and a base set of Imports.


Creating a Subsystem

In this exercise, you will create a subsystem named test.rss.

1. . Open a directory-viewer window of your VOB (/vob/test) if one is not opened.

2. . Choose the New command from the File menu. Apex displays a cascading menu.

3. . Choose the New Subsystem menu item from the New submenu. Apex displays the New Subsystem dialog box:

4. . Enter the full pathname of the subsystem you wish to create in the Subsystem Full Name field. The .rss extension is added for you automatically. For this exercise, use $/vobs/test/test.

5. . Because we will be creating a text file, the Language is not important, so use the default of Ada. Verify the Host Architecture matches the architecture of the machine on which you are running.

6. . Make sure the Visit the new subsystem check box is selected.

7. . Select the Make it an element option so that this Rational subsystem will be controlled. Any element that is controlled needs the enclosing Rational subsystem to be controlled. If you do not control it now, it will need to be controlled when you control the first element in this Rational subsystem. When you select this option, a Note field will be displayed. Enter a Note to be associated with controlling this element.

To create your new Rational subsystem, click OK or Apply. When the dialog box closes with the Visit the new subsystem check box selected, Apex opens a directory-viewer window showing you the subsystem that was created.

See File > New for more information. The Online Reference contains additional information on the contents of an empty subsystem.


Creating a Text File

Perform the following steps from the directory viewer displaying the subsystem (test.rss should be the first line in the directory viewer) you created in the previous topic. If you do not have it displayed, execute the File > Open command and enter <dir>/test.rss, where <dir> is the path to your subsystem as the Filename.

1. . Select the New command from the File menu in the test.rss directory-viewer window. Apex opens a cascading menu.

2. . Choose the New File menu item from the New submenu. Apex displays the New File dialog box.

3. . Enter the name text.txt in the Name field.

4. . Execute the New File dialog box by clicking the OK button.

When you complete step four, Apex creates an empty file in an editor window.


Editing the Text File

The Editor Window

The editor window is where you edit your text files. All the Apex editors operate in the same basic manner. Type in anything you wish in your text file.

Basic tips for using the editor:

There are many editor key bindings.

Type anything in. Select the File > Save command to save your file.

You have just created a text file.

Close all the windows you have created during this module.


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