|
DataMuseum.dkPresents historical artifacts from the history of: Rational R1000/400 |
This is an automatic "excavation" of a thematic subset of
See our Wiki for more about Rational R1000/400 Excavated with: AutoArchaeologist - Free & Open Source Software. |
top - download
Length: 27544 (0x6b98)
Types: TextFile
Notes: R1k Text-file segment
└─⟦8527c1e9b⟧ Bits:30000544 8mm tape, Rational 1000, Arrival backup of disks in PAM's R1000
└─ ⟦5a81ac88f⟧ »Space Info Vol 1«
└─⟦9779a634a⟧
└─⟦this⟧
Rational Compilation Integrator:
IBM RISC System/6000 Extension
Release Information
Release 2_0_2
\f
Copyright 1992 by Rational
Part Number: 508-003256-009
December 1992 (Software Release 2_0_2)
AIX and RISC System/6000 are trademarks and IBM is a registered
trademark of International Business Machines Corporation.
Rational and R1000 are registered trademarks and Rational
Environment is a trademark of Rational.
Rational
3320 Scott Boulevard
Santa Clara, California 95054-3197
\f
Release 2_0_2
1. Overview
This release note describes the enhancement release, Release
2_0_2, of the Rational Compilation Integrator: IBM RISC
System/6000 Extension (Rs6000 RCI). This Rs6000 RCI release is
compatible with Release 2_0_5 of the Rational Compilation
Integrator, referred to as the Customizable RCI.
In particular, this release implements optimal batch mode
processing, additional implementation-dependent pragmas, and
includes predefined packages in !Targets.Rs6000_Aix_Ibm.Target-
_Interface.
This note covers Rs6000_Aix_Ibm-specific release issues. Refer to
the Customizable RCI Release Note for general product
information.
2. RCI Components
The following Rs6000 RCI components are installed as part of the
release:
!Targets.Implementation.Release_Rs6000_Aix_Ibm2_0_2
-- Rs6000 RCI release world
!Targets.Rs6000_Aix_Ibm -- Rs6000 Predefined Units
!Targets.Implementation.Rci_Customization.Rs6000_Aix_Ibm
Rev2_0_Spec -- Customization views
Rev2_0_2 -- Includes templates, and
-- extensions.
For more information on installation of this product, refer to
the installation instructions delivered with this release. For
user information, refer to the RCI User's Manual and Rs6000 RCI
User's Guide.
3. Upgrade Impact
In this release, the product name changes from Rational Remote
Compilation Facility (RCF) to Rational Compilation Integrator
(RCI). As of this release, the Rs6000 RCI no longer supports Rcf
packages. Corresponding names for all packages have changed from
Rcf to Rci.
The Rs6000 RCI has no special upgrade impact. However, some
upgrade impact is associated with moving to RCI Rev2_0_5,
including switch name changes and state file changes. Upgrade
tools are provided with RCI Rev2_0_5 to convert existing views
(including Rs6000_Aix_Ibm views) to Rev 2_0_5.
RATIONAL December 1992 1\f
Rs6000 RCI Release Information
4. Prerequisites
Before you use the Rs6000 RCI, confirm the following prerequisite
conditions:
* The remote user accounts use Korn Shell. If not, remote
command execution fails with the message "variable syntax
error".
* IBM AIX Version 3.1 (or later) is running on the remote RISC
System/6000.
* The IBM AIX Ada/6000 compiler, Version 2.0 (or later), is
installed on the remote RISC System/6000 in /usr/bin/ada.
* The host R1000 and remote RISC System/6000 are on the same
network.
* DTIA servers are installed on both the host R1000 and the
remote RISC System/6000. If not, you can encounter the
following:
- The Rs6000 RCI does not elaborate if the host DTIA
Remote_Operations server is not installed.
- Remote commands cannot execute if the remote DTIA server is
not running.
Use the following steps to confirm that both servers are
running:
1. To detect if the host server is already running:
- Execute What.Users.
- Search for job name DTIA Remote_Operations Server in
the list.
2. To detect if the remote server is running, execute this
command from the remote command shell:
$ ps aux
This command displays a list of system processes. Look for
an entry for the inetd process, similar to the following:
root 5084 1989 0 17:26:01 ? 0:00 /etc/inetd
3. View the inetd configuration file to make sure that DTIA
has been registered:
$ cat /etc/inetd.conf
2 December 1992 RATIONAL\f
Release 2_0_2
Look for an entry at the end of the file for DTIA.
dtia stream tcp nowait root /usr/etc/in.dtia in.dtia
Refer to the DTIA Installation and Release Notes for
information on how to restart the host and remote servers.
* The RCI is running. (After installation, the RCI starts
automatically at machine initialization.)
To start the RCI:
1. Run Start_Rci_Main to start the RCI compiler job.
2. Use Rs6000_Aix_Ibm.Register to register your extension.
3. Use What.Users to list the jobs and check for the
following:
- DTIA Remote_Operations Server
- Rci_Compiler Rev2_0_5 (or later)
- Rci_Rev2_0_2_Rs6000_Aix_Ibm_DTIA
5. New Features
This section describes feature changes added since the Rs6000 RCF
Rev1_1_0 release.
5.1. Batch Compilation
The Rs6000 RCI can now be registered for either batch compilation
mode or interactive mode. Under batch compilation mode, the
Rs6000 RCI generates an optimal batch script that minimizes the
number of times the Ada/6000 compiler is elaborated.
5.2. New Implementation-Dependent Pragmas
The Rs6000 RCI now supports the following pragmas:
* Interface_Information
* No_Suppress
* Preserve_Layout
* Suppress_All
See the RCI Rs6000 User's Guide for more information.
RATIONAL December 1992 3\f
Rs6000 RCI Release Information
5.3. New Predefined Packages
The Rs6000 RCI now includes the following predefined packages in
!Targets.Rs6000_Aix_Ibm.Target_Interface:
!Targets.Rs6000_Aix_Ibm.Target_Interface : Directory;
Ada_Debugging_Support : C Pack_Spec;
Aix_Environment_Variables : C Pack_Spec;
Command_Line : C Pack_Spec;
Device : C Pack_Spec;
Elementary_Functions : C Pack_Inst;
Elementary_Functions_Exceptions : C Pack_Spec;
Fast_Math : C Pack_Inst;
Generic_Elementary_Functions : C Gen_Pack;
Generic_Math : C Gen_Pack;
Generic_Primitive_Functions : C Gen_Pack;
Gl : C Pack_Spec;
Gl_Flags : C Gen_Pack;
Gl_System_Types : C Pack_Spec;
Interrupt : C Pack_Spec;
Key_Syms : C Pack_Spec;
Long_Elementary_Functions : C Pack_Inst;
Math : C Pack_Inst;
X_Windows : C Pack_Spec;
6. Fixed Problems
This section describes problems that have been fixed since the
Rev1_1_0 release of this extension.
The following table provides the PRS number of the problem, the
section number of the description in this release note, and the
PRS summary of the problem.
Summary of Fixed Problems
-------------------------------------------------------------
| | | |
| PRS Number | Sec | PRS Summary |
| | Num | |
-------------------------------------------------------------
| | | |
|1015852-Jazm- |6.1 |Does Math_Pack belong in reusable |
|Jak | |components? |
-------------------------------------------------------------
| | | |
|1154041-Jazm- |6.2 |missing pragma Interface_Information |
|Jak | | |
-------------------------------------------------------------
| | | |
|1227523-Gato- |6.3 |Allow EXE retrieve to be an option on |
|Mboy | |customization |
-------------------------------------------------------------
4 December 1992 RATIONAL\f
Release 2_0_2
-------------------------------------------------------------
| | | |
| PRS Number | Sec | PRS Summary |
| | Num | |
-------------------------------------------------------------
| | | |
|1659718-Jazm- |6.4 |Target filename length |
|Jak | | |
-------------------------------------------------------------
| | | |
|5981731-Wood- |6.5 |Rcf_Cmvc.Import when used with an Rs6000|
|Raj | |customization raises an unhandled |
| | |exception <space index = 289> caught in |
| | |import_postprocess. This happens only |
| | |when a unit name is given instead of a |
| | |view name for the Into_View parameter. |
-------------------------------------------------------------
| | | |
|606019-Gato- |6.6 |Imports on R1000 and RS6000 alib.list |
|Mboy | |not consistent |
-------------------------------------------------------------
| | | |
|8263832-Gato- |6.2 |pragma Interface_Information causes |
|Mboy | |semantic error |
-------------------------------------------------------------
| | | |
|9018679-Gato- |6.7 |Suggestion: Fix -i options to work |
|Mboy | |better when including multiple libraries|
-------------------------------------------------------------
| | | |
|917835-Gato- |6.8 |The Os_Task option is a link-only |
|Mboy | |option, not a compilation option |
-------------------------------------------------------------
| | | |
|9679188-Gato- |6.9 |Rs6000_Aix_Ibm should be compatible with|
|Mboy | |rev 3.0 of AIX ADA/6000 for pragmas |
-------------------------------------------------------------
6.1. Invalid Reusable Component
PRS Number => 1015852-Jazm-Jak
The package Math_Pack has been removed from !Targets-
.Rs6000_Aix_Ibm.Reusable_Components. This package spec was
removed because it does not exist for the Ada/6000 compiler.
RATIONAL December 1992 5\f
Rs6000 RCI Release Information
6.2. Pragma Interface_Information
PRS Number => 1154041-Jazm-Jak, 8263832-Gato-Mboy
Previous to this release, code containing pragma Interface-
_Information would not semanticize, returning the following
warning instead:
Interface_Information is undefined.
As of this release, the Rs6000 RCI supports pragma Interface-
_Information for the Ada/6000 compiler.
6.3. Uploading Executable Files
PRS Number => 1227523-Gato-Mboy
In previous releases, the Rs6000 RCI automatically uploaded the
executable module created by the remote linker. A new session
switch, Session_Rci.Retrieve_Executable, has been added to the
RCI base product to determine whether or not the RCI should
upload the executable module to the host. If you want to upload
the executable file, set the value of the Session_Rci.Retrieve-
_Executable switch to True.
6.4. Remote Filename Length
PRS Number => 1659718-Jazm-Jak
In previous releases, the RS6000 extension limited the length of
a filename on the compilation platform to 31 characters. This
limit is now 255 characters.
6.5. Unhandled Exception from Import Operation
PRS Number => 5981731-Wood-Raj
Previous to this release, the Rcf_Cmvc.Import operation raised an
unhandled exception if the Into_View parameter specified the
Units directory of a view (Into_View => View_Name.Units), instead
of just the view name (Into_View => View_Name).
As of this release, the Rs6000 RCI no longer supports the use of
the Rcf_Cmvc.Import command. Instead, you use Cmvc.Import to
manage host and remote imports. The Into_View parameter of the
Cmvc.Import command accepts either a view name or the name of a
view's Units directory.
6 December 1992 RATIONAL\f
Release 2_0_2
6.6. Inconsistent Imports
PRS Number => 606019-Gato-Mboy
Previous to this release, the Rcf.Refresh_View, Rcf.Build_Remote-
_Library, and Rcf.Rebuild_Remote_Library commands did not always
create correct import lists (alib.list files) on the remote
compilation platform.
In particular, whenever you used these commands to build a set of
remote libraries from a set of host views, the remote imports
list would be incorrect unless you built the remote libraries
from the bottom up (that is, starting with the views that have no
imports then building their clients, then building the next layer
of clients, and so on).
When you use the Rci.Refresh_View, Rci.Build_Remote_Library, and
Rci.Rebuild_Remote_Library commands, the remote imports lists
will be correct regardless of the order in which you build the
remote libraries.
6.7. Including Multiple Libraries
PRS Number => 9018679-Gato-Mboy
Previous versions of the IBM RISC System/6000 User's Guide did
not explicitly describe the correct syntax for specifying the
Rci.Rs6000_Aix_Ibm_Include switch.
The Rci.Rs6000_Aix_Ibm_Include switch sets the -i option for the
Ada/6000 linker. Consequently, the switch value must conform to
the syntax required by the linker for the -i option. In
particular, you must specify -i before each of the included
libraries -- for example:
* Rci . Rs6000_Aix_Ibm_Include : String
:= "-i libXt -i libXm -i mylib"
The current version of the Guide documents this.
6.8. Os_Task Option
PRS Number => 917835-Gato-Mboy
Previous to this release, setting the Rci.Rs6000_Aix_Ibm_Os_Task
switch to True caused the -t option to be set for both the
compiler and linker instead of just the linker. The presence of
-t would cause a compiler error.
As of this release, setting the Rci.Rs6000_Aix_Ibm_Os_Task switch
to True sets the -t option only for the linker.
RATIONAL December 1992 7\f
Rs6000 RCI Release Information
6.9. Compiler Compatibility for Pragmas
PRS Number => 9679188-Gato-Mboy
Note: To use the Release 3.0 compiler, your customizer must
upgrade package System in !Targets.Rs6000_Aix_Ibm.Lrm. All units
compiled with AIX Ada/6000 Release 2.0 must be recompiled with
Release 3.0.
As of this release, the Rs6000 RCI semantic checking for pragmas
is compatible with Release 3.0 of the Ada/6000 compiler. See
Section 5.2 for a list of added supported pragmas.
7. Limitations
This section describes limitations in this Rs6000 RCI release.
7.1. Limits to Ada/6000 Release 3.0 Compiler Compatibility
This release does not supply host library switches for the
Ada/6000 Release 3.0-specific compiler and linker options. To
enter those options in your commands, use the appropriate RCI
library switch for compiler and linker pre- or post-options.
This release does not support semantic checking for type
SHORT_SHORT_INTEGER. This type is not defined in the Rs6000 RCI
package Standard.
7.2. Batch Compilation and Compiler Options
Batch scripts invoke the compiler with the -I option to permit
the compilation of multiple units. However, the /usr/bin/ada/ada
command does not accept the -l or the -a option when the -I
option is specified. Consequently, you should make sure that the
values of the Rci.Rs6000_Aix_Ibm_List and the Rci.Rs6000_Aix-
_Ibm_Assemble library switches are False when you generate batch
scripts.
7.3. Recovery from Batch Compilation Failures
Normally a batch script built on the host can be successfully
compiled on the remote compilation platform. However, for any of
the following reasons, a batch compile may fail on the remote
RISC System/6000, even if all the host units have coded
successfully:
* Certain units that semanticize on the host may not be
semantically correct for the Ada/6000 compiler. For example,
this happens when representation clauses specify alignment of
integers on word boundaries which could cause the Ada/6000
compilation to fail.
8 December 1992 RATIONAL\f
Release 2_0_2
* The Ada/6000 compiler may incorrectly reject valid Ada code in
certain cases (Rational can provide a list of these cases).
* Supplier units may not be compiled on the remote compilation
platform.
When a batch compilation fails for any reason, the entire batch
script must be reexecuted. This is because batch scripts
generated by the Rs6000 RCI are optimized to invoke the compiler
with the -I option once for each set of units in the same
library.
However, if any unit in a library fails to compile while -I is
used, the Ada/6000 compiler will not update the library at all,
even for units that would otherwise compile successfully.
Consequently, you must reexecute the batch script for whole
libraries even if only a few individual units failed.
7.4. Semantic Checking
The RCI performs semantic checking for the target as well as for
the host. However, semantic checking for the target does not
catch certain semantic errors pertaining to attributes, and
relies on the target compiler to detect such errors.
If this causes a batch script to fail, you should correct the
units according to the target compiler's guidelines, and then
re-execute the batch script (see 7.3).
8. Known Problems
Following is a list of problems specific to the Rs6000 RCI known
at the time of this release.
8.1. Remote Access Control
The remote DTIA server creates all remote files with the access
permissions:
rw- r-- r--
This permission setting gives read and write permission to the
owner of the file, but read permission only to group and others.
This can prevent host R1000 users with different remote userids
from operating on the same set of host views.
9. Troubleshooting
This section describes a technique for recovering from either of
the following situations:
RATIONAL December 1992 9\f
Rs6000 RCI Release Information
* A host compilation command hangs due to any cause. Relevant
commands include Comp.Make, Comp.Promote, or a command such as
Cmvc.Make_Path with the Goal parameter set to Coded.
* A host view-creation or library-creation command hangs with
the message Variable syntax error. Relevant commands include
Cmvc.Make_Path, Rci_Cmvc.Make_Path, Rci.Build_Remote_Library,
and so on. This error occurs if the shell associated with your
remote userid is not the Korn shell.
To recover from either of these situations, you must kill the
host command and kill the relevant processes on the remote
compilation platform:
1. On the R1000 host, execute the Job.Kill command:
Job.Kill (The_Job => [ID-expression], The_Session => "");
This kills the host command, but does not affect the status of
remote processes.
2. On the remote compilation platform, use the following command
to search for processes associated with your remote userid
(for example, the following command searches for processes for
username fred):
ps -ef | grep fred
The output lists the processes -- for example:
fred 13553 20720 8 16:52:04 - 0:00
/usr/lpp/ada/bin/Adaentry +varc==
fred 14314 6643 0 16:51:33 - 0:00 in.dtia
fred 19437 17643 0 16:51:48 - 0:00
/user/bin/ada/ada source_descript
fred 20720 19437 9 16:52:04 -0:00 -ksh
Note that if the problem was caused by an incorrect shell, the
last line of output would list -csh or -bsh instead of -ksh.
3. Kill these processes using kill -9. If the problem is due to a
hung compilation command, you do not need to kill the in.dtia
process, because it can be reused. If the problem is due to
using the wrong shell, you must kill all the processes,
including the in.dtia process.
Note: Using kill -9 to kill the Ada compiler locks the Ada
library that was being compiled. Consequently you will need to
unlock that library the next time you attempt to compile it. To
do this, call the compiler with the -u option.
10 December 1992 RATIONAL\f
Release 2_0_2
10. Documentation
The Rational Compilation Integrator: IBM RISC System/6000
Extension User's Guide, PN 4000-00482, Revision 2.0, is
available.
Refer to the Customizable RCI Release Notes for information on
RCI documentation.
11. Training
Refer to the Customizable RCI Release Notes for training
information.
RATIONAL December 1992 11\f
Release 2_0_2
Contents
1. Overview 1
2. RCI Components 1
3. Upgrade Impact 1
4. Prerequisites 2
5. New Features 3
5.1. Batch Compilation 3
5.2. New Implementation-Dependent Pragmas 3
5.3. New Predefined Packages 4
6. Fixed Problems 4
6.1. Invalid Reusable Component 5
6.2. Pragma Interface_Information 6
6.3. Uploading Executable Files 6
6.4. Remote Filename Length 6
6.5. Unhandled Exception from Import Operation 6
6.6. Inconsistent Imports 7
6.7. Including Multiple Libraries 7
6.8. Os_Task Option 7
6.9. Compiler Compatibility for Pragmas 8
7. Limitations 8
7.1. Limits to Ada/6000 Release 3.0 Compiler Compatibility 8
7.2. Batch Compilation and Compiler Options 8
7.3. Recovery from Batch Compilation Failures 8
7.4. Semantic Checking 9
8. Known Problems 9
8.1. Remote Access Control 9
9. Troubleshooting 9
10. Documentation 11
11. Training 11
RATIONAL December 1992 iii\f
Rs6000 RCI Release Information
iv December 1992 RATIONAL