DataMuseum.dk

Presents historical artifacts from the history of:

Rational R1000/400

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

Excavated with: AutoArchaeologist - Free & Open Source Software.


top - download

⟦2503e1982⟧ TextFile

    Length: 42726 (0xa6e6)
    Types: TextFile
    Notes: R1k Text-file segment

Derivation

└─⟦8527c1e9b⟧ Bits:30000544 8mm tape, Rational 1000, Arrival backup of disks in PAM's R1000
    └─ ⟦cfc2e13cd⟧ »Space Info Vol 2« 
        └─⟦b1576e6b3⟧ 
            └─⟦this⟧ 

TextFile




        




















                         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\f

%!PS-Adobe-2.0
%%Title: !DOCUMENTATION.RELEASE_NOTES.REMOTE_COMPILATION_FACILITIES.PROD_WORKING.UNITS.RCF_RS6000_AIX_IBM1_1_0'V(25)
%%Creator: COMPOSE 10.7.12
%%CreationDate: January 23, 1992 at 5:24:57 PM
%%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
176.480 328 moveto
(Remote Compilation Facility:) show
155.610 350 moveto
(IBM RISC System/6000 Extension) show
217.090 372 moveto
(Release Information) show
242.800 416 moveto
( Release 1_1_0) 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-007) show
72 216 moveto
(February 1992 \050Software Release 1_1_0\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 1_1_0) show
72 76 moveto
15 /Palatino-Bold SelectFont
(1.  Overview) show
72 100 moveto
11 /Palatino-Roman SelectFont
(This release note describes the maintenance release, Release 1_1_0, of the Remote) 0.862 WS
3.613 MX
(Compilation) show
72 113 moveto
(Facility: IBM RISC System/6000 Extension \050Rs6000 RCF\051. This Rs6000 RCF release) 0.183 WS
2.932 MX
(is compatible) 0.182 WS
72 126 moveto
(with both) 3.437 WS
6.188 MX
(Release 1_0_3 and Release 1_1_1 of the Rational Remote Compilation Facility,) 3.438 WS
72 139 moveto
(referred to as the Customizable RCF.) show
72 163 moveto
(In particular, this release implements authorization checking, changes to semantics) 4.361 WS
7.110 MX
(and) show
72 176 moveto
(operational characteristics templates, and modifications to Rcf_Cmvc.Release extensions.) show
72 200 moveto
(Existing customers need to authorize the product with authorization codes) 0.904 WS
3.655 MX
(provided with this) 0.905 WS
72 213 moveto
(release.) show
72 237 moveto
(This note covers Rs6000_Aix_Ibm-specific release issues.) 0.097 WS
2.846 MX
(Refer to the Customizable RCF Release) 0.096 WS
72 250 moveto
(Note for general product information.) show
72 290 moveto
15 /Palatino-Bold SelectFont
(2.  RCF Components) show
72 314 moveto
11 /Palatino-Roman SelectFont
(The following Rs6000 RCF components are installed as part of the release:) show
72 350 moveto
10 /Courier-Bold SelectFont
(!Targets.Implementation.Release_Rs6000_Aix_Ibm1_1_0) show
72 362 moveto
(                                     -- Rs6000 RCF release world) show
72 386 moveto
(!Targets.Rs6000_Aix_Ibm              -- Rs6000 Predefined Units) show
72 410 moveto
(!Targets.Implementation.Rcf_Customization.Rs6000_Aix_Ibm) show
72 422 moveto
(    Rev1_0_Spec                      -- Customization views) show
72 434 moveto
(    Rev1_1_0                         -- Includes templates, and) show
72 446 moveto
(                                     -- extensions.) show
72 470 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 483 moveto
(delivered with this release. For user) 0.012 WS
2.761 MX
(information, refer to the) 0.011 WS
11 /Palatino-Italic SelectFont
( RCF User's Manual) 0.011 WS
11 /Palatino-Roman SelectFont
( and) 0.011 WS
11 /Palatino-Italic SelectFont
( Rs6000 RCF) 0.011 WS
72 496 moveto
(User's Guide) show
11 /Palatino-Roman SelectFont
(.) show
72 536 moveto
15 /Palatino-Bold SelectFont
(3.  Prerequisites) show
72 560 moveto
11 /Palatino-Roman SelectFont
(Before you use the Rs6000 RCF, confirm the following prerequisite conditions:) show
72 584 moveto
(\267 ) show
14.584 MX
(The remote user accounts use Korn Shell. If not, remote) 0.536 WS
3.287 MX
(command execution fails with the) 0.537 WS
96 597 moveto
(message \252variable syntax error\272.) show
72 621 moveto
(\267 ) show
14.584 MX
(IBM AIX Version 3.1 \050or later\051 is running on the remote RISC System/6000.) show
72 639 moveto
(\267 ) show
14.584 MX
(The IBM Aix Ada/6000 compiler, Version 2.0 \050or later\051, is installed on the remote) 1.671 WS
4.420 MX
(RISC) show
96 652 moveto
(System/6000 in /usr/bin/ada.) show
72 670 moveto
(\267 ) show
14.584 MX
(The host R1000 and remote RISC System/6000 are on the same network.) show
72 688 moveto
(\267 ) show
14.584 MX
(DTIA servers are installed on both the host R1000 and the remote RISC) 1.428 WS
4.179 MX
(System/6000. If) 1.429 WS
96 701 moveto
(not, you can encounter the following:) show
72 756 moveto
17 /AvantGarde-Book SelectFont
(RATIONAL) show
10 /Palatino-Roman SelectFont
(     February 1992) show
305.860 MX
(1) show
EndPage
%%Page: 2 4
BeginPage
792 false PositionPage
72 36 moveto
10 /Palatino-Roman SelectFont
(Rs6000 RCF Release Information) show
96 72 moveto
11 /Palatino-Roman SelectFont
/minus SYM 6.666 MX
( ) show
14.584 MX
(The Rs6000 RCF does not elaborate if) 0.459 WS
3.208 MX
(the host DTIA Remote_Operations server is not) 0.458 WS
120 85 moveto
(installed.) show
96 103 moveto
/minus SYM 6.666 MX
( ) show
14.584 MX
(Remote commands cannot execute if the remote DTIA server is not running.) show
96 121 moveto
(Use the following steps to confirm that both servers are running:) show
96 139 moveto
(1.) show
15.750 MX
(To detect if the host server is already running:) show
120 157 moveto
/minus SYM 6.666 MX
( ) show
14.584 MX
(Execute What.Users.) show
120 175 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 193 moveto
(2.) show
15.750 MX
(To detect if the) 2.238 WS
4.989 MX
(remote server is running, execute this command from the remote) 2.239 WS
120 206 moveto
(command shell:) show
120 230 moveto
10 /Courier-Bold SelectFont
($ ps aux) show
120 254 moveto
11 /Palatino-Roman SelectFont
(This command displays a list) 2.111 WS
4.860 MX
(of system processes. Look for an entry for the) 2.110 WS
11 /Palatino-Italic SelectFont
( inetd) 2.110 WS
120 267 moveto
11 /Palatino-Roman SelectFont
(process, similar to the following:) show
120 291 moveto
10 /Courier-Bold SelectFont
(root       5084       1989   0      17:26:01      ?  0:00 /etc/inetd) show
96 315 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 339 moveto
10 /Courier-Bold SelectFont
($ cat /etc/inetd.conf) show
120 363 moveto
11 /Palatino-Roman SelectFont
(Look for an entry at the end of the file for DTIA.) show
120 387 moveto
10 /Courier-Bold SelectFont
(dtia    stream  tcp    nowait  root     /usr/etc/in.dtia       in.dtia) show
96 411 moveto
11 /Palatino-Roman SelectFont
(Refer to the DTIA Installation and Release) 0.192 WS
2.943 MX
(Notes for information on how to restart the host) 0.193 WS
96 424 moveto
(and remote servers.) show
72 442 moveto
(\267 ) show
14.584 MX
(The RCF is running. \050After installation, the RCF) 5.248 WS
7.997 MX
(starts automatically at machine) 5.247 WS
96 455 moveto
(initialization.\051) show
96 473 moveto
(To start the RCF:) show
96 491 moveto
(1.) show
15.750 MX
(Run Start_Rcf_Main to start the Rcf compiler job.) show
96 509 moveto
(2.) show
15.750 MX
(Use Rs6000_Aix_Ibm.Register to register the your customization.) show
96 527 moveto
(3.) show
15.750 MX
(Use What.Users to list the jobs and check for the following:) show
120 545 moveto
/minus SYM 6.666 MX
( ) show
14.584 MX
(DTIA Remote_Operations Server) show
120 563 moveto
/minus SYM 6.666 MX
( ) show
14.584 MX
(Rcf_Compiler Rev1_0_3 or Rev1_1_1) show
120 581 moveto
/minus SYM 6.666 MX
( ) show
14.584 MX
(Rcf_Rev1_0_3_Rs6000_Aix_Ibm_DTIA) show
72 621 moveto
15 /Palatino-Bold SelectFont
(4.  Upgrade Impact) show
72 645 moveto
11 /Palatino-Roman SelectFont
(This release is compatibile with Rev1_0_3) 1.027 WS
3.778 MX
(and Rev1_1_1 of the Customizable RCF and should) 1.028 WS
72 658 moveto
(not require any upgrade of existing RCF views.) show
72 682 moveto
(Customers who have modified their customizations can) 0.677 WS
3.426 MX
(take advantage of new features in this) 0.676 WS
72 695 moveto
(release. To upgrade your customization, use the following steps:) show
72 756 moveto
10 /Palatino-Roman SelectFont
(2) show
303.651 MX
(February 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 1_1_0) show
72 72 moveto
11 /Palatino-Roman SelectFont
(1.) show
15.750 MX
(Build a working view from the Rev1_1_0 released view.) show
96 96 moveto
11 /Courier SelectFont
(Cmvc.Make_Path) show
96 109 moveto
(   \050From_Path =>) show
96 122 moveto
(    "!Targets.Implementation.Rcf_Customization.Rs6000_Aix_Ibm) show
96 135 moveto
(     .Rev1_1_0",) show
96 148 moveto
(    New_Path_Name => "rev1",) show
96 161 moveto
(    View_To_Modify => "",) show
96 174 moveto
(    View_To_Import => "<INHERIT_IMPORTS>",) show
96 187 moveto
(    Only_Change_Imports => True,) show
96 200 moveto
(    Create_Load_View => False,) show
96 213 moveto
(    Create_Combined_View => False,) show
96 226 moveto
(    Model => "<INHERIT_MODEL>",) show
96 239 moveto
(    Join_Paths => False,) show
96 252 moveto
(    Remake_Demoted_Units => True,) show
96 265 moveto
(    Goal => Compilation.Coded,) show
96 278 moveto
(    Comments => "",) show
96 291 moveto
(    Work_Order => "<DEFAULT>",) show
96 304 moveto
(    Volume => 0,) show
96 317 moveto
(    Response => "<PROFILE>"\051;) show
72 341 moveto
11 /Palatino-Roman SelectFont
(2.) show
15.750 MX
(Determine the differences) 16.792 WS
19.543 MX
(between the units Library_Extensions'Body,) 16.793 WS
96 354 moveto
(Rs6000_Aix_Ibm.Get_Operational_Info, and Rs6000_Aix_Ibm.Get_Transfer_Type in the) 4.289 WS
96 367 moveto
(new working view and your) 3.739 WS
6.490 MX
(modified customization. To determine differences, use) 3.740 WS
96 380 moveto
(File_Utilities.Differences in the following manner:) show
96 404 moveto
11 /Courier SelectFont
(Diff) show
96 417 moveto
(   \050File_1 =>) show
96 430 moveto
(       "!Targets.Implementation.Rcf_Customization.Rs6000_Aix_Ibm" &) show
96 443 moveto
(       ".Rev1_Working.Library_Extensions'body",) show
96 456 moveto
(    File_2 =>) show
96 469 moveto
(       "!Targets.Implementation.Rcf_Customization.Rs6000_Aix_Ibm" &) show
96 482 moveto
(       ".Rev1_1_0.Library_Extensions'body",) show
96 495 moveto
(    Result => "",) show
96 508 moveto
(    Compressed_Output => True,) show
96 521 moveto
(    Subobjects => False\051;) show
72 547 moveto
11 /Palatino-Roman SelectFont
(3.) show
15.750 MX
(Merge the additions made to your customization into the new working view and) 1.027 WS
3.776 MX
(update) show
96 560 moveto
(!Machine.Release.Current.Activity to incude the new working view.) show
72 600 moveto
15 /Palatino-Bold SelectFont
(5.  New Features) show
72 624 moveto
11 /Palatino-Roman SelectFont
(This section describes feature changes added since the Rs6000 RCF Rev1_0_2 release.) show
72 662 moveto
13 /Palatino-Bold SelectFont
(5.1.  Authorization Checking) show
72 686 moveto
11 /Palatino-Roman SelectFont
(Authorization checking is implemented for the Rs6000_Aix_Ibm extension.) show
72 756 moveto
17 /AvantGarde-Book SelectFont
(RATIONAL) show
10 /Palatino-Roman SelectFont
(     February 1992) show
305.860 MX
(3) show
EndPage
%%Page: 4 6
BeginPage
792 false PositionPage
72 36 moveto
10 /Palatino-Roman SelectFont
(Rs6000 RCF Release Information) show
72 72 moveto
11 /Palatino-Italic SelectFont
(Note: You cannot register the Rs6000_Aix_Ibm extension) 3.244 WS
5.995 MX
(on a machine where this target is not) 3.245 WS
72 85 moveto
(authorized. Existing customers need to authorize the product) 0.231 WS
2.980 MX
(with authorization codes provided with this) 0.230 WS
72 98 moveto
(release.) show
72 136 moveto
13 /Palatino-Bold SelectFont
(5.2.  Semantic Templates) show
72 160 moveto
11 /Palatino-Roman SelectFont
(The Rs6000_Aix_Ibm semantic templates, Get_Attribute_Info,) 15.260 WS
18.011 MX
(Get_Pragma_Info,) show
72 173 moveto
(Get_Predefined_Info, and Get_Rep_Spec_Info, have been modified.) 0.377 WS
3.126 MX
(They now make calls to the) 0.376 WS
72 186 moveto
(following load) 0.921 WS
3.672 MX
(procs: Get_Attributes, Get_Pragmas, Get_Predefineds and Get_Rep_Specs. This) 0.922 WS
72 199 moveto
(hides the) 0.167 WS
2.916 MX
(details of the customization's semantic component, so that it cannot be copied under a) 0.166 WS
72 212 moveto
(different target key name.) show
72 250 moveto
13 /Palatino-Bold SelectFont
(5.3.  Operational Characteristics Pre and Post Options) show
72 274 moveto
11 /Palatino-Roman SelectFont
(The Operational_Characteristics template is modified so that) 1.830 WS
4.581 MX
(all compiler and linker options) 1.831 WS
72 287 moveto
(appear after the Ada filename. For example, if) 1.313 WS
4.062 MX
(the unit Planetary_Motion is being linked, the) 1.312 WS
72 300 moveto
(link command looks something like:) show
72 324 moveto
11 /Courier SelectFont
(    /usr/bin/ada/ada -b planetary_motion -o planetary_motion -v -d) show
72 348 moveto
11 /Palatino-Roman SelectFont
(This has no impact on the behavior of these operations.) show
72 386 moveto
13 /Palatino-Bold SelectFont
(5.4.  Rcf_Cmvc.Release) show
72 410 moveto
11 /Palatino-Italic SelectFont
(Note: If you have not modified the Rs6000_Aix_Ibm extension, you can ignore this section.) show
72 434 moveto
11 /Palatino-Roman SelectFont
(While behavior of the Rcf_Cmvc.Release command has not changed, the implementation) 0.443 WS
3.194 MX
(of the) 0.444 WS
72 447 moveto
(Rs6000_Aix_Ibm library extension) 5.142 WS
7.891 MX
(customizing that command has been modified. This) 5.141 WS
72 460 moveto
(modification allows you to customize the Release) 2.191 WS
4.942 MX
(process without changing the Make_Path) 2.192 WS
72 473 moveto
(process.) show
72 497 moveto
(In previous) 16.617 WS
19.366 MX
(releases of the product, Rcf_Cmvc.Release directly called) 16.616 WS
72 510 moveto
(Library_Extensions.Make_Path_Preprocess and) 7.966 WS
10.717 MX
(Library_Extensions.Make_Path_Postprocess.) show
72 523 moveto
(This assumed that you always build a new remote library from scratch when releasing a host) 1.071 WS
72 536 moveto
(view. To allow more flexibility,) 25.074 WS
27.825 MX
(Rcf_Cmvc.Release now calls) 25.075 WS
72 549 moveto
(Library_Extensions.Release_Preprocess and Library_Extensions.Release_Postprocess which) 2.581 WS
5.330 MX
(in) show
72 562 moveto
(turn call Make_Path_Preprocess) 5.141 WS
7.892 MX
(and Make_Path_Postprocess. Although the behavior of) 5.142 WS
72 575 moveto
(Rcf_Cmvc.Release is unchanged,) 1.962 WS
4.711 MX
(the customizer now has the choice of changing the remote) 1.961 WS
72 588 moveto
(behavior of this operation.) show
72 628 moveto
15 /Palatino-Bold SelectFont
(6.  Fixed Problems) show
72 652 moveto
11 /Palatino-Roman SelectFont
(This section describes problems that) 3.782 WS
6.533 MX
(have been fixed since the Rev1_0_2 release of this) 3.783 WS
72 665 moveto
(extension.) show
72 756 moveto
10 /Palatino-Roman SelectFont
(4) show
303.651 MX
(February 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 1_1_0) show
72 74 moveto
13 /Palatino-Bold SelectFont
(6.1.  Remote Library Operations and Host_Only Views) show
72 98 moveto
11 /Palatino-Roman SelectFont
(The Rs6000_Aix_Ibm extension is modified to) 3.970 WS
6.719 MX
(prevent operations on remote libraries in) 3.969 WS
72 111 moveto
(Host_Only views. In previous releases, the RCF) 3.807 WS
6.558 MX
(attempted remote library operations on) 3.808 WS
72 124 moveto
(Host_Only views, which always resulted in errors.) show
72 162 moveto
13 /Palatino-Bold SelectFont
(6.2.  Remote Library Size) show
72 186 moveto
11 /Palatino-Roman SelectFont
(Remote libraries are now initialized to a capacity of 100,000 bytes. In) 2.023 WS
4.772 MX
(previous releases, the) 2.022 WS
72 199 moveto
(default value was too small.) 0.542 WS
3.293 MX
(Once a library has been built, you cannot increase its capacity due) 0.543 WS
72 212 moveto
(to an AIX operating system restriction. The new default value solves this problem.) show
72 252 moveto
15 /Palatino-Bold SelectFont
(7.  Known Problems) show
72 276 moveto
11 /Palatino-Roman SelectFont
(Following is a list of problems specific to the Rs6000 RCF known at the time of this release.) show
72 314 moveto
13 /Palatino-Bold SelectFont
(7.1.  Remote Access Control) show
72 338 moveto
11 /Palatino-Roman SelectFont
(The remote DTIA server creates all remote files with the access permissions:) show
72 362 moveto
10 /Courier-Bold SelectFont
( rw-  r-- r--) show
72 386 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 399 moveto
(permission only to group and others. This can prevent host R1000 users with different) 0.929 WS
3.680 MX
(remote) show
72 412 moveto
(userids from operating on the same set of host views.) show
72 452 moveto
15 /Palatino-Bold SelectFont
(8.  Troubleshooting) show
72 476 moveto
11 /Palatino-Roman SelectFont
(This section describes troubleshooting techniques for situations with the Rs6000 RCF.) show
72 500 moveto
(\267 ) show
14.584 MX
(When a Comp.Make or Comp.Promote command \050or Cmvc.Make_Path) 0.155 WS
2.904 MX
(with a compilation) 0.154 WS
96 513 moveto
(goal of Coded\051 hangs, due to whatever) 1.173 WS
3.924 MX
(cause, you must terminate the operation on both) 1.174 WS
96 526 moveto
(the R1000 host and RS6000 remote machine.) show
96 550 moveto
(1.) show
15.750 MX
(Execute the Job.Kill command on the R1000 host:) show
120 574 moveto
10 /Courier-Bold SelectFont
(Job.Kill\050The_Job => [ID-expression], The_Session => ""\051;) show
96 598 moveto
11 /Palatino-Roman SelectFont
(2.) show
15.750 MX
(You may need to unlock directories and kill several processes on) 0.985 WS
3.734 MX
(the RS6000 remote) 0.984 WS
120 611 moveto
(machine. The Job.Kill) 3.167 WS
5.918 MX
(command on the host does not affect the status of target) 3.168 WS
120 624 moveto
(processes.) show
120 642 moveto
(A.) show
12.692 MX
(Use the following command to search for processes \050for userid) show
11 /Palatino-Italic SelectFont
( fred) show
11 /Palatino-Roman SelectFont
(\051:) show
144 666 moveto
10 /Courier-Bold SelectFont
(ps -ef | grep fred) show
144 690 moveto
11 /Palatino-Roman SelectFont
(The output lists the processes:) show
72 756 moveto
17 /AvantGarde-Book SelectFont
(RATIONAL) show
10 /Palatino-Roman SelectFont
(     February 1992) show
305.860 MX
(5) show
EndPage
%%Page: 6 8
BeginPage
792 false PositionPage
72 36 moveto
10 /Palatino-Roman SelectFont
(Rs6000 RCF Release Information) show
144 72 moveto
10 /Courier-Bold SelectFont
(fred 13553 20720  8 16:52:04    - 0:00) show
144 84 moveto
(   /usr/lpp/ada/bin/Adaentry +varc==) show
144 96 moveto
(fred 14314  6643  0 16:51:33    - 0:00 in.dtia) show
144 108 moveto
(fred 19437 17643  0 16:51:48    - 0:00) show
144 120 moveto
(   /usr/bin/ada/ada source_descript) show
144 132 moveto
(fred 20720 19437  9 16:52:04    - 0:00 bsh bsh bsh) show
120 156 moveto
11 /Palatino-Roman SelectFont
(B.) show
14.529 MX
(Kill all processes except in.dtia. Do not kill in.dtia,) 2.571 WS
5.320 MX
(since you can reuse that) 2.570 WS
144 169 moveto
(process.) show
120 187 moveto
(C.) show
13.451 MX
(If you use Kill) 0.510 WS
3.261 MX
(-9 to kill the processes, you may need to unlock the library which) 0.511 WS
144 200 moveto
(was being used. Call the compiler with the -u option to unlock the library.) show
72 218 moveto
(\267 ) show
14.584 MX
(If you mistakenly use Cmvc.Make_Path instead of Rcf_Cmvc.Make_Path, and) 1.003 WS
3.752 MX
(specify the) 1.002 WS
96 231 moveto
(Model parameter as Rs6000_Aix_Ibm and the Goal parameter as) 1.103 WS
3.854 MX
(Installed or Coded, you) 1.104 WS
96 244 moveto
(get the following error message because the RCF state file does not exist:) show
96 268 moveto
10 /Courier-Bold SelectFont
(*** Can't open State File named) show
96 280 moveto
(..."...State.Tool_State.Rs6000_Aix_Ibm_State_File") show
96 292 moveto
(...\050Name_Error\051.) show
96 316 moveto
11 /Palatino-Roman SelectFont
(Other error messages may follow; no units are promoted.) show
96 334 moveto
(Use Rcf.Refresh_View to recover from this situation. Make) 6.516 WS
9.265 MX
(sure you have set) 6.515 WS
96 347 moveto
(Remote_Machine and Remote_Directory switch) 17.509 WS
20.260 MX
(values before coding.) 17.510 WS
96 360 moveto
(Rcf_Cmvc.Make_Path uses the) 0.949 WS
3.698 MX
(Remote_Directory and Remote_Machine parameters to set) 0.948 WS
96 373 moveto
(the library switch values. Rcf.Refresh_View does not set the switches.) show
72 413 moveto
15 /Palatino-Bold SelectFont
(9.  Documentation) show
72 437 moveto
11 /Palatino-Roman SelectFont
(The) show
11 /Palatino-Italic SelectFont
( Rational Remote Compilation Facility: IBM RISC) 1.110 WS
3.861 MX
(System/6000 User's Guide) 1.111 WS
11 /Palatino-Roman SelectFont
(, PN 4000-00482, is) 1.111 WS
72 450 moveto
(available.) show
72 474 moveto
(Refer to the Customizable Rcf Release Notes for information on RCF documentation.) show
72 514 moveto
15 /Palatino-Bold SelectFont
(10.  Training) show
72 538 moveto
11 /Palatino-Roman SelectFont
(Refer to the Customizable Rcf Release Notes for training information.) show
72 756 moveto
10 /Palatino-Roman SelectFont
(6) show
303.651 MX
(February 1992    ) show
17 /AvantGarde-Book SelectFont
( RATIONAL) show
EndPage
%%Page: iii 9
BeginPage
792 false PositionPage
72 36 moveto
10 /Palatino-Roman SelectFont
407.300 MX
(Release 1_1_0) 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.  RCF Components) show
7.668 MX
9 38 LTAB 345 MX
(1) show
72 136 moveto
(3.  Prerequisites) show
6 MX
9 41 LTAB 372 MX
(1) show
72 150 moveto
(4.  Upgrade Impact) show
5.868 MX
9 39 LTAB 354 MX
(2) 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.  Authorization Checking) show
0.535 MX
9 33 LTAB 300.500 MX
(3) show
93.600 190 moveto
(5.2.  Semantic Templates) show
2.764 MX
9 35 LTAB 318.500 MX
(4) show
93.600 203 moveto
(5.3.  Operational Characteristics Pre and Post Options) show
5.656 MX
9 19 LTAB 174.500 MX
(4) show
93.600 216 moveto
(5.4.  Rcf_Cmvc.Release) show
2.124 MX
9 36 LTAB 327.500 MX
(4) show
72 230 moveto
12 /Palatino-Roman SelectFont
(6.  Fixed Problems) show
1.464 MX
9 40 LTAB 363 MX
(4) show
93.600 243 moveto
11 /Palatino-Roman SelectFont
(6.1.  Remote Library Operations and Host_Only Views) show
0.772 MX
9 19 LTAB 174.500 MX
(5) show
93.600 256 moveto
(6.2.  Remote Library Size) show
1.653 MX
9 35 LTAB 318.500 MX
(5) show
72 270 moveto
12 /Palatino-Roman SelectFont
(7.  Known Problems) show
0.660 MX
9 39 LTAB 354 MX
(5) show
93.600 283 moveto
11 /Palatino-Roman SelectFont
(7.1.  Remote Access Control) show
5.441 MX
9 33 LTAB 300.500 MX
(5) show
72 297 moveto
12 /Palatino-Roman SelectFont
(8.  Troubleshooting) show
5.004 MX
9 39 LTAB 354 MX
(5) show
72 311 moveto
(9.  Documentation) show
1.416 MX
9 40 LTAB 363 MX
(6) show
72 325 moveto
(10.  Training) show
5.280 MX
9 43 LTAB 390 MX
(6) show
72 756 moveto
17 /AvantGarde-Book SelectFont
(RATIONAL) show
10 /Palatino-Roman SelectFont
(     February 1992) show
302.130 MX
(iii) show
EndPage
%%Page: iv 10
BeginPage
792 false PositionPage
72 36 moveto
10 /Palatino-Roman SelectFont
(Rs6000 RCF Release Information) show
72 756 moveto
(iv) show
300.091 MX
(February 1992    ) show
17 /AvantGarde-Book SelectFont
( RATIONAL) show
EndPage
%%Trailer
%%Pages: 10 1
%%DocumentFonts: Times-Roman Courier Courier-Bold AvantGarde-Book Palatino-Roman Palatino-Bold Palatino-Italic