TOC PREV NEXT INDEX DOC LIST MASTER INDEX




Batch Mode Procedures

This page outlines some of the more useful procedures that you can use when working with units in an RCI batch-mode view. The RCI User's Guide contains a detailed description of batch mode RCI operations.

Verifying Batch Mode

You can verify batch mode operation for a given view by checking (with Control > Show > Switches (Apex/Summit)) the RCI_COMPILATION_MODE switch. This switch is found in the /Policy/Switches file for the view in question. This switch should be set to batch. This file also contains the RCI_AUTO_TRANSFER switch, which determines whether the RCI automatically transfers units to the target when they are coded. If RCI_AUTO_TRANSFER is set to False, you must transfer all units requiring recompilation to the target before you execute the batch compilation script.

Note: The RCI_COMPILATION_MODE and RCI_AUTO_TRANSFER switches may not be present in the Switches file. If the RCI is unable to find an explicit definition for a particular switch, it uses the switch's default value. The RCI_COMPILATION_MODE switch defaults to interactive. The RCI_AUTO_TRANSFER switch defaults to True.

Compiling in Batch Mode

1. . Select those units that you want to compile and code them, along with all units in their execution closure (Compile > Code).

2. . Use RCI > Create Script to generate a batch script. If the RCI_AUTO_TRANSFER switch was set to False when the units were coded, you can select the Copy Units To Target option to transfer them when the RCI creates the script. Note that since the host and target are connected via NFS, you do not need to transfer the script to the target directory.

3. . If the RCI_AUTO_TRANSFER switch was set to False when you coded the units, and you chose not to transfer the units when the script was built, use RCI > Copy To Target to transfer those units needing compilation to the target directory.

4. . If the compilation platform is the same as the host machine, select the batch script and execute it either by double-clicking on it or by using File > Run. Otherwise log on to the compilation platform and execute the batch script there.

Retrieving Associated Files

Associated files are those files that are generated as a result of target compilation. These files can include assembly listing files, cross-reference listings, debug tables, etc. Because the target is connected to the host via NFS, it is usually not necessary to transfer these files back to the host. If it is necessary, you can use the File > Copy Object (Apex/Summit) command to transfer these files from the target to the host.

Your customizer can modify the RCI to automatically transfer associated files. Check the RCI Customization Guide for more information.


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