|
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: 16824 (0x41b8)
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«
└─⟦f518b5c3e⟧
└─⟦this⟧
Remote Compilation Facility:
IBM RISC System/6000 Extension
Release Information
Release 1_1_0
\f
Copyright 1992 by Rational
Part Number: 508-003256-007
February 1992 (Software Release 1_1_0)
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 1_1_0
1. Overview
This release note describes the maintenance release, Release
1_1_0, of the Remote Compilation Facility: IBM RISC System/6000
Extension (Rs6000 RCF). This Rs6000 RCF release is compatible
with both Release 1_0_3 and Release 1_1_1 of the Rational Remote
Compilation Facility, referred to as the Customizable RCF.
In particular, this release implements authorization checking,
changes to semantics and operational characteristics templates,
and modifications to Rcf_Cmvc.Release extensions.
Existing customers need to authorize the product with
authorization codes provided with this release.
This note covers Rs6000_Aix_Ibm-specific release issues. Refer to
the Customizable RCF Release Note for general product
information.
2. RCF Components
The following Rs6000 RCF components are installed as part of the
release:
!Targets.Implementation.Release_Rs6000_Aix_Ibm1_1_0
-- Rs6000 RCF release world
!Targets.Rs6000_Aix_Ibm -- Rs6000 Predefined Units
!Targets.Implementation.Rcf_Customization.Rs6000_Aix_Ibm
Rev1_0_Spec -- Customization views
Rev1_1_0 -- 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 RCF User's Manual and Rs6000 RCF
User's Guide.
3. Prerequisites
Before you use the Rs6000 RCF, 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.
RATIONAL February 1992 1\f
Rs6000 RCF Release Information
* 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 RCF 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
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 RCF is running. (After installation, the RCF starts
automatically at machine initialization.)
To start the RCF:
1. Run Start_Rcf_Main to start the Rcf compiler job.
2 February 1992 RATIONAL\f
Release 1_1_0
2. Use Rs6000_Aix_Ibm.Register to register the your
customization.
3. Use What.Users to list the jobs and check for the
following:
- DTIA Remote_Operations Server
- Rcf_Compiler Rev1_0_3 or Rev1_1_1
- Rcf_Rev1_0_3_Rs6000_Aix_Ibm_DTIA
4. Upgrade Impact
This release is compatibile with Rev1_0_3 and Rev1_1_1 of the
Customizable RCF and should not require any upgrade of existing
RCF views.
Customers who have modified their customizations can take
advantage of new features in this release. To upgrade your
customization, use the following steps:
1. Build a working view from the Rev1_1_0 released view.
Cmvc.Make_Path
(From_Path =>
"!Targets.Implementation.Rcf_Customization.Rs6000_Aix_Ibm
.Rev1_1_0",
New_Path_Name => "rev1",
View_To_Modify => "",
View_To_Import => "<INHERIT_IMPORTS>",
Only_Change_Imports => True,
Create_Load_View => False,
Create_Combined_View => False,
Model => "<INHERIT_MODEL>",
Join_Paths => False,
Remake_Demoted_Units => True,
Goal => Compilation.Coded,
Comments => "",
Work_Order => "<DEFAULT>",
Volume => 0,
Response => "<PROFILE>");
2. Determine the differences between the units
Library_Extensions'Body, Rs6000_Aix_Ibm.Get_Operational_Info,
and Rs6000_Aix_Ibm.Get_Transfer_Type in the new working view
and your modified customization. To determine differences, use
File_Utilities.Differences in the following manner:
RATIONAL February 1992 3\f
Rs6000 RCF Release Information
Diff
(File_1 =>
"!Targets.Implementation.Rcf_Customization.Rs6000_Aix_Ibm"
& ".Rev1_Working.Library_Extensions'body",
File_2 =>
"!Targets.Implementation.Rcf_Customization.Rs6000_Aix_Ibm"
& ".Rev1_1_0.Library_Extensions'body",
Result => "",
Compressed_Output => True,
Subobjects => False);
3. Merge the additions made to your customization into the new
working view and update !Machine.Release.Current.Activity to
incude the new working view.
5. New Features
This section describes feature changes added since the Rs6000 RCF
Rev1_0_2 release.
5.1. Authorization Checking
Authorization checking is implemented for the Rs6000_Aix_Ibm
extension.
Note: You cannot register the Rs6000_Aix_Ibm extension on a
machine where this target is not authorized. Existing customers
need to authorize the product with authorization codes provided
with this release.
5.2. Semantic Templates
The Rs6000_Aix_Ibm semantic templates, Get_Attribute_Info,
Get_Pragma_Info, Get_Predefined_Info, and Get_Rep_Spec_Info, have
been modified. They now make calls to the following load procs:
Get_Attributes, Get_Pragmas, Get_Predefineds and Get_Rep_Specs.
This hides the details of the customization's semantic component,
so that it cannot be copied under a different target key name.
5.3. Operational Characteristics Pre and Post Options
The Operational_Characteristics template is modified so that all
compiler and linker options appear after the Ada filename. For
example, if the unit Planetary_Motion is being linked, the link
command looks something like:
/usr/bin/ada/ada -b planetary_motion -o planetary_motion -v -d
This has no impact on the behavior of these operations.
4 February 1992 RATIONAL\f
Release 1_1_0
5.4. Rcf_Cmvc.Release
Note: If you have not modified the Rs6000_Aix_Ibm extension, you
can ignore this section.
While behavior of the Rcf_Cmvc.Release command has not changed,
the implementation of the Rs6000_Aix_Ibm library extension
customizing that command has been modified. This modification
allows you to customize the Release process without changing the
Make_Path process.
In previous releases of the product, Rcf_Cmvc.Release directly
called Library_Extensions.Make_Path_Preprocess and
Library_Extensions.Make_Path_Postprocess. This assumed that you
always build a new remote library from scratch when releasing a
host view. To allow more flexibility, Rcf_Cmvc.Release now calls
Library_Extensions.Release_Preprocess and
Library_Extensions.Release_Postprocess which in turn call
Make_Path_Preprocess and Make_Path_Postprocess. Although the
behavior of Rcf_Cmvc.Release is unchanged, the customizer now has
the choice of changing the remote behavior of this operation.
6. Fixed Problems
This section describes problems that have been fixed since the
Rev1_0_2 release of this extension.
6.1. Remote Library Operations and Host_Only Views
The Rs6000_Aix_Ibm extension is modified to prevent operations on
remote libraries in Host_Only views. In previous releases, the
RCF attempted remote library operations on Host_Only views, which
always resulted in errors.
6.2. Remote Library Size
Remote libraries are now initialized to a capacity of 100,000
bytes. In previous releases, the default value was too small.
Once a library has been built, you cannot increase its capacity
due to an AIX operating system restriction. The new default value
solves this problem.
7. Known Problems
Following is a list of problems specific to the Rs6000 RCF known
at the time of this release.
RATIONAL February 1992 5\f
Rs6000 RCF Release Information
7.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.
8. Troubleshooting
This section describes troubleshooting techniques for situations
with the Rs6000 RCF.
* When a Comp.Make or Comp.Promote command (or Cmvc.Make_Path
with a compilation goal of Coded) hangs, due to whatever
cause, you must terminate the operation on both the R1000 host
and RS6000 remote machine.
1. Execute the Job.Kill command on the R1000 host:
Job.Kill(The_Job => [ID-expression], The_Session => "");
2. You may need to unlock directories and kill several
processes on the RS6000 remote machine. The Job.Kill
command on the host does not affect the status of target
processes.
A. Use the following command to search for processes (for
userid fred):
ps -ef | grep fred
The output lists the processes:
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
/usr/bin/ada/ada source_descript
fred 20720 19437 9 16:52:04 - 0:00 bsh bsh bsh
B. Kill all processes except in.dtia. Do not kill in.dtia,
since you can reuse that process.
C. If you use Kill -9 to kill the processes, you may need
to unlock the library which was being used. Call the
compiler with the -u option to unlock the library.
6 February 1992 RATIONAL\f
Release 1_1_0
* If you mistakenly use Cmvc.Make_Path instead of
Rcf_Cmvc.Make_Path, and specify the Model parameter as
Rs6000_Aix_Ibm and the Goal parameter as Installed or Coded,
you get the following error message because the RCF state file
does not exist:
*** Can't open State File named
..."...State.Tool_State.Rs6000_Aix_Ibm_State_File"
...(Name_Error).
Other error messages may follow; no units are promoted.
Use Rcf.Refresh_View to recover from this situation. Make sure
you have set Remote_Machine and Remote_Directory switch values
before coding. Rcf_Cmvc.Make_Path uses the Remote_Directory
and Remote_Machine parameters to set the library switch
values. Rcf.Refresh_View does not set the switches.
9. Documentation
The Rational Remote Compilation Facility: IBM RISC System/6000
User's Guide, PN 4000-00482, is available.
Refer to the Customizable Rcf Release Notes for information on
RCF documentation.
10. Training
Refer to the Customizable Rcf Release Notes for training
information.
RATIONAL February 1992 7\f
Release 1_1_0
Contents
1. Overview 1
2. RCF Components 1
3. Prerequisites 1
4. Upgrade Impact 3
5. New Features 4
5.1. Authorization Checking 4
5.2. Semantic Templates 4
5.3. Operational Characteristics Pre and Post Options 4
5.4. Rcf_Cmvc.Release 5
6. Fixed Problems 5
6.1. Remote Library Operations and Host_Only Views 5
6.2. Remote Library Size 5
7. Known Problems 5
7.1. Remote Access Control 6
8. Troubleshooting 6
9. Documentation 7
10. Training 7
RATIONAL February 1992 iii\f
Rs6000 RCF Release Information
iv February 1992 RATIONAL