|
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: 70539 (0x1138b)
Types: TextFile
Notes: R1k Text-file segment
└─⟦8527c1e9b⟧ Bits:30000544 8mm tape, Rational 1000, Arrival backup of disks in PAM's R1000
└─ ⟦cfc2e13cd⟧ »Space Info Vol 2«
└─⟦373e17fc2⟧
└─⟦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\f
%!PS-Adobe-2.0
%%Title: !DOCUMENTATION.RELEASE_NOTES.REMOTE_COMPILATION_FACILITIES.PROD_WORKING.UNITS.RCI_RS6000_AIX_IBM2_0_2'V(1)
%%Creator: COMPOSE 10.7.12
%%CreationDate: December 3, 1992 at 10:20:04 AM
%%For: KP
%%Pages: (atend)
%%DocumentFonts: (atend)
%%EndComments
/SelectFont {findfont exch dup neg 0 0 3 -1 roll 0 0 MAT astore makefont setfont} bind def
/BeginPage {/State save def /INITIAL-MATRIX matrix currentmatrix def 1 -1 scale 0.5 setlinewidth} bind def
/PositionPage {{-90 rotate pop} {0 exch neg translate} ifelse} bind def
/EndPage {State restore showpage} def
/WS {0 32 4 -1 roll widthshow} bind def
/MX {0 rmoveto} bind def
/LTAB {gsave exch (.) stringwidth pop sub exch {dup 2 div dup 0 rmoveto (.) show 0 rmoveto} repeat pop grestore} bind def
/MAT matrix def
/FINDSCALE {gsave newpath 0 0 moveto (X) false charpath
flattenpath pathbbox /CAPHEIGHT exch def pop pop pop newpath 0 0 moveto
(x) false charpath flattenpath pathbbox /XHEIGHT exch def pop pop pop
grestore XHEIGHT CAPHEIGHT XHEIGHT sub 3 div add CAPHEIGHT div } bind def
/CAP-ENCODING [ StandardEncoding aload pop ] def
8#141 1 8#172 {CAP-ENCODING exch dup 1 string dup 0 4 -1 roll 8#40 sub put cvn put} for
/COPYFONT {dup length dict /TMPDICT exch def {1 index /FID ne {TMPDICT 3 1 roll put} {pop pop} ifelse } forall TMPDICT }bind def
/SYM {save exch /newfont currentfont maxlength dict def currentfont
{exch dup /FID ne {dup /Encoding eq {exch dup length array copy newfont 3 1 roll put}
{exch newfont 3 1 roll put} ifelse } {pop pop} ifelse} forall
newfont /Encoding get 8#377 3 -1 roll put /NEWFONT newfont definefont setfont
(\377) show restore} bind def
%%EndProlog
%%Page: 1 1
BeginPage
792 false PositionPage
72 72 moveto
20 /Palatino-Roman SelectFont
( ) show
161.380 328 moveto
(Rational Compilation Integrator:) show
155.610 350 moveto
(IBM RISC System/6000 Extension) show
217.090 372 moveto
(Release Information) show
242.800 416 moveto
( Release 2_0_2) show
EndPage
%%Page: 2 2
BeginPage
792 false PositionPage
72 72 moveto
10 /Palatino-Roman SelectFont
( ) show
72 144 moveto
(Copyright ) show
/copyright SYM 7.470 MX
( 1992 by Rational) show
72 192 moveto
(Part Number: 508-003256-009) show
72 216 moveto
(December 1992 \050Software Release 2_0_2\051) show
72 576 moveto
9 /Palatino-Roman SelectFont
(AIX and RISC System/6000 are trademarks and IBM is a registered trademark of International Business Machines) 1.026 WS
72 587 moveto
(Corporation.) show
72 609 moveto
(Rational and R1000 are registered trademarks and Rational Environment is a trademark of Rational.) show
287.480 668 moveto
10 /Palatino-Roman SelectFont
(Rational) show
259.660 680 moveto
(3320 Scott Boulevard) show
229.255 692 moveto
(Santa Clara, California 95054-3197) show
EndPage
%%Page: 1 3
BeginPage
792 false PositionPage
72 36 moveto
10 /Palatino-Roman SelectFont
407.300 MX
(Release 2_0_2) show
72 76 moveto
15 /Palatino-Bold SelectFont
(1. Overview) show
72 100 moveto
11 /Palatino-Roman SelectFont
(This release note describes the enhancement release,) 0.318 WS
3.069 MX
(Release 2_0_2, of the Rational Compilation) 0.319 WS
72 113 moveto
(Integrator: IBM) 3.093 WS
0 -2.750 rmoveto
8 /Palatino-Roman SelectFont
/registered SYM 5.976 MX
11 /Palatino-Roman SelectFont
0 2.750 rmoveto
( RISC) 3.093 WS
5.842 MX
(System/6000) show
/trademark SYM 10.769 MX
( Extension \050Rs6000 RCI\051. This Rs6000 RCI release is) 3.092 WS
72 126 moveto
(compatible with Release 2_0_5 of) 3.484 WS
6.235 MX
(the Rational Compilation Integrator, referred to as the) 3.485 WS
72 139 moveto
(Customizable RCI.) show
72 163 moveto
(In particular, this release implements optimal batch mode processing, additional) 8.517 WS
72 176 moveto
(implementation-dependent pragmas,) 8.528 WS
11.279 MX
(and includes predefined packages in !Targets-) 8.529 WS
72 189 moveto
(.Rs6000_Aix_Ibm.Target_Interface.) show
72 213 moveto
(This note covers Rs6000_Aix_Ibm-specific release issues.) 0.316 WS
3.065 MX
(Refer to the Customizable RCI Release) 0.315 WS
72 226 moveto
(Note for general product information.) show
72 266 moveto
15 /Palatino-Bold SelectFont
(2. RCI Components) show
72 290 moveto
11 /Palatino-Roman SelectFont
(The following Rs6000 RCI components are installed as part of the release:) show
72 326 moveto
10 /Courier-Bold SelectFont
(!Targets.Implementation.Release_Rs6000_Aix_Ibm2_0_2) show
72 338 moveto
( -- Rs6000 RCI release world) show
72 362 moveto
(!Targets.Rs6000_Aix_Ibm -- Rs6000 Predefined Units) show
72 386 moveto
(!Targets.Implementation.Rci_Customization.Rs6000_Aix_Ibm) show
72 398 moveto
( Rev2_0_Spec -- Customization views) show
72 410 moveto
( Rev2_0_2 -- Includes templates, and) show
72 422 moveto
( -- extensions.) show
72 446 moveto
11 /Palatino-Roman SelectFont
(For more information on installation of this product, refer to) 3.291 WS
6.042 MX
(the installation instructions) 3.292 WS
72 459 moveto
(delivered with this release. For user information,) 0.339 WS
3.088 MX
(refer to the) 0.338 WS
11 /Palatino-Italic SelectFont
( RCI User's Manual) 0.338 WS
11 /Palatino-Roman SelectFont
( and) 0.338 WS
11 /Palatino-Italic SelectFont
( Rs6000 RCI) 0.338 WS
72 472 moveto
(User's Guide) show
11 /Palatino-Roman SelectFont
(.) show
72 512 moveto
15 /Palatino-Bold SelectFont
(3. Upgrade Impact) show
72 536 moveto
11 /Palatino-Roman SelectFont
(In this release,) 0.844 WS
3.595 MX
(the product name changes from Rational Remote Compilation Facility \050RCF\051 to) 0.845 WS
72 549 moveto
(Rational Compilation Integrator \050RCI\051. As of this release, the) 0.132 WS
2.881 MX
(Rs6000 RCI no longer supports Rcf) 0.131 WS
72 562 moveto
(packages. Corresponding names for all packages have changed from Rcf to Rci.) show
72 586 moveto
(The Rs6000 RCI) 1.141 WS
3.892 MX
(has no special upgrade impact. However, some upgrade impact is associated) 1.142 WS
72 599 moveto
(with moving to) 0.635 WS
3.384 MX
(RCI Rev2_0_5, including switch name changes and state file changes. Upgrade) 0.634 WS
72 612 moveto
(tools are provided with RCI Rev2_0_5 to) 1.929 WS
4.680 MX
(convert existing views \050including Rs6000_Aix_Ibm) 1.930 WS
72 625 moveto
(views\051 to Rev 2_0_5.) show
72 665 moveto
15 /Palatino-Bold SelectFont
(4. Prerequisites) show
72 689 moveto
11 /Palatino-Roman SelectFont
(Before you use the Rs6000 RCI, confirm the following prerequisite conditions:) show
72 713 moveto
(\267 ) show
14.584 MX
(The remote user accounts use Korn) 0.537 WS
3.286 MX
(Shell. If not, remote command execution fails with the) 0.536 WS
96 726 moveto
(message \252variable syntax error\272.) show
72 756 moveto
17 /AvantGarde-Book SelectFont
(RATIONAL) show
10 /Palatino-Roman SelectFont
( December 1992) show
301.370 MX
(1) show
EndPage
%%Page: 2 4
BeginPage
792 false PositionPage
72 36 moveto
10 /Palatino-Roman SelectFont
(Rs6000 RCI Release Information) show
72 72 moveto
11 /Palatino-Roman SelectFont
(\267 ) show
14.584 MX
(IBM AIX) show
/trademark SYM 10.769 MX
( Version 3.1 \050or later\051 is running on the remote RISC System/6000.) show
72 90 moveto
(\267 ) show
14.584 MX
(The IBM AIX Ada/6000 compiler, Version 2.0 \050or later\051, is installed on the) 1.516 WS
4.267 MX
(remote RISC) 1.517 WS
96 103 moveto
(System/6000 in /usr/bin/ada.) show
72 121 moveto
(\267 ) show
14.584 MX
(The host R1000 and remote RISC System/6000 are on the same network.) show
72 139 moveto
(\267 ) show
14.584 MX
(DTIA servers are) 1.429 WS
4.178 MX
(installed on both the host R1000 and the remote RISC System/6000. If) 1.428 WS
96 152 moveto
(not, you can encounter the following:) show
96 170 moveto
/minus SYM 6.666 MX
( ) show
14.584 MX
(The Rs6000 RCI does) 0.643 WS
3.394 MX
(not elaborate if the host DTIA Remote_Operations server is not) 0.644 WS
120 183 moveto
(installed.) show
96 201 moveto
/minus SYM 6.666 MX
( ) show
14.584 MX
(Remote commands cannot execute if the remote DTIA server is not running.) show
96 219 moveto
(Use the following steps to confirm that both servers are running:) show
96 237 moveto
(1.) show
15.750 MX
(To detect if the host server is already running:) show
120 255 moveto
/minus SYM 6.666 MX
( ) show
14.584 MX
(Execute What.Users.) show
120 273 moveto
/minus SYM 6.666 MX
( ) show
14.584 MX
(Search for job name) show
11 /Palatino-Italic SelectFont
( DTIA Remote_Operations Server) show
11 /Palatino-Roman SelectFont
( in the list.) show
96 291 moveto
(2.) show
15.750 MX
(To detect if the remote server is running, execute this command) 2.239 WS
4.988 MX
(from the remote) 2.238 WS
120 304 moveto
(command shell:) show
120 328 moveto
10 /Courier-Bold SelectFont
($ ps aux) show
120 352 moveto
11 /Palatino-Roman SelectFont
(This command displays a list of system processes. Look for an) 2.110 WS
4.861 MX
(entry for the) 2.111 WS
11 /Palatino-Italic SelectFont
( inetd) 2.111 WS
120 365 moveto
11 /Palatino-Roman SelectFont
(process, similar to the following:) show
120 389 moveto
10 /Courier-Bold SelectFont
(root 5084 1989 0 17:26:01 ? 0:00 /etc/inetd) show
96 413 moveto
11 /Palatino-Roman SelectFont
(3.) show
15.750 MX
(View the inetd configuration file to make sure that DTIA has been registered:) show
120 437 moveto
10 /Courier-Bold SelectFont
($ cat /etc/inetd.conf) show
120 461 moveto
11 /Palatino-Roman SelectFont
(Look for an entry at the end of the file for DTIA.) show
120 485 moveto
10 /Courier-Bold SelectFont
(dtia stream tcp nowait root /usr/etc/in.dtia in.dtia) show
96 509 moveto
11 /Palatino-Roman SelectFont
(Refer to the DTIA Installation and Release Notes for information) 0.193 WS
2.942 MX
(on how to restart the host) 0.192 WS
96 522 moveto
(and remote servers.) show
72 540 moveto
(\267 ) show
14.584 MX
(The RCI is running. \050After) 5.685 WS
8.436 MX
(installation, the RCI starts automatically at machine) 5.686 WS
96 553 moveto
(initialization.\051) show
96 571 moveto
(To start the RCI:) show
96 589 moveto
(1.) show
15.750 MX
(Run Start_Rci_Main to start the RCI compiler job.) show
96 607 moveto
(2.) show
15.750 MX
(Use Rs6000_Aix_Ibm.Register to register your extension.) show
96 625 moveto
(3.) show
15.750 MX
(Use What.Users to list the jobs and check for the following:) show
120 643 moveto
/minus SYM 6.666 MX
( ) show
14.584 MX
(DTIA Remote_Operations Server) show
120 661 moveto
/minus SYM 6.666 MX
( ) show
14.584 MX
(Rci_Compiler Rev2_0_5 \050or later\051) show
120 679 moveto
/minus SYM 6.666 MX
( ) show
14.584 MX
(Rci_Rev2_0_2_Rs6000_Aix_Ibm_DTIA) show
72 756 moveto
10 /Palatino-Roman SelectFont
(2) show
299.161 MX
(December 1992 ) show
17 /AvantGarde-Book SelectFont
( RATIONAL) show
EndPage
%%Page: 3 5
BeginPage
792 false PositionPage
72 36 moveto
10 /Palatino-Roman SelectFont
407.300 MX
(Release 2_0_2) show
72 76 moveto
15 /Palatino-Bold SelectFont
(5. New Features) show
72 100 moveto
11 /Palatino-Roman SelectFont
(This section describes feature changes added since the Rs6000 RCF Rev1_1_0 release.) show
72 138 moveto
13 /Palatino-Bold SelectFont
(5.1. Batch Compilation) show
72 162 moveto
11 /Palatino-Roman SelectFont
(The Rs6000 RCI can now be registered) 0.921 WS
3.670 MX
(for either batch compilation mode or interactive mode.) 0.920 WS
72 175 moveto
(Under batch compilation mode, the Rs6000 RCI generates an optimal batch script) 4.283 WS
7.034 MX
(that) show
72 188 moveto
(minimizes the number of times the Ada/6000 compiler is elaborated.) show
72 226 moveto
13 /Palatino-Bold SelectFont
(5.2. New Implementation-Dependent Pragmas) show
72 250 moveto
11 /Palatino-Roman SelectFont
(The Rs6000 RCI now supports the following pragmas:) show
72 274 moveto
(\267 ) show
14.584 MX
(Interface_Information) show
72 292 moveto
(\267 ) show
14.584 MX
(No_Suppress) show
72 310 moveto
(\267 ) show
14.584 MX
(Preserve_Layout) show
72 328 moveto
(\267 ) show
14.584 MX
(Suppress_All) show
72 352 moveto
(See the) show
11 /Palatino-Italic SelectFont
( RCI Rs6000 User's Guide) show
11 /Palatino-Roman SelectFont
( for more information.) show
72 390 moveto
13 /Palatino-Bold SelectFont
(5.3. New Predefined Packages) show
72 414 moveto
11 /Palatino-Roman SelectFont
(The Rs6000 RCI now includes the following predefined packages) 9.101 WS
11.850 MX
(in !Targets.-) 9.100 WS
72 427 moveto
(Rs6000_Aix_Ibm.Target_Interface:) show
72 451 moveto
10 /Courier-Bold SelectFont
(!Targets.Rs6000_Aix_Ibm.Target_Interface : Directory;) show
72 463 moveto
( Ada_Debugging_Support : C Pack_Spec;) show
72 475 moveto
( Aix_Environment_Variables : C Pack_Spec;) show
72 487 moveto
( Command_Line : C Pack_Spec;) show
72 499 moveto
( Device : C Pack_Spec;) show
72 511 moveto
( Elementary_Functions : C Pack_Inst;) show
72 523 moveto
( Elementary_Functions_Exceptions : C Pack_Spec;) show
72 535 moveto
( Fast_Math : C Pack_Inst;) show
72 547 moveto
( Generic_Elementary_Functions : C Gen_Pack;) show
72 559 moveto
( Generic_Math : C Gen_Pack;) show
72 571 moveto
( Generic_Primitive_Functions : C Gen_Pack;) show
72 583 moveto
( Gl : C Pack_Spec;) show
72 595 moveto
( Gl_Flags : C Gen_Pack;) show
72 607 moveto
( Gl_System_Types : C Pack_Spec;) show
72 619 moveto
( Interrupt : C Pack_Spec;) show
72 631 moveto
( Key_Syms : C Pack_Spec;) show
72 643 moveto
( Long_Elementary_Functions : C Pack_Inst;) show
72 655 moveto
( Math : C Pack_Inst;) show
72 667 moveto
( X_Windows : C Pack_Spec;) show
72 756 moveto
17 /AvantGarde-Book SelectFont
(RATIONAL) show
10 /Palatino-Roman SelectFont
( December 1992) show
301.370 MX
(3) show
EndPage
%%Page: 4 6
BeginPage
792 false PositionPage
72 36 moveto
10 /Palatino-Roman SelectFont
(Rs6000 RCI Release Information) show
72 76 moveto
15 /Palatino-Bold SelectFont
(6. Fixed Problems) show
72 100 moveto
11 /Palatino-Roman SelectFont
(This section describes problems that) 3.782 WS
6.533 MX
(have been fixed since the Rev1_1_0 release of this) 3.783 WS
72 113 moveto
(extension.) show
72 137 moveto
(The following table provides the PRS number of the problem, the section number) 3.031 WS
5.780 MX
(of the) 3.030 WS
72 150 moveto
(description in this release note, and the PRS summary of the problem.) show
0 16.500 rmoveto
243.450 179.500 moveto
10 /Palatino-BoldItalic SelectFont
(Summary of Fixed Problems) show
72 192.500 moveto
11 /Palatino-Roman SelectFont
0 -16.500 rmoveto
102.865 200 moveto
10 /Palatino-Bold SelectFont
(PRS Number) show
194.810 200 moveto
10 /Palatino-Roman SelectFont
( ) show
10 /Palatino-Bold SelectFont
(Section) show
193.835 212 moveto
(Number) show
352.805 200 moveto
(PRS Summary) show
newpath 78 218 moveto
456 0 rlineto stroke
newpath 78 188 moveto
456 0 rlineto stroke
newpath 78 218 moveto
0 -30 rlineto stroke
newpath 534 218 moveto
0 -30 rlineto stroke
newpath 188 218 moveto
0 -30 rlineto stroke
newpath 238 218 moveto
0 -30 rlineto stroke
newpath 78 218 moveto
456 0 rlineto stroke
newpath 78 188 moveto
456 0 rlineto stroke
newpath 78 218 moveto
0 -30 rlineto stroke
newpath 534 218 moveto
0 -30 rlineto stroke
newpath 188 218 moveto
0 -30 rlineto stroke
newpath 238 218 moveto
0 -30 rlineto stroke
82 230 moveto
10 /Palatino-Roman SelectFont
(1015852-Jazm-Jak) show
192 230 moveto
19.500 MX
(6.1) show
242 230 moveto
(Does Math_Pack belong in reusable components?) show
newpath 78 236 moveto
456 0 rlineto stroke
newpath 78 218 moveto
456 0 rlineto stroke
newpath 78 236 moveto
0 -18 rlineto stroke
newpath 534 236 moveto
0 -18 rlineto stroke
newpath 188 236 moveto
0 -18 rlineto stroke
newpath 238 236 moveto
0 -18 rlineto stroke
82 248 moveto
(1154041-Jazm-Jak) show
192 248 moveto
19.500 MX
(6.2) show
242 248 moveto
(missing pragma Interface_Information) show
newpath 78 254 moveto
456 0 rlineto stroke
newpath 78 236 moveto
456 0 rlineto stroke
newpath 78 254 moveto
0 -18 rlineto stroke
newpath 534 254 moveto
0 -18 rlineto stroke
newpath 188 254 moveto
0 -18 rlineto stroke
newpath 238 254 moveto
0 -18 rlineto stroke
82 266 moveto
(1227523-Gato-Mboy) show
192 266 moveto
19.500 MX
(6.3) show
242 266 moveto
(Allow EXE retrieve to be an option on customization) show
newpath 78 272 moveto
456 0 rlineto stroke
newpath 78 254 moveto
456 0 rlineto stroke
newpath 78 272 moveto
0 -18 rlineto stroke
newpath 534 272 moveto
0 -18 rlineto stroke
newpath 188 272 moveto
0 -18 rlineto stroke
newpath 238 272 moveto
0 -18 rlineto stroke
82 284 moveto
(1659718-Jazm-Jak) show
192 284 moveto
19.500 MX
(6.4) show
242 284 moveto
(Target filename length) show
newpath 78 290 moveto
456 0 rlineto stroke
newpath 78 272 moveto
456 0 rlineto stroke
newpath 78 290 moveto
0 -18 rlineto stroke
newpath 534 290 moveto
0 -18 rlineto stroke
newpath 188 290 moveto
0 -18 rlineto stroke
newpath 238 290 moveto
0 -18 rlineto stroke
82 302 moveto
(5981731-Wood-Raj) show
192 302 moveto
19.500 MX
(6.5) show
242 302 moveto
(Rcf_Cmvc.Import when used with an Rs6000 customization) show
242 314 moveto
(raises an unhandled exception <space index = 289> caught in) show
242 326 moveto
(import_postprocess. This happens only when a unit name is) show
242 338 moveto
(given instead of a view name for the Into_View parameter.) show
newpath 78 344 moveto
456 0 rlineto stroke
newpath 78 290 moveto
456 0 rlineto stroke
newpath 78 344 moveto
0 -54 rlineto stroke
newpath 534 344 moveto
0 -54 rlineto stroke
newpath 188 344 moveto
0 -54 rlineto stroke
newpath 238 344 moveto
0 -54 rlineto stroke
82 356 moveto
(606019-Gato-Mboy) show
192 356 moveto
19.500 MX
(6.6) show
242 356 moveto
(Imports on R1000 and RS6000 alib.list not consistent) show
newpath 78 362 moveto
456 0 rlineto stroke
newpath 78 344 moveto
456 0 rlineto stroke
newpath 78 362 moveto
0 -18 rlineto stroke
newpath 534 362 moveto
0 -18 rlineto stroke
newpath 188 362 moveto
0 -18 rlineto stroke
newpath 238 362 moveto
0 -18 rlineto stroke
82 374 moveto
(8263832-Gato-Mboy) show
192 374 moveto
19.500 MX
(6.2) show
242 374 moveto
(pragma Interface_Information causes semantic error) show
newpath 78 380 moveto
456 0 rlineto stroke
newpath 78 362 moveto
456 0 rlineto stroke
newpath 78 380 moveto
0 -18 rlineto stroke
newpath 534 380 moveto
0 -18 rlineto stroke
newpath 188 380 moveto
0 -18 rlineto stroke
newpath 238 380 moveto
0 -18 rlineto stroke
82 392 moveto
(9018679-Gato-Mboy) show
192 392 moveto
19.500 MX
(6.7) show
242 392 moveto
(Suggestion: Fix -i options to work better when including) show
242 404 moveto
(multiple libraries) show
newpath 78 410 moveto
456 0 rlineto stroke
newpath 78 380 moveto
456 0 rlineto stroke
newpath 78 410 moveto
0 -30 rlineto stroke
newpath 534 410 moveto
0 -30 rlineto stroke
newpath 188 410 moveto
0 -30 rlineto stroke
newpath 238 410 moveto
0 -30 rlineto stroke
82 422 moveto
(917835-Gato-Mboy) show
192 422 moveto
19.500 MX
(6.8) show
242 422 moveto
(The Os_Task option is a link-only option, not a compilation) show
242 434 moveto
(option) show
newpath 78 440 moveto
456 0 rlineto stroke
newpath 78 410 moveto
456 0 rlineto stroke
newpath 78 440 moveto
0 -30 rlineto stroke
newpath 534 440 moveto
0 -30 rlineto stroke
newpath 188 440 moveto
0 -30 rlineto stroke
newpath 238 440 moveto
0 -30 rlineto stroke
82 452 moveto
(9679188-Gato-Mboy) show
192 452 moveto
19.500 MX
(6.9) show
242 452 moveto
(Rs6000_Aix_Ibm should be compatible with rev 3.0 of AIX) show
242 464 moveto
(ADA/6000 for pragmas) show
newpath 78 470 moveto
456 0 rlineto stroke
newpath 78 440 moveto
456 0 rlineto stroke
newpath 78 470 moveto
0 -30 rlineto stroke
newpath 534 470 moveto
0 -30 rlineto stroke
newpath 188 470 moveto
0 -30 rlineto stroke
newpath 238 470 moveto
0 -30 rlineto stroke
newpath 78 470 moveto
456 0 rlineto stroke
newpath 78 440 moveto
456 0 rlineto stroke
72 532 moveto
13 /Palatino-Bold SelectFont
(6.1. Invalid Reusable Component) show
72 556 moveto
11 /Palatino-Roman SelectFont
(PRS Number => 1015852-Jazm-Jak) show
72 580 moveto
(The package Math_Pack has been removed from) 7.798 WS
10.549 MX
(!Targets.Rs6000_Aix_Ibm.Reusable-) show
72 593 moveto
(_Components. This package spec was removed because it does) 2.414 WS
5.163 MX
(not exist for the Ada/6000) 2.413 WS
72 606 moveto
(compiler.) show
72 644 moveto
13 /Palatino-Bold SelectFont
(6.2. Pragma Interface_Information) show
72 668 moveto
11 /Palatino-Roman SelectFont
(PRS Number => 1154041-Jazm-Jak, 8263832-Gato-Mboy) show
72 692 moveto
(Previous to this release, code containing pragma Interface_Information would) 0.712 WS
3.463 MX
(not semanticize,) 0.713 WS
72 705 moveto
(returning the following warning instead:) show
108 729 moveto
10 /Courier-Bold SelectFont
(Interface_Information is undefined.) show
72 756 moveto
10 /Palatino-Roman SelectFont
(4) show
299.161 MX
(December 1992 ) show
17 /AvantGarde-Book SelectFont
( RATIONAL) show
EndPage
%%Page: 5 7
BeginPage
792 false PositionPage
72 36 moveto
10 /Palatino-Roman SelectFont
407.300 MX
(Release 2_0_2) show
72 72 moveto
11 /Palatino-Roman SelectFont
(As of this release, the Rs6000 RCI supports pragma Interface_Information) 1.966 WS
4.715 MX
(for the Ada/6000) 1.965 WS
72 85 moveto
(compiler.) show
72 123 moveto
13 /Palatino-Bold SelectFont
(6.3. Uploading Executable Files) show
72 147 moveto
11 /Palatino-Roman SelectFont
(PRS Number => 1227523-Gato-Mboy) show
72 171 moveto
(In previous releases, the Rs6000 RCI automatically uploaded) 0.638 WS
3.389 MX
(the executable module created by) 0.639 WS
72 184 moveto
(the remote linker. A new session) 1.522 WS
4.271 MX
(switch, Session_Rci.Retrieve_Executable, has been added to) 1.521 WS
72 197 moveto
(the RCI base product to determine whether or not the) 2.849 WS
5.600 MX
(RCI should upload the executable) 2.850 WS
72 210 moveto
(module to the host. If you want to upload the executable file, set the value) 4.870 WS
7.619 MX
(of the) 4.869 WS
72 223 moveto
(Session_Rci.Retrieve_Executable switch to True.) show
72 261 moveto
13 /Palatino-Bold SelectFont
(6.4. Remote Filename Length) show
72 285 moveto
11 /Palatino-Roman SelectFont
(PRS Number => 1659718-Jazm-Jak) show
72 309 moveto
(In previous releases, the RS6000 extension limited the length of) 1.012 WS
3.763 MX
(a filename on the compilation) 1.013 WS
72 322 moveto
(platform to 31 characters. This limit is now 255 characters.) show
72 360 moveto
13 /Palatino-Bold SelectFont
(6.5. Unhandled Exception from Import Operation) show
72 384 moveto
11 /Palatino-Roman SelectFont
(PRS Number => 5981731-Wood-Raj) show
72 408 moveto
(Previous to this release, the Rcf_Cmvc.Import operation raised an unhandled exception) 1.294 WS
4.043 MX
(if the) 1.293 WS
72 421 moveto
(Into_View parameter specified the Units directory of a view \050) 9.801 WS
10 /Courier-Bold SelectFont
(Into_View =>) 9.801 WS
72 434 moveto
(View_Name.Units) show
11 /Palatino-Roman SelectFont
(\051, instead of just the view name \050) show
10 /Courier-Bold SelectFont
(Into_View => View_Name) show
11 /Palatino-Roman SelectFont
(\051.) show
72 458 moveto
(As of this release, the Rs6000 RCI no longer supports the use of the Rcf_Cmvc.Import) 3.859 WS
72 471 moveto
(command. Instead, you use Cmvc.Import to manage host and) 1.035 WS
3.786 MX
(remote imports. The Into_View) 1.036 WS
72 484 moveto
(parameter of the Cmvc.Import command accepts either a view name or the name of) 1.231 WS
3.980 MX
(a view's) 1.230 WS
72 497 moveto
(Units directory.) show
72 535 moveto
13 /Palatino-Bold SelectFont
(6.6. Inconsistent Imports) show
72 559 moveto
11 /Palatino-Roman SelectFont
(PRS Number => 606019-Gato-Mboy) show
72 583 moveto
(Previous to this release, the) 2.856 WS
5.607 MX
(Rcf.Refresh_View, Rcf.Build_Remote_Library, and Rcf.Rebuild-) 2.857 WS
72 596 moveto
(_Remote_Library commands did not always create correct import lists) 0.514 WS
3.263 MX
(\050) show
10 /Courier-Bold SelectFont
(alib.list) show
11 /Palatino-Roman SelectFont
( files\051 on the) 0.513 WS
72 609 moveto
(remote compilation platform.) show
72 633 moveto
(In particular, whenever you used these commands to build a set) 0.051 WS
2.802 MX
(of remote libraries from a set of) 0.052 WS
72 646 moveto
(host views, the remote imports list would be incorrect unless) 0.088 WS
2.837 MX
(you built the remote libraries from) 0.087 WS
72 659 moveto
(the bottom up \050that) 0.665 WS
3.416 MX
(is, starting with the views that have no imports then building their clients,) 0.666 WS
72 672 moveto
(then building the next layer of clients, and so on\051.) show
72 696 moveto
(When you use the Rci.Refresh_View, Rci.Build_Remote_Library, and) 3.799 WS
6.548 MX
(Rci.Rebuild_Remote-) show
72 709 moveto
(_Library commands, the remote imports lists will be correct regardless of the order in) 1.402 WS
4.153 MX
(which) show
72 722 moveto
(you build the remote libraries.) show
72 756 moveto
17 /AvantGarde-Book SelectFont
(RATIONAL) show
10 /Palatino-Roman SelectFont
( December 1992) show
301.370 MX
(5) show
EndPage
%%Page: 6 8
BeginPage
792 false PositionPage
72 36 moveto
10 /Palatino-Roman SelectFont
(Rs6000 RCI Release Information) show
72 74 moveto
13 /Palatino-Bold SelectFont
(6.7. Including Multiple Libraries) show
72 98 moveto
11 /Palatino-Roman SelectFont
(PRS Number => 9018679-Gato-Mboy) show
72 122 moveto
(Previous versions of the) 2.447 WS
11 /Palatino-Italic SelectFont
( IBM RISC System/6000 User's Guide) 2.447 WS
11 /Palatino-Roman SelectFont
( did not explicitly describe the) 2.446 WS
72 135 moveto
(correct syntax for specifying the Rci.Rs6000_Aix_Ibm_Include switch.) show
72 159 moveto
(The Rci.Rs6000_Aix_Ibm_Include switch sets the ) 6.047 WS
10 /Courier-Bold SelectFont
(-i) show
11 /Palatino-Roman SelectFont
( option for) 6.047 WS
8.798 MX
(the Ada/6000 linker.) 6.048 WS
72 172 moveto
(Consequently, the switch value must conform to the syntax required by the linker for the ) 1.393 WS
10 /Courier-Bold SelectFont
(-i) show
72 185 moveto
11 /Palatino-Roman SelectFont
(option. In particular, you must specify ) show
10 /Courier-Bold SelectFont
(-i) show
11 /Palatino-Roman SelectFont
( before) show
11 /Palatino-Italic SelectFont
( each) show
11 /Palatino-Roman SelectFont
( of the included libraries -- for example:) show
108 209 moveto
10 /Courier-Bold SelectFont
(* Rci . Rs6000_Aix_Ibm_Include : String := "-i libXt -i libXm -i mylib") show
72 233 moveto
11 /Palatino-Roman SelectFont
(The current version of the Guide documents this.) show
72 271 moveto
13 /Palatino-Bold SelectFont
(6.8. Os_Task Option) show
72 295 moveto
11 /Palatino-Roman SelectFont
(PRS Number => 917835-Gato-Mboy) show
72 319 moveto
(Previous to) 0.611 WS
3.362 MX
(this release, setting the Rci.Rs6000_Aix_Ibm_Os_Task switch to True caused the ) 0.612 WS
10 /Courier-Bold SelectFont
(-t) show
72 332 moveto
11 /Palatino-Roman SelectFont
(option to be set for both the compiler and linker instead of just the linker. The presence of ) 1.038 WS
10 /Courier-Bold SelectFont
(-t) show
72 345 moveto
11 /Palatino-Roman SelectFont
(would cause a compiler error.) show
72 369 moveto
(As of this release, setting the Rci.Rs6000_Aix_Ibm_Os_Task) 1.380 WS
4.131 MX
(switch to True sets the ) 1.381 WS
10 /Courier-Bold SelectFont
(-t) show
11 /Palatino-Roman SelectFont
( option) 1.381 WS
72 382 moveto
(only for the linker.) show
72 420 moveto
13 /Palatino-Bold SelectFont
(6.9. Compiler Compatibility for Pragmas) show
72 444 moveto
11 /Palatino-Roman SelectFont
(PRS Number => 9679188-Gato-Mboy) show
72 468 moveto
11 /Palatino-Italic SelectFont
(Note: To use the Release 3.0 compiler, your) 5.962 WS
8.711 MX
(customizer must upgrade package System in) 5.961 WS
72 481 moveto
(!Targets.Rs6000_Aix_Ibm.Lrm. All units compiled with AIX Ada/6000) 0.813 WS
3.564 MX
(Release 2.0 must be recompiled) 0.814 WS
72 494 moveto
(with Release 3.0.) show
72 518 moveto
11 /Palatino-Roman SelectFont
(As of this release, the Rs6000 RCI semantic checking for pragmas is compatible with) 0.274 WS
3.023 MX
(Release 3.0) 0.273 WS
72 531 moveto
(of the Ada/6000 compiler. See Section 5.2 for a list of added supported pragmas.) show
72 571 moveto
15 /Palatino-Bold SelectFont
(7. Limitations) show
72 595 moveto
11 /Palatino-Roman SelectFont
(This section describes limitations in this Rs6000 RCI release.) show
72 633 moveto
13 /Palatino-Bold SelectFont
(7.1. Limits to Ada/6000 Release 3.0 Compiler Compatibility) show
72 657 moveto
11 /Palatino-Roman SelectFont
(This release does not supply) 3.638 WS
6.389 MX
(host library switches for the Ada/6000 Release 3.0-specific) 3.639 WS
72 670 moveto
(compiler and linker options. To enter those options in your commands, use the) 0.182 WS
2.931 MX
(appropriate RCI) 0.181 WS
72 683 moveto
(library switch for compiler and linker pre- or post-options.) show
72 707 moveto
(This release does not support semantic checking) 0.325 WS
3.076 MX
(for type SHORT_SHORT_INTEGER. This type) 0.326 WS
72 720 moveto
(is not defined in the Rs6000 RCI package Standard.) show
72 756 moveto
10 /Palatino-Roman SelectFont
(6) show
299.161 MX
(December 1992 ) show
17 /AvantGarde-Book SelectFont
( RATIONAL) show
EndPage
%%Page: 7 9
BeginPage
792 false PositionPage
72 36 moveto
10 /Palatino-Roman SelectFont
407.300 MX
(Release 2_0_2) show
72 74 moveto
13 /Palatino-Bold SelectFont
(7.2. Batch Compilation and Compiler Options) show
72 98 moveto
11 /Palatino-Roman SelectFont
(Batch scripts invoke the compiler with the ) 0.025 WS
10 /Courier-Bold SelectFont
(-I) show
11 /Palatino-Roman SelectFont
( option to) 0.025 WS
2.774 MX
(permit the compilation of multiple units.) 0.024 WS
72 111 moveto
(However, the ) 0.896 WS
10 /Courier-Bold SelectFont
(/usr/bin/ada/ada) show
11 /Palatino-Roman SelectFont
( command) 0.896 WS
3.647 MX
(does not accept the ) 0.897 WS
10 /Courier-Bold SelectFont
(-l) show
11 /Palatino-Roman SelectFont
( or the ) 0.897 WS
10 /Courier-Bold SelectFont
(-a) show
11 /Palatino-Roman SelectFont
( option when the) 0.897 WS
72 123 moveto
10 /Courier-Bold SelectFont
(-I) show
11 /Palatino-Roman SelectFont
( option is specified.) 5.651 WS
8.400 MX
(Consequently, you should make sure that the values of the) 5.650 WS
72 136 moveto
(Rci.Rs6000_Aix_Ibm_List and) 3.358 WS
6.109 MX
(the Rci.Rs6000_Aix_Ibm_Assemble library switches are False) 3.359 WS
72 149 moveto
(when you generate batch scripts.) show
72 187 moveto
13 /Palatino-Bold SelectFont
(7.3. Recovery from Batch Compilation Failures) show
72 211 moveto
11 /Palatino-Roman SelectFont
(Normally a batch script built on the host can be successfully compiled on the) 4.138 WS
6.887 MX
(remote) show
72 224 moveto
(compilation platform. However, for any of the following reasons,) 0.997 WS
3.748 MX
(a batch compile may fail on) 0.998 WS
72 237 moveto
(the remote RISC System/6000, even if all the host units have coded successfully:) show
72 261 moveto
(\267 ) show
14.584 MX
(Certain units that semanticize on) 3.891 WS
6.640 MX
(the host may not be semantically correct for the) 3.890 WS
96 274 moveto
(Ada/6000 compiler. For) 4.125 WS
6.876 MX
(example, this happens when representation clauses specify) 4.126 WS
96 287 moveto
(alignment of integers on word) 0.213 WS
2.962 MX
(boundaries which could cause the Ada/6000 compilation to) 0.212 WS
96 300 moveto
(fail.) show
72 318 moveto
(\267 ) show
14.584 MX
(The Ada/6000 compiler may) 0.015 WS
2.766 MX
(incorrectly reject valid Ada code in certain cases \050Rational can) 0.016 WS
96 331 moveto
(provide a list of these cases\051.) show
72 349 moveto
(\267 ) show
14.584 MX
(Supplier units may not be compiled on the remote compilation platform.) show
72 373 moveto
(When a batch compilation fails for any reason, the entire batch) 0.701 WS
3.450 MX
(script must be reexecuted. This) 0.700 WS
72 386 moveto
(is because batch scripts generated by the Rs6000 RCI are optimized to invoke the compiler) 0.320 WS
3.071 MX
(with) show
72 399 moveto
(the ) show
10 /Courier-Bold SelectFont
(-I) show
11 /Palatino-Roman SelectFont
( option once for each set of units in the same library.) show
72 423 moveto
(However, if any unit in a library fails to) 0.701 WS
3.450 MX
(compile while ) 0.700 WS
10 /Courier-Bold SelectFont
(-I) show
11 /Palatino-Roman SelectFont
( is used, the Ada/6000 compiler will) 0.700 WS
72 436 moveto
(not update) 3.819 WS
6.570 MX
(the library at all, even for units that would otherwise compile successfully.) 3.820 WS
72 449 moveto
(Consequently, you must reexecute the batch script for whole libraries even) 2.962 WS
5.711 MX
(if only a few) 2.961 WS
72 462 moveto
(individual units failed.) show
72 500 moveto
13 /Palatino-Bold SelectFont
(7.4. Semantic Checking) show
72 524 moveto
11 /Palatino-Roman SelectFont
(The RCI) 1.029 WS
3.780 MX
(performs semantic checking for the target as well as for the host. However, semantic) 1.030 WS
72 537 moveto
(checking for the target does not catch certain semantic errors pertaining to attributes, and) 0.376 WS
3.125 MX
(relies) show
72 550 moveto
(on the target compiler to detect such errors.) show
72 574 moveto
(If this causes a batch script to fail, you) 3.328 WS
6.079 MX
(should correct the units according to the target) 3.329 WS
72 587 moveto
(compiler's guidelines, and then re-execute the batch script \050see 7.3\051.) show
72 627 moveto
15 /Palatino-Bold SelectFont
(8. Known Problems) show
72 651 moveto
11 /Palatino-Roman SelectFont
(Following is a list of problems specific to the Rs6000 RCI known at the time of this release.) show
72 689 moveto
13 /Palatino-Bold SelectFont
(8.1. Remote Access Control) show
72 713 moveto
11 /Palatino-Roman SelectFont
(The remote DTIA server creates all remote files with the access permissions:) show
72 756 moveto
17 /AvantGarde-Book SelectFont
(RATIONAL) show
10 /Palatino-Roman SelectFont
( December 1992) show
301.370 MX
(7) show
EndPage
%%Page: 8 10
BeginPage
792 false PositionPage
72 36 moveto
10 /Palatino-Roman SelectFont
(Rs6000 RCI Release Information) show
72 72 moveto
10 /Courier-Bold SelectFont
( rw- r-- r--) show
72 96 moveto
11 /Palatino-Roman SelectFont
(This permission setting gives read and write permission to the owner of the file, but) 2.405 WS
5.154 MX
(read) show
72 109 moveto
(permission only to group and others. This can prevent host R1000 users with different) 0.929 WS
3.680 MX
(remote) show
72 122 moveto
(userids from operating on the same set of host views.) show
72 162 moveto
15 /Palatino-Bold SelectFont
(9. Troubleshooting) show
72 186 moveto
11 /Palatino-Roman SelectFont
(This section describes a technique for recovering from either of the following situations:) show
72 210 moveto
(\267 ) show
14.584 MX
(A host compilation command hangs due to any) 3.597 WS
6.346 MX
(cause. Relevant commands include) 3.596 WS
96 223 moveto
(Comp.Make, Comp.Promote, or a command such as Cmvc.Make_Path with the) 3.184 WS
5.935 MX
(Goal) show
96 236 moveto
(parameter set to Coded.) show
72 254 moveto
(\267 ) show
14.584 MX
(A host view-creation or library-creation command hangs with) 0.182 WS
2.931 MX
(the message Variable syntax) 0.181 WS
96 267 moveto
(error. Relevant commands include Cmvc.Make_Path, Rci_Cmvc.Make_Path, Rci.Build-) 3.402 WS
96 280 moveto
(_Remote_Library, and so on. This error occurs if the shell) 1.947 WS
4.696 MX
(associated with your remote) 1.946 WS
96 293 moveto
(userid is not the Korn shell.) show
72 317 moveto
(To recover from either of these situations, you must kill the host) 0.297 WS
3.048 MX
(command and kill the relevant) 0.298 WS
72 330 moveto
(processes on the remote compilation platform:) show
72 354 moveto
(1.) show
15.750 MX
(On the R1000 host, execute the Job.Kill command:) show
96 378 moveto
10 /Courier-Bold SelectFont
(Job.Kill \050The_Job => [ID-expression], The_Session => ""\051;) show
96 402 moveto
11 /Palatino-Roman SelectFont
(This kills the host command, but does not affect the status of remote processes.) show
72 420 moveto
(2.) show
15.750 MX
(On the remote compilation) 1.171 WS
3.920 MX
(platform, use the following command to search for processes) 1.170 WS
96 433 moveto
(associated with your remote userid) 2.311 WS
5.062 MX
(\050for example, the following command searches for) 2.312 WS
96 446 moveto
(processes for username ) show
10 /Courier-Bold SelectFont
(fred) show
11 /Palatino-Roman SelectFont
(\051:) show
96 470 moveto
10 /Courier-Bold SelectFont
(ps -ef | grep fred) show
96 494 moveto
11 /Palatino-Roman SelectFont
(The output lists the processes -- for example:) show
96 518 moveto
10 /Courier-Bold SelectFont
(fred 13553 20720 8 16:52:04 - 0:00) show
96 530 moveto
( /usr/lpp/ada/bin/Adaentry +varc==) show
96 542 moveto
(fred 14314 6643 0 16:51:33 - 0:00 in.dtia) show
96 554 moveto
(fred 19437 17643 0 16:51:48 - 0:00) show
96 566 moveto
( /user/bin/ada/ada source_descript) show
96 578 moveto
(fred 20720 19437 9 16:52:04 -0:00 -ksh) show
96 602 moveto
11 /Palatino-Roman SelectFont
(Note that if the problem was caused by an incorrect shell, the last line of output) 0.348 WS
3.097 MX
(would list) 0.347 WS
96 614 moveto
10 /Courier-Bold SelectFont
(-csh) show
11 /Palatino-Roman SelectFont
( or ) show
10 /Courier-Bold SelectFont
(-bsh) show
11 /Palatino-Roman SelectFont
( instead of ) show
10 /Courier-Bold SelectFont
(-ksh) show
11 /Palatino-Roman SelectFont
(.) show
72 632 moveto
(3.) show
15.750 MX
(Kill these processes using kill -9. If the problem is due to) 1.197 WS
3.948 MX
(a hung compilation command,) 1.198 WS
96 645 moveto
(you do not need to kill) 0.133 WS
2.882 MX
(the ) 0.132 WS
10 /Courier-Bold SelectFont
(in.dtia) show
11 /Palatino-Roman SelectFont
( process, because it can be reused. If the problem is due) 0.132 WS
96 658 moveto
(to using the wrong shell, you must kill all the processes, including the ) show
10 /Courier-Bold SelectFont
(in.dtia) show
11 /Palatino-Roman SelectFont
( process.) show
72 682 moveto
11 /Palatino-Italic SelectFont
(Note: Using kill -9 to kill the Ada compiler locks the Ada library that was being compiled. Consequently) 0.516 WS
72 695 moveto
(you will need to unlock that library the next time you attempt to compile it. To do) 0.496 WS
3.245 MX
(this, call the compiler) 0.495 WS
72 708 moveto
(with the ) show
10 /Courier-BoldOblique SelectFont
(-u) show
11 /Palatino-Italic SelectFont
( option.) show
72 756 moveto
10 /Palatino-Roman SelectFont
(8) show
299.161 MX
(December 1992 ) show
17 /AvantGarde-Book SelectFont
( RATIONAL) show
EndPage
%%Page: 9 11
BeginPage
792 false PositionPage
72 36 moveto
10 /Palatino-Roman SelectFont
407.300 MX
(Release 2_0_2) show
72 76 moveto
15 /Palatino-Bold SelectFont
(10. Documentation) show
72 100 moveto
11 /Palatino-Roman SelectFont
(The) show
11 /Palatino-Italic SelectFont
( Rational Compilation Integrator: IBM RISC System/6000) 0.084 WS
2.835 MX
(Extension User's Guide) 0.085 WS
11 /Palatino-Roman SelectFont
(, PN 4000-00482,) 0.085 WS
72 113 moveto
(Revision 2.0, is available.) show
72 137 moveto
(Refer to the Customizable RCI Release Notes for information on RCI documentation.) show
72 177 moveto
15 /Palatino-Bold SelectFont
(11. Training) show
72 201 moveto
11 /Palatino-Roman SelectFont
(Refer to the Customizable RCI Release Notes for training information.) show
72 756 moveto
17 /AvantGarde-Book SelectFont
(RATIONAL) show
10 /Palatino-Roman SelectFont
( December 1992) show
301.370 MX
(9) show
EndPage
%%Page: iii 12
BeginPage
792 false PositionPage
72 36 moveto
10 /Palatino-Roman SelectFont
407.300 MX
(Release 2_0_2) show
278.182 72 moveto
14 /Palatino-Roman SelectFont
(Contents) show
72 108 moveto
12 /Palatino-Roman SelectFont
(1. Overview) show
4.272 MX
9 43 LTAB 390 MX
(1) show
72 122 moveto
(2. RCI Components) show
1.296 MX
9 39 LTAB 354 MX
(1) show
72 136 moveto
(3. Upgrade Impact) show
5.868 MX
9 39 LTAB 354 MX
(1) show
72 150 moveto
(4. Prerequisites) show
6 MX
9 41 LTAB 372 MX
(1) show
72 164 moveto
(5. New Features) show
1.128 MX
9 41 LTAB 372 MX
(3) show
93.600 177 moveto
11 /Palatino-Roman SelectFont
(5.1. Batch Compilation) show
0.331 MX
9 36 LTAB 327.500 MX
(3) show
93.600 190 moveto
(5.2. New Implementation-Dependent Pragmas) show
0.962 MX
9 23 LTAB 210.500 MX
(3) show
93.600 203 moveto
(5.3. New Predefined Packages) show
0.119 MX
9 32 LTAB 291.500 MX
(3) show
72 217 moveto
12 /Palatino-Roman SelectFont
(6. Fixed Problems) show
1.464 MX
9 40 LTAB 363 MX
(4) show
93.600 230 moveto
11 /Palatino-Roman SelectFont
(6.1. Invalid Reusable Component) show
3.192 MX
9 30 LTAB 273.500 MX
(4) show
93.600 243 moveto
(6.2. Pragma Interface_Information) show
7.176 MX
9 29 LTAB 264.500 MX
(4) show
93.600 256 moveto
(6.3. Uploading Executable Files) show
3.311 MX
9 31 LTAB 282.500 MX
(5) show
93.600 269 moveto
(6.4. Remote Filename Length) show
5.542 MX
9 32 LTAB 291.500 MX
(5) show
93.600 282 moveto
(6.5. Unhandled Exception from Import Operation) show
4.607 MX
9 21 LTAB 192.500 MX
(5) show
93.600 295 moveto
(6.6. Inconsistent Imports) show
0.245 MX
9 35 LTAB 318.500 MX
(5) show
93.600 308 moveto
(6.7. Including Multiple Libraries) show
7.196 MX
9 30 LTAB 273.500 MX
(6) show
93.600 321 moveto
(6.8. Os_Task Option) show
3.365 MX
9 37 LTAB 336.500 MX
(6) show
93.600 334 moveto
(6.9. Compiler Compatibility for Pragmas) show
2.705 MX
9 26 LTAB 237.500 MX
(6) show
72 348 moveto
12 /Palatino-Roman SelectFont
(7. Limitations) show
5.148 MX
9 42 LTAB 381 MX
(6) show
93.600 361 moveto
11 /Palatino-Roman SelectFont
(7.1. Limits to Ada/6000 Release 3.0 Compiler Compatibility) show
0.558 MX
9 16 LTAB 147.500 MX
(6) show
93.600 374 moveto
(7.2. Batch Compilation and Compiler Options) show
5.197 MX
9 23 LTAB 210.500 MX
(7) show
93.600 387 moveto
(7.3. Recovery from Batch Compilation Failures) show
0.973 MX
9 23 LTAB 210.500 MX
(7) show
93.600 400 moveto
(7.4. Semantic Checking) show
7.131 MX
9 35 LTAB 318.500 MX
(7) show
72 414 moveto
12 /Palatino-Roman SelectFont
(8. Known Problems) show
0.660 MX
9 39 LTAB 354 MX
(7) show
93.600 427 moveto
11 /Palatino-Roman SelectFont
(8.1. Remote Access Control) show
5.441 MX
9 33 LTAB 300.500 MX
(7) show
72 441 moveto
12 /Palatino-Roman SelectFont
(9. Troubleshooting) show
5.004 MX
9 39 LTAB 354 MX
(8) show
72 455 moveto
(10. Documentation) show
4.416 MX
9 39 LTAB 354 MX
(9) show
72 469 moveto
(11. Training) show
5.280 MX
9 43 LTAB 390 MX
(9) show
72 756 moveto
17 /AvantGarde-Book SelectFont
(RATIONAL) show
10 /Palatino-Roman SelectFont
( December 1992) show
297.640 MX
(iii) show
EndPage
%%Page: iv 13
BeginPage
792 false PositionPage
72 36 moveto
10 /Palatino-Roman SelectFont
(Rs6000 RCI Release Information) show
72 756 moveto
(iv) show
295.601 MX
(December 1992 ) show
17 /AvantGarde-Book SelectFont
( RATIONAL) show
EndPage
%%Trailer
%%Pages: 13 1
%%DocumentFonts: Times-Roman Courier-Bold Courier-BoldOblique AvantGarde-Book Palatino-Roman Palatino-Bold Palatino-Italic Palatino-BoldItalic