DataMuseum.dk

Presents historical artifacts from the history of:

Rational R1000/400 Tapes

This is an automatic "excavation" of a thematic subset of
artifacts from Datamuseum.dk's BitArchive.

See our Wiki for more about Rational R1000/400 Tapes

Excavated with: AutoArchaeologist - Free & Open Source Software.


top - download
Index: ┃ R T

⟦ba6302c0a⟧ TextFile

    Length: 27545 (0x6b99)
    Types: TextFile
    Names: »RCI_RS6000_AIX_IBM_RELEASE2_0_2_LPT«

Derivation

└─⟦25882cbde⟧ Bits:30000536 8mm tape, Rational 1000, RCI_RS6000_AIX_IBM 2_0_2
    └─ ⟦b8efda8ac⟧ »DATA« 
        └─⟦38b79eaa9⟧ 
            └─⟦this⟧ 

TextFile




        




















                       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