![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
RCI > Create ScriptRCI > Create Script brings up the Create RCI Script dialog box. Create Script creates a batch compilation script that, when executed on the target compilation platform, compiles and (optionally) links the specified units (and those units in the closure of the specified units).
All units specified to Create Script must belong to a single host view.
Each unit in the execution closure of the specified units must have been coded on the host. (If the units are not all coded, the RCI creates the script for the coded units, and it issues warnings about the units that are not coded.)
To create a script for all of the Ada units in a given host view, select the view, using the standard file locator on the Create Script dialog. Since the RCI can only generate a given batch script for units selected from a single host view, specify either a single view or one or more units from a single view using the Create Script dialog's standard file locator.
Warning: The RCI assumes that after you generate a batch script you will immediately execute that script, compiling each unit in the script on the target. Unless you execute every script you generate, in the order you generate them, the RCI state information for the units in the host view may not reflect the actual state of the target library, and subsequently-generated batch scripts may fail when executed on the target.
The RCI takes the following steps to construct the list of units to be compiled by the batch script:
- 1. . Start with the list of specified units, or all units in the specified host view.
- 2. . Remove the uncoded units.
- 3. . Add to the list those units that constitute the execution closure of the specified units.
- 4. . If Include All Units is not selected, remove from the list all units that are not obsolete, that is, those units that have not been coded since they were last included in a script.
Script Name
The batch script is named "batch.scr" by default. Script Name allows you to specify your own filename for the batch compilation script created by the Create Script command. This can be either a simple name or a relative or full path name. The command adds an `.scr' extension if you have not supplied one.
Create Script does not overwrite an existing batch script. If the file specified in the Script Name field (or "batch.scr") already exists, the RCI displays an error message and does not overwrite it. To overwrite an existing script, you must select the Replace Existing Script button.
Create Script also automatically creates a buildlist file into which it writes the names of all program units that the batch script will compile. You can use this file as indirect input for transferring host units to the target when using the RCI > Copy To Target command. The RCI generates the buildlist's filename from the script's filename by changing the `.scr' extension to `.bl'.
Check Boxes
- Link Main Units
Controls whether or not the batch compilation script contains commands to link main units. Link Main Units is selected by default. If this option is not selected, the batch script compiles, but does not link, the specified units when you execute it. In any case, if a specified unit is not a main unit, the RCI does not generate a link command for that unit.
- Include All Units
Enters into the batch compilation script all units in the execution closure of the specified program units. By default, Create Script only includes in the batch script those units that have been changed on the host since they were last included in a script. You should select this option if you want to recompile the entire system on the target. Note that creating scripts with this option can lead to inconsistencies; if a view is built, but not its clients, those clients become obsolete on the target.
- Copy Units to Target
Copies each unit needed by the batch compilation script to the target compilation platform when the script is created.
- Replace Existing Script
Replace an existing script with the new script. If a script with the same name as specified in the Script Name field already exists, the create script operation will fail unless this button is activated.
When you have selected the units and options, click on Apply or OK in the dialog box button bar.
The RCI is described in the RCI User's Guide and the RCI Customization Guide.
Rational Software Corporation http://www.rational.com support@rational.com techpubs@rational.com Copyright © 1993-2001, Rational Software Corporation. All rights reserved. |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |