TOC PREV NEXT INDEX DOC LIST MASTER INDEX




Copy Views Options in the File > Copy Object Dialog Box (Apex/Summit)

Copying Views Radio Button

You can use the File > Copy Object (Apex/Summit) command to create a set of working views or a set of release views. There must be no checked-out files in any of the source views, and the source views in the Copy Object field cannot name two views from the same subsystem. The File > Copy Object (Apex/Summit) command updates the imports of the new views to reflect the imports of the source view.

The Copy Object dialog box displays view options when the Copy Views radio button is selected. These options are accessed through the following tabs:

Command Line Interface > copy_view

Copying Multiple Views

When you copy more than one view at a time, the Destination Name field is interpreted to be relative to the source views. For example if you have

and are copying the following views in the following subsystems:

The result is that each rel1.wrk view is copied in its own subsystem and is named new.wrk:

Note that cabin_ops.ss/new.wrk is a copy of cabin_ops.ss/rel1.wrk and so on.

Imports of all copied views are updated so that any references to source views are changed to reference the new views.

Control Tab

The following options are displayed when the Control tab is selected

If source object is checked out: Radio Buttons

Additional control options:

View Tab

The following options are displayed when the View tab is selected

View Copy Options Check Boxes and Radio Buttons

Filter Tab

The filter options limit the objects to be copied using filename patterns. Different filters may be specified for working views and release views, and for inclusions and exclusions in each case. The default filters are displayed initially. The following options are displayed when the Filter tab is selected.

Controlling the Contents of New Views describes the options and switches used in this area.

Other Tab

The following options are displayed when the Other tab is selected.

RCI Tab (Ada only)

The following options are displayed when the RCI tab is selected.

These options are used to specify a target Ada library (Target Directory) that corresponds to the specified host view. (Depending on your RCI customization, the elements of the Ada library required by your target compiler will be built, including the Ada program library and import information.)

If the Target Directory does not already exist on the target, it will be created and associated it with the selected host view. If the RCI Target Directory does exist on the target but is not an Ada library, it will be converted it into an Ada library before associating it with the host view. If the RCI Target Directory exists on the target and is already an Ada library, it will just be associated it with the selected view.

Note: Do not assign two views from the same subsystem to the same target library, unless your customization specifically requires this structure.

Once the target library has been created, all units in the host view are marked as requiring recoding on the target.

When you create a target library for a view that is imported by others, the importing views' imports are made obsolete.

Before you compile units in one of the importing views, you must refresh its imports (use Control > Maintenance > Refresh (Apex/Summit)).

Some buttons work in pairs, and in addition, button combinations are only allowed that create correctly formed RCI views. For example, a host-only view with or without a target library, or a host-target view with a target library.

Enable RCI Options Check Box

Indicates whether RCI options for new views are provided below.

Machine Button and Text Field

Use this field to specify which machine, if different from the host on which Apex is running, will perform target operations (such as library operations, compilation and linking) for this host view.

This field will be used to set the value of the RCI_COMPILATION_PLATFORM context switch for the host view.

Selecting the Machine button will cause the Compile on Host Only button to be deselected.

Compile on Host Only Button

No target compilations will occur for this view if this button is selected. Such a view can still have an associated target library which allows RCI views to be associated with precompiled target libraries.

Selecting the Compile on Host Only Button will cause the Machine Button to be deselected.

Target Directory specification fields:

These fields are used to specify a context, and a library name within this context, which will be combined (in a RCI customization specific way) to form the pathname for the target library to create and associate to the host view.

This pathname will be used to set the value of the RCI_TARGET_DIRECTORY context switch for the host view.

Context for target libraries Button and Text Field

The path to the directory context for the target library.

Selecting the Context for target libraries Button will cause the Target library context is default context Button to be deselected.

Target library context is default context Button

Sets target library context to a default value.

Selecting the Target library context is default context Button will cause the Context for target libraries Button to be deselected.

The value for the default context is RCI customization dependent. Generally, if the host filesystem is visible from the target machine, this default context will be the host view's enclosing subsystem.

Target library name Button and Text Field

The name of the target library within the context.

Selecting the Target library name Button will cause the Target library name is automatically generated Button to be deselected.

Target library name is automatically generated Button

Sets target library name within the context to a default, automatically generated, value.

Selecting the Target library name is automatically generated Button to be deselected will cause the Target library name Button to be deselected.

The value for the default name is RCI customization dependent. Generally, if the host filesystem is visible from the target machine, this default name will be targets/<view:t:r>.rci<view:e> (i.e. a subdirectory within a targets directory with the same base name as the host view, and extension .rciwrk or .rcirel, depending on the kind of the host view).

View has no target library Button

Views without target libraries must also be Host Only, although the reverse is not true as mentioned above.

Selecting this button will cause the Compile on Host Only Button to be selected, and the context and target library name Fields to become inactive.

Note: The creation of target libraries may or may not be implemented from one RCI customization to another. Also, your customizer can modify the way it operates (in particular the rules used to analyze and combine the provided target library context and name, and to generate default values for these).

For additional information, check the documentation for your RCI customization.

For additional detailed information on Apex shadowing, see the Client/Server Concepts Guide

Additional Topics

To see related information, click on a topic:


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