|
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: 11897 (0x2e79)
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«
└─⟦eebcf29fe⟧
└─⟦this⟧
Remote Compilation Facility:
IBM RISC System/6000
Release Information
Release 1_0_2
\f
Copyright 1991 by Rational
Part Number: 508-003256-005
October 1991 (Software Release 1_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 1_0_2
1. Overview
This release note describes the production release, Release
1_0_2, of the Remote Compilation Facility: IBM RISC System/6000
(Rs6000 RCF). This Rs6000 RCF release is compatible with the
production release, Release 1_0_3 of the Rational Remote
Compilation Facility, referred to as the Customizable RCF.
This note covers Rs6000_Aix_Ibm-specific release issues. Refer to
the Remote Compilation Facility 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_0_2
-- Rs6000 RCF release world
!Targets.Rs6000_Aix_Ibm -- Rs6000 Predefined Units
!Targets.Implementation.Rcf_Customization.Rs6000_Aix_Ibm
Rev1_0_Spec -- Customization views
Rev1_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 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.
* 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.
RATIONAL October 1991 1\f
Rs6000 RCF Release Information
* 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 the
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. Use Rs6000_Aix_Ibm.Register to register the your
customization.
2 October 1991 RATIONAL\f
Release 1_0_2
3. Use What.Users to list the jobs and check for the
following:
- DTIA Remote_Operations Server
- Rcf_Compiler Rev1_0_3
- Rcf_Rev1_0_3_Rs6000_Aix_Ibm_DTIA
4. New Features
This section describes feature changes included in this release.
4.1. Rebuilding Remote Libraries
Use Rcf.Rebuild_Remote_Library if you believe the remote library
is corrupted. The command takes the following actions:
* Demotes all units in the host view.
* Deletes the remote library.
* Rebuilds the remote library.
* Refreshes remote imports.
* Re-codes all host units.
For more information on this operation, refer to the RCF User's
Manual and the Rational Remote Compilation Facility: Customizer's
Guide.
4.2. Customization
The Rs6000_Aix_Ibm RCF is a complete RCF customization and
requires no modifications.
5. Fixed Problems
This section describes problems that have been fixed since the
beta release of this product.
5.1. Rcf.Link
Previously, Rcf.Link ignored the Executable_Name parameter. This
parameter now properly specifies the name of the remote
executable built by the link operation.
RATIONAL October 1991 3\f
Rs6000 RCF Release Information
5.2. Destroying Remote Libraries
Both Rcf_Cmvc.Destroy_View and Rcf.Destroy_Remote_library destroy
the remote directory, source and program library. Previously, a
problem prevented the remote directory from being destroyed. This
problem is fixed.
6. Known Problems
Following is a list of problems specific to the Rs6000 RCF known
at the time of this release.
6.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.
7. 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
4 October 1991 RATIONAL\f
Release 1_0_2
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.
* 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 mesages 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.
8. Documentation
A preliminary version of the Rational Remote Compilation
Facility: IBM RISC System/6000 User's Manual, PN 4000-00482, is
available.
Refer to the Customizable Rcf Release Notes for information on
RCF documentation.
9. Training
Refer to the Customizable Rcf Release Notes for training
information.
RATIONAL October 1991 5\f
Release 1_0_2
Contents
1. Overview 1
2. RCF Components 1
3. Prerequisites 1
4. New Features 3
4.1. Rebuilding Remote Libraries 3
4.2. Customization 3
5. Fixed Problems 3
5.1. Rcf.Link 3
5.2. Destroying Remote Libraries 4
6. Known Problems 4
6.1. Remote Access Control 4
7. Troubleshooting 4
8. Documentation 5
9. Training 5
RATIONAL October 1991 iii\f
Rs6000 RCF Release Information
iv October 1991 RATIONAL