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

⟦79b4f3d6b⟧ TextFile

    Length: 32044 (0x7d2c)
    Types: TextFile
    Notes: R1k Text-file segment

Derivation

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

TextFile




        




















                       Rational Compilation Integrator:
                          Alsys i386 LynxOS Extension
                              Release Information

                                 Release 2_0_2






























\f




        





       Copyright  1992 by Rational



       Part Number: 508-003289-002

       December 1992 (Software Release 2_0_2)
























       Alsys is a registered trademark of Alsys.

       Intel is a registered trademark of Intel Corporation.

       Rational   and  R1000  are  registered  trademarks  and  Rational
       Environment is a trademark of Rational.

       UNIX is a registered trademark of AT&T.




                                   Rational
                             3320 Scott Boulevard
                      Santa Clara, California  95054-3197




\f

                                                           Release 2_0_2


       1.  Overview

       This  release  note  describes  Release  2_0_2  of  the  Rational
       Compilation  Integrator: Alsys i386 LynxOS Extension (Alsys i386
       LynxOS RCI). This Alsys i386 LynxOS  RCI  release  is  compatible
       with Release 2_0 of the Rational Compilation Integrator, referred
       to as the Customizable RCI.

       This note covers Alsys UNIX Ada RCI extensions issues in general,
       and  specifically I386_Unix_Als_Xt-specific release issues. Refer
       to the Rational Compilation Integrator Release Note  for  general
       product information.


       2.  RCI Components

       The  following  Alsys i386 LynxOS RCI components are installed as
       part of the release:


       !Targets.Implementation.Release_I386_Unix_Als_Xt2_0_2
                                    -- I386_Unix_Als_Xt release world

       !Targets.I386_Unix_Als_Xt    -- I386_Unix_Als_Xt Predefined Units

       !Targets.Implementation.Rci_Customization.I386_Unix_Als_Xt
           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  RCI  Alsys
       i386 LynxOS User's Guide.


       3.  Prerequisites

       You can use this RCI extension product with the Alsys compiler on
       most  UNIX  operating  systems   (with   modifications   to   the
       customization   templates   and  extensions).  The  prerequisites
       defined in this section are for LynxOS. Other platforms may  have
       different requirements.

       Before  you  use the Alsys i386 LynxOS RCI, confirm the following
       prerequisite conditions:

       *  LynxOS Version 2.0, Release 15 (or later) is  running  on  the
          remote Intel i386 system.

       *  The  Alsys  386  UNIX Ada compilation system, Version 5.1 (or
          later), is installed on the remote i386  system  and  you  can
          access it through your search path under the LynxOS system.



       RATIONAL     December 1992                                      1\f

       Alsys i386 LynxOS RCI Release Information


       *  The  host R1000 and remote i386 system are on the same network
          and can communicate using Telnet and FTP.

       *  FTP and Telnet servers are running on the remote i386. If not,
          the RCI cannot execute remote commands from the host.

          Consult your system administrator for instructions on checking
          the 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 I386_Unix_Als_Xt.Register to register your extension.

          3. Use   What.Users  to  list  the  jobs  and  check  for  the
             following:

             -   FTP Server

             -   Rci_Compiler Rev2_0_5 (or later)

             -   Rci_Rev2_0_2_I386_Unix_Als_Xt_FTP


       4.  Limitations

       This section describes limitations in this Alsys i386 LynxOS  RCI
       release.


       4.1.  Uploading Executable Files

       The  Alsys  UNIX  Ada  RCI  provides  a switch, I386_Unix_Als_Xt-
       _Get_Executable_File, to control whether or not  the  RCI  should
       upload  the  executable  module  to  the  host  after  a  linking
       operation. Set the value of this switch to True if  you  want  to
       upload  the  executable file from the remote compilation platform
       to the host. The base RCI also provides  a  switch,  Session_Rci-
       .Retrieve_Executable,  to  control uploading the executable file.
       Leave this switch set to its default value (False).


       4.2.  Compiler and Linker Pre_Options Switches

       If  you  set  the  Rci.Compiler_Pre_Options  (or  Rci.Linker_Pre-
       _Options)  library  switch to a non-null and non-blank value, the
       RCI generates a malformed  compile  (or  link)  command  for  the
       target  compiler.  This  command fails when you execute it on the
       remote compilation platform.



       2                                      December 1992     RATIONAL\f

                                                           Release 2_0_2


       You can, however, set the desired options  in  the  Rci.Compiler-
       _Post_Options  (or  Rci.Linker_Post_Options) switch. The RCI then
       generates the correct form of the command from this value.


       4.3.  Executable Filename Length Limits

       The Alsys UNIX Ada compiler and linker place certain restrictions
       on executable filenames. These conditions include the following:

       *  If  you  specify  an  executable  name  to  Rci.Link  with  an
          extension, for example, "foo.exe", the  Alsys  linker  ignores
          the  extension.  This  is  not  a  problem during linking; the
          Rci.Link command  should  still  succeed.  However,  when  you
          execute  your  compiled  program  or  retrieve  the executable
          module from the remote compilation platform, you must  execute
          or retrieve a file named "foo", rather than "foo.exe", because
          the  Alsys  linker  did  not  create  the  filename  with  the
          extension.

          The Alsys UNIX Ada linker fails if a specified executable name
          contains more than 14 characters.

       *  If you don't  specify  an  executable  name  in  the  Rci.Link
          command  parameters  when  linking  "bar", the RCI chooses the
          unit name "bar" as the default executable name.  If  the  unit
          name  contains more than 10 characters, the default executable
          name is truncated by the Alsys linker to  10  characters,  but
          the  Alsys  i386  LynxOS  RCI will rename the generated remote
          files, so  after  an  Rci.Link  operation,  the  name  of  the
          executable  module  will be the unit name. Note, however, that
          main  unit  names  must  be  unique  within  their  first   10
          characters.

       To avoid these conditions, always specify a short executable name
       (14 characters or less) without an extension for your  executable
       name  when  you call Rci.Link. If the condition occurs when using
       pragma Main, you can either rename your main unit  to  a  shorter
       name (10 characters or less) or remove pragma Main completely.


       4.4.  Destroying Families

       The  Alsys  i386 LynxOS RCI extension never destroys families nor
       deletes family directories. If you need to remove a  family,  log
       on  to  the remote machine or use Rci.Execute_Remote_Command from
       the host to remove it manually using the ada family_manager.erase
       <family> command).


       4.5.  Maximum UNIX Command Length

       The maximum length of a LynxOS UNIX command is 254 characters. If
       your remote  directory  names  are  long  and/or  your  pathnames
       contain   many   subdirectories,  you  may  create  RCI-generated

       RATIONAL     December 1992                                      3\f

       Alsys i386 LynxOS RCI Release Information


       commands that exceed that maximum length. Since the RCI does  not
       normally  check  command  length, the remote operating system may
       return messages about this. To  avoid  this  problem,  keep  your
       remote  directory  names  short  (by using Rci_Cmvc commands) and
       minimize the number of subdirectories in your pathnames.


       5.  Known Problems

       Following is a list of problems specific to the Alsys i386 LynxOS
       RCI known at the time of this release.


       5.1.  Replacing Imported Libraries and Cmvc.Import

       If  a  remote  imported  view  is  in a different family than its
       importing view, and if you need to replace one imported view of a
       subsystem  with  another, first call Cmvc.Remove_Import to remove
       the old view, and then call Cmvc.Import to import the  new  view.
       Cmvc.Import  alone  does  not delete the original remote imported
       view.


       5.2.  Retrieving Rci.Link Failure Information

       If an Rci.Link command fails on the remote compilation  platform,
       the  message  describing  the  reason  for the failure is usually
       written into the .map file  which  the  Alsys  Binder  generates.
       However,  the RCI will not always retrieve the .map file when the
       link fails. In that case, you must retrieve it manually from  the
       remote platform, using Ftp.Get or the Rci.Upload_Unit command, to
       find out what caused the failure.


       6.  Troubleshooting

       This section describes troubleshooting techniques for  situations
       with the Alsys i386 LynxOS RCI.

       If the Alsys UNIX Ada compiler fails, your output display may not
       include enough information for you to determine what is wrong. To
       get more information, set the enclosing view's Rci.Trace_Command-
       _Output library switch to True and recompile the offending unit.


       7.  Documentation

       The Rational Compilation Integrator:  Alsys  i386  LynxOS  User's
       Guide, PN 4000-00580, is available.

       Refer  to  the  Customizable RCI Release Notes for information on
       RCI documentation.




       4                                      December 1992     RATIONAL\f

                                                           Release 2_0_2


       8.  Training

       Refer  to  the  Customizable  RCI  Release  Notes  for   training
       information.




















































       RATIONAL     December 1992                                      5\f

                                                           Release 2_0_2


                                   Contents


       1.  Overview                                                    1
       2.  RCI Components                                              1
       3.  Prerequisites                                               1
       4.  Limitations                                                 2
          4.1.  Uploading Executable Files                             2
          4.2.  Compiler and Linker Pre_Options Switches               2
          4.3.  Executable Filename Length Limits                      3
          4.4.  Destroying Families                                    3
          4.5.  Maximum UNIX Command Length                            3
       5.  Known Problems                                              4
          5.1.  Replacing Imported Libraries and Cmvc.Import           4
          5.2.  Retrieving Rci.Link Failure Information                4
       6.  Troubleshooting                                             4
       7.  Documentation                                               4
       8.  Training                                                    5






































       RATIONAL     December 1992                                    iii\f

       Alsys i386 LynxOS RCI Release Information


























































       iv                                     December 1992     RATIONAL\f

%!PS-Adobe-2.0
%%Title: !DOCUMENTATION.RELEASE_NOTES.REMOTE_COMPILATION_FACILITIES.PROD_WORKING.UNITS.RCI_I386_UNIX_ALS_XT2_0_2'V(1)
%%Creator: COMPOSE 10.7.12
%%CreationDate: December 3, 1992 at 10:17:32 AM
%%For: KP
%%Pages: (atend)
%%DocumentFonts: (atend)
%%EndComments
/SelectFont {findfont exch dup neg 0 0 3 -1 roll 0 0 MAT astore makefont setfont} bind def
/BeginPage {/State save def /INITIAL-MATRIX matrix currentmatrix def 1 -1 scale 0.5 setlinewidth} bind def
/PositionPage {{-90 rotate pop} {0 exch neg translate} ifelse} bind def
/EndPage {State restore showpage} def
/WS {0 32 4 -1 roll widthshow} bind def
/MX {0 rmoveto} bind def
/LTAB {gsave exch (.) stringwidth pop sub exch {dup 2 div dup 0 rmoveto (.) show 0 rmoveto} repeat pop grestore} bind def
/MAT matrix def
/FINDSCALE {gsave newpath 0 0 moveto (X) false charpath
flattenpath pathbbox /CAPHEIGHT exch def pop pop pop newpath 0 0 moveto
(x) false charpath flattenpath pathbbox /XHEIGHT exch def pop pop pop
grestore XHEIGHT CAPHEIGHT XHEIGHT sub 3 div add CAPHEIGHT div } bind def
/CAP-ENCODING [ StandardEncoding aload pop ] def
8#141 1 8#172 {CAP-ENCODING exch dup 1 string dup 0 4 -1 roll 8#40 sub put cvn put} for
/COPYFONT {dup length dict /TMPDICT exch def {1 index /FID ne {TMPDICT 3 1 roll put} {pop pop} ifelse } forall TMPDICT }bind def
/SYM {save exch /newfont currentfont maxlength dict def currentfont
{exch dup /FID ne {dup /Encoding eq {exch dup length array copy newfont 3 1 roll put}
{exch newfont 3 1 roll put} ifelse } {pop pop} ifelse} forall
newfont /Encoding get 8#377 3 -1 roll put /NEWFONT newfont definefont setfont
(\377) show restore} bind def
%%EndProlog
%%Page: 1 1
BeginPage
792 false PositionPage
72 72 moveto
20 /Palatino-Roman SelectFont
( ) show
161.380 328 moveto
(Rational Compilation Integrator:) show
176.530 350 moveto
(Alsys i386 LynxOS Extension) show
217.090 372 moveto
(Release Information) show
242.800 416 moveto
( Release 2_0_2) show
EndPage
%%Page: 2 2
BeginPage
792 false PositionPage
72 72 moveto
10 /Palatino-Roman SelectFont
( ) show
72 144 moveto
(Copyright ) show
/copyright SYM 7.470 MX
( 1992 by Rational) show
72 192 moveto
(Part Number: 508-003289-002) show
72 216 moveto
(December 1992 \050Software Release 2_0_2\051) show
72 516 moveto
9 /Palatino-Roman SelectFont
(Alsys is a registered trademark of Alsys.) show
72 538 moveto
(Intel is a registered trademark of Intel Corporation.) show
72 560 moveto
(Rational and R1000 are registered trademarks and Rational Environment is a trademark of Rational.) show
72 582 moveto
(UNIX is a registered trademark of AT&T.) show
287.480 641 moveto
10 /Palatino-Roman SelectFont
(Rational) show
259.660 653 moveto
(3320 Scott Boulevard) show
229.255 665 moveto
(Santa Clara, California  95054-3197) show
EndPage
%%Page: 1 3
BeginPage
792 false PositionPage
72 36 moveto
10 /Palatino-Roman SelectFont
407.300 MX
(Release 2_0_2) show
72 76 moveto
15 /Palatino-Bold SelectFont
(1.  Overview) show
72 100 moveto
11 /Palatino-Roman SelectFont
(This release note describes Release 2_0_2 of) 1.559 WS
4.308 MX
(the Rational Compilation Integrator: Alsys) 1.558 WS
0 -2.750 rmoveto
8 /Palatino-Roman SelectFont
/registered SYM 5.976 MX
11 /Palatino-Roman SelectFont
0 2.750 rmoveto
( i386) 1.558 WS
72 113 moveto
(LynxOS Extension \050Alsys i386 LynxOS) 0.636 WS
3.387 MX
(RCI\051. This Alsys i386 LynxOS RCI release is compatible) 0.637 WS
72 126 moveto
(with Release 2_0 of the Rational Compilation Integrator, referred to as the Customizable RCI.) show
72 150 moveto
(This note covers) 5.339 WS
8.088 MX
(Alsys UNIX Ada RCI extensions issues in general, and specifically) 5.338 WS
72 163 moveto
(I386_Unix_Als_Xt-specific release issues. Refer to the Rational Compilation Integrator) 1.318 WS
4.069 MX
(Release) show
72 176 moveto
(Note for general product information.) show
72 216 moveto
15 /Palatino-Bold SelectFont
(2.  RCI Components) show
72 240 moveto
11 /Palatino-Roman SelectFont
(The following Alsys i386 LynxOS RCI components are installed as part of the release:) show
72 276 moveto
10 /Courier-Bold SelectFont
(!Targets.Implementation.Release_I386_Unix_Als_Xt2_0_2) show
72 288 moveto
(                             -- I386_Unix_Als_Xt release world) show
72 312 moveto
(!Targets.I386_Unix_Als_Xt    -- I386_Unix_Als_Xt Predefined Units) show
72 336 moveto
(!Targets.Implementation.Rci_Customization.I386_Unix_Als_Xt) show
72 348 moveto
(    Rev2_0_Spec              -- Customization views) show
72 360 moveto
(    Rev2_0_2                 -- Includes templates, and) show
72 372 moveto
(                             -- extensions.) show
72 396 moveto
11 /Palatino-Roman SelectFont
(For more information on) 3.292 WS
6.041 MX
(installation of this product, refer to the installation instructions) 3.291 WS
72 409 moveto
(delivered with) 0.908 WS
3.659 MX
(this release. For user information, refer to the) 0.909 WS
11 /Palatino-Italic SelectFont
( RCI User's Manual) 0.909 WS
11 /Palatino-Roman SelectFont
( and) 0.909 WS
11 /Palatino-Italic SelectFont
( RCI Alsys) 0.909 WS
72 422 moveto
(i386 LynxOS User's Guide) show
11 /Palatino-Roman SelectFont
(.) show
72 462 moveto
15 /Palatino-Bold SelectFont
(3.  Prerequisites) show
72 486 moveto
11 /Palatino-Roman SelectFont
(You can use this) 2.429 WS
5.178 MX
(RCI extension product with the Alsys compiler on most UNIX operating) 2.428 WS
72 499 moveto
(systems \050with modifications to the customization templates) 1.011 WS
3.762 MX
(and extensions\051. The prerequisites) 1.012 WS
72 512 moveto
(defined in this section are for LynxOS. Other platforms may have different requirements.) show
72 536 moveto
(Before you use the Alsys i386 LynxOS RCI, confirm the following prerequisite conditions:) show
72 560 moveto
(\267 ) show
14.584 MX
(LynxOS Version 2.0, Release 15 \050or later\051 is running on the remote Intel) show
0 -2.750 rmoveto
8 /Palatino-Roman SelectFont
/registered SYM 5.976 MX
11 /Palatino-Roman SelectFont
0 2.750 rmoveto
( i386 system.) show
72 578 moveto
(\267 ) show
14.584 MX
(The Alsys 386 UNIX) 1.545 WS
0 -2.750 rmoveto
8 /Palatino-Roman SelectFont
/registered SYM 5.976 MX
11 /Palatino-Roman SelectFont
0 2.750 rmoveto
( Ada compilation system, Version 5.1 \050or later\051, is installed on the) 1.545 WS
96 591 moveto
(remote i386 system and you can access it through your) 1.933 WS
4.684 MX
(search path under the LynxOS) 1.934 WS
96 604 moveto
(system.) show
72 622 moveto
(\267 ) show
14.584 MX
(The host R1000 and remote i386 system are on the) 1.467 WS
4.216 MX
(same network and can communicate) 1.466 WS
96 635 moveto
(using Telnet and FTP.) show
72 653 moveto
(\267 ) show
14.584 MX
(FTP and Telnet servers are running on the remote i386. If not, the) 2.058 WS
4.809 MX
(RCI cannot execute) 2.059 WS
96 666 moveto
(remote commands from the host.) show
96 684 moveto
(Consult your system administrator for instructions on checking the servers.) show
72 756 moveto
17 /AvantGarde-Book SelectFont
(RATIONAL) show
10 /Palatino-Roman SelectFont
(     December 1992) show
301.370 MX
(1) show
EndPage
%%Page: 2 4
BeginPage
792 false PositionPage
72 36 moveto
10 /Palatino-Roman SelectFont
(Alsys i386 LynxOS RCI Release Information) show
72 72 moveto
11 /Palatino-Roman SelectFont
(\267 ) show
14.584 MX
(The RCI is running. \050After installation, the RCI) 5.686 WS
8.435 MX
(starts automatically at machine) 5.685 WS
96 85 moveto
(initialization.\051) show
96 103 moveto
(To start the RCI:) show
96 121 moveto
(1.) show
15.750 MX
(Run Start_Rci_Main to start the Rci compiler job.) show
96 139 moveto
(2.) show
15.750 MX
(Use I386_Unix_Als_Xt.Register to register your extension.) show
96 157 moveto
(3.) show
15.750 MX
(Use What.Users to list the jobs and check for the following:) show
120 175 moveto
/minus SYM 6.666 MX
( ) show
14.584 MX
(FTP Server) show
120 193 moveto
/minus SYM 6.666 MX
( ) show
14.584 MX
(Rci_Compiler Rev2_0_5 \050or later\051) show
120 211 moveto
/minus SYM 6.666 MX
( ) show
14.584 MX
(Rci_Rev2_0_2_I386_Unix_Als_Xt_FTP) show
72 251 moveto
15 /Palatino-Bold SelectFont
(4.  Limitations) show
72 275 moveto
11 /Palatino-Roman SelectFont
(This section describes limitations in this Alsys i386 LynxOS RCI release.) show
72 313 moveto
13 /Palatino-Bold SelectFont
(4.1.  Uploading Executable Files) show
72 337 moveto
11 /Palatino-Roman SelectFont
(The Alsys UNIX Ada RCI provides) 0.429 WS
3.180 MX
(a switch, I386_Unix_Als_Xt_Get_Executable_File, to control) 0.430 WS
72 350 moveto
(whether or not the RCI should upload the executable module) 3.025 WS
5.774 MX
(to the host after a linking) 3.024 WS
72 363 moveto
(operation. Set the value of this switch to True if you want to) 0.256 WS
3.007 MX
(upload the executable file from the) 0.257 WS
72 376 moveto
(remote compilation platform to the host. The base RCI also provides a) 3.683 WS
6.432 MX
(switch, Session-) 3.682 WS
72 389 moveto
(_Rci.Retrieve_Executable, to control uploading the executable file. Leave this switch) 1.443 WS
4.194 MX
(set to its) 1.444 WS
72 402 moveto
(default value \050False\051.) show
72 440 moveto
13 /Palatino-Bold SelectFont
(4.2.  Compiler and Linker Pre_Options Switches) show
72 464 moveto
11 /Palatino-Roman SelectFont
(If you set the Rci.Compiler_Pre_Options \050or) 4.082 WS
6.831 MX
(Rci.Linker_Pre_Options\051 library switch to a) 4.081 WS
72 477 moveto
(non-null and non-blank value,) 1.059 WS
3.810 MX
(the RCI generates a malformed compile \050or link\051 command for) 1.060 WS
72 490 moveto
(the target compiler. This command fails when you) 3.300 WS
6.049 MX
(execute it on the remote compilation) 3.299 WS
72 503 moveto
(platform.) show
72 527 moveto
(You can, however, set the desired options) 5.277 WS
8.028 MX
(in the Rci.Compiler_Post_Options \050or Rci-) 5.278 WS
72 540 moveto
(.Linker_Post_Options\051 switch. The) 1.302 WS
4.051 MX
(RCI then generates the correct form of the command from) 1.301 WS
72 553 moveto
(this value.) show
72 591 moveto
13 /Palatino-Bold SelectFont
(4.3.  Executable Filename Length Limits) show
72 615 moveto
11 /Palatino-Roman SelectFont
(The Alsys UNIX Ada compiler and linker place certain restrictions) 1.938 WS
4.689 MX
(on executable filenames.) 1.939 WS
72 628 moveto
(These conditions include the following:) show
72 652 moveto
(\267 ) show
14.584 MX
(If you specify an executable name to Rci.Link with an extension, for example, "foo.exe",) 0.164 WS
2.913 MX
(the) show
96 665 moveto
(Alsys linker ignores the extension.) 2.595 WS
5.346 MX
(This is not a problem during linking; the Rci.Link) 2.596 WS
96 678 moveto
(command should still succeed. However, when you execute) 1.800 WS
4.549 MX
(your compiled program or) 1.799 WS
96 691 moveto
(retrieve the executable module from the remote compilation platform, you must execute) 0.182 WS
2.933 MX
(or) show
96 704 moveto
(retrieve a file named "foo",) 0.087 WS
2.836 MX
(rather than "foo.exe", because the Alsys linker did not create the) 0.086 WS
96 717 moveto
(filename with the extension.) show
72 756 moveto
10 /Palatino-Roman SelectFont
(2) show
299.161 MX
(December 1992    ) show
17 /AvantGarde-Book SelectFont
( RATIONAL) show
EndPage
%%Page: 3 5
BeginPage
792 false PositionPage
72 36 moveto
10 /Palatino-Roman SelectFont
407.300 MX
(Release 2_0_2) show
96 72 moveto
11 /Palatino-Roman SelectFont
(The Alsys) 2.044 WS
4.795 MX
(UNIX Ada linker fails if a specified executable name contains more than 14) 2.045 WS
96 85 moveto
(characters.) show
72 103 moveto
(\267 ) show
14.584 MX
(If you don't) 0.053 WS
2.802 MX
(specify an executable name in the Rci.Link command parameters when linking) 0.052 WS
96 116 moveto
("bar", the RCI chooses the unit name "bar" as the default executable name. If the) 0.298 WS
3.049 MX
(unit name) 0.299 WS
96 129 moveto
(contains more than 10 characters, the default executable name is truncated by) 1.517 WS
4.266 MX
(the Alsys) 1.516 WS
96 142 moveto
(linker to 10 characters, but the Alsys i386 LynxOS RCI will rename) 1.028 WS
3.779 MX
(the generated remote) 1.029 WS
96 155 moveto
(files, so after an Rci.Link operation, the name of the executable module will be the unit) 1.572 WS
96 168 moveto
(name. Note, however, that main unit names must be unique within their first 10 characters.) show
72 192 moveto
(To avoid these conditions, always specify) 3.051 WS
5.802 MX
(a short executable name \05014 characters or less\051) 3.052 WS
72 205 moveto
(without an extension for your executable name when you call Rci.Link. If the) 0.754 WS
3.503 MX
(condition occurs) 0.753 WS
72 218 moveto
(when using pragma) 3.155 WS
5.906 MX
(Main, you can either rename your main unit to a shorter name \05010) 3.156 WS
72 231 moveto
(characters or less\051 or remove pragma Main completely.) show
72 269 moveto
13 /Palatino-Bold SelectFont
(4.4.  Destroying Families) show
72 293 moveto
11 /Palatino-Roman SelectFont
(The Alsys i386) 0.866 WS
3.615 MX
(LynxOS RCI extension never destroys families nor deletes family directories. If) 0.865 WS
72 306 moveto
(you need to remove a family, log on to the) 6.149 WS
8.900 MX
(remote machine or use Rci.Execute-) 6.150 WS
72 319 moveto
(_Remote_Command from the host to remove) 6.644 WS
9.393 MX
(it manually using the ) 6.643 WS
10 /Courier-Bold SelectFont
(ada family-) 6.643 WS
72 331 moveto
(_manager.erase) show
10 /Courier-BoldOblique SelectFont
( <family>) show
11 /Palatino-Roman SelectFont
(  command\051.) show
72 369 moveto
13 /Palatino-Bold SelectFont
(4.5.  Maximum UNIX Command Length) show
72 393 moveto
11 /Palatino-Roman SelectFont
(The maximum length of) 0.867 WS
3.618 MX
(a LynxOS UNIX command is 254 characters. If your remote directory) 0.868 WS
72 406 moveto
(names are long and/or your pathnames) 4.792 WS
7.541 MX
(contain many subdirectories, you may create) 4.791 WS
72 419 moveto
(RCI-generated commands that exceed that) 1.042 WS
3.793 MX
(maximum length. Since the RCI does not normally) 1.043 WS
72 432 moveto
(check command length, the remote operating system may return messages about this. To avoid) 0.382 WS
72 445 moveto
(this problem, keep your remote directory names short \050by using Rci_Cmvc commands\051) 1.940 WS
4.691 MX
(and) show
72 458 moveto
(minimize the number of subdirectories in your pathnames.) show
72 498 moveto
15 /Palatino-Bold SelectFont
(5.  Known Problems) show
72 522 moveto
11 /Palatino-Roman SelectFont
(Following is a list of problems specific to the Alsys i386 LynxOS RCI known at the) 0.636 WS
3.385 MX
(time of this) 0.635 WS
72 535 moveto
(release.) show
72 573 moveto
13 /Palatino-Bold SelectFont
(5.1.  Replacing Imported Libraries and Cmvc.Import) show
72 597 moveto
11 /Palatino-Roman SelectFont
(If a remote) 1.056 WS
3.807 MX
(imported view is in a different family than its importing view, and if you need to) 1.057 WS
72 610 moveto
(replace one imported view of a subsystem with another, first call Cmvc.Remove_Import) 2.272 WS
5.021 MX
(to) show
72 623 moveto
(remove the old) 1.072 WS
3.823 MX
(view, and then call Cmvc.Import to import the new view. Cmvc.Import alone) 1.073 WS
72 636 moveto
(does not delete the original remote imported view.) show
72 674 moveto
13 /Palatino-Bold SelectFont
(5.2.  Retrieving Rci.Link Failure Information) show
72 698 moveto
11 /Palatino-Roman SelectFont
(If an Rci.Link command fails on the remote compilation platform, the message describing) 1.158 WS
3.907 MX
(the) show
72 711 moveto
(reason for the failure is usually written into the .map file which the Alsys Binder generates.) show
72 756 moveto
17 /AvantGarde-Book SelectFont
(RATIONAL) show
10 /Palatino-Roman SelectFont
(     December 1992) show
301.370 MX
(3) show
EndPage
%%Page: 4 6
BeginPage
792 false PositionPage
72 36 moveto
10 /Palatino-Roman SelectFont
(Alsys i386 LynxOS RCI Release Information) show
72 72 moveto
11 /Palatino-Roman SelectFont
(However, the RCI will) 1.291 WS
4.042 MX
(not always retrieve the .map file when the link fails. In that case, you) 1.292 WS
72 85 moveto
(must retrieve it manually from the remote platform,) 2.529 WS
5.278 MX
(using Ftp.Get or the Rci.Upload_Unit) 2.528 WS
72 98 moveto
(command, to find out what caused the failure.) show
72 138 moveto
15 /Palatino-Bold SelectFont
(6.  Troubleshooting) show
72 162 moveto
11 /Palatino-Roman SelectFont
(This section describes troubleshooting techniques for situations) 2.030 WS
4.781 MX
(with the Alsys i386 LynxOS) 2.031 WS
72 175 moveto
(RCI.) show
72 199 moveto
(If the Alsys UNIX Ada compiler fails, your) 0.235 WS
2.984 MX
(output display may not include enough information) 0.234 WS
72 212 moveto
(for you to determine what is wrong. To get more information, set the enclosing view's) 3.551 WS
72 225 moveto
(Rci.Trace_Command_Output library switch to True and recompile the offending unit.) show
72 265 moveto
15 /Palatino-Bold SelectFont
(7.  Documentation) show
72 289 moveto
11 /Palatino-Roman SelectFont
(The) show
11 /Palatino-Italic SelectFont
( Rational Compilation Integrator: Alsys i386 LynxOS User's Guide) show
11 /Palatino-Roman SelectFont
(, PN 4000-00580, is available.) show
72 313 moveto
(Refer to the Customizable RCI Release Notes for information on RCI documentation.) show
72 353 moveto
15 /Palatino-Bold SelectFont
(8.  Training) show
72 377 moveto
11 /Palatino-Roman SelectFont
(Refer to the Customizable RCI Release Notes for training information.) show
72 756 moveto
10 /Palatino-Roman SelectFont
(4) show
299.161 MX
(December 1992    ) show
17 /AvantGarde-Book SelectFont
( RATIONAL) show
EndPage
%%Page: iii 7
BeginPage
792 false PositionPage
72 36 moveto
10 /Palatino-Roman SelectFont
407.300 MX
(Release 2_0_2) show
278.182 72 moveto
14 /Palatino-Roman SelectFont
(Contents) show
72 108 moveto
12 /Palatino-Roman SelectFont
(1.  Overview) show
4.272 MX
9 43 LTAB 390 MX
(1) show
72 122 moveto
(2.  RCI Components) show
1.296 MX
9 39 LTAB 354 MX
(1) show
72 136 moveto
(3.  Prerequisites) show
6 MX
9 41 LTAB 372 MX
(1) show
72 150 moveto
(4.  Limitations) show
5.148 MX
9 42 LTAB 381 MX
(2) show
93.600 163 moveto
11 /Palatino-Roman SelectFont
(4.1.  Uploading Executable Files) show
3.311 MX
9 31 LTAB 282.500 MX
(2) show
93.600 176 moveto
(4.2.  Compiler and Linker Pre_Options Switches) show
5.749 MX
9 22 LTAB 201.500 MX
(2) show
93.600 189 moveto
(4.3.  Executable Filename Length Limits) show
1.075 MX
9 27 LTAB 246.500 MX
(2) show
93.600 202 moveto
(4.4.  Destroying Families) show
2.566 MX
9 35 LTAB 318.500 MX
(3) show
93.600 215 moveto
(4.5.  Maximum UNIX Command Length) show
7.215 MX
9 26 LTAB 237.500 MX
(3) show
72 229 moveto
12 /Palatino-Roman SelectFont
(5.  Known Problems) show
0.660 MX
9 39 LTAB 354 MX
(3) show
93.600 242 moveto
11 /Palatino-Roman SelectFont
(5.1.  Replacing Imported Libraries and Cmvc.Import) show
2.629 MX
9 20 LTAB 183.500 MX
(3) show
93.600 255 moveto
(5.2.  Retrieving Rci.Link Failure Information) show
6.779 MX
9 24 LTAB 219.500 MX
(3) show
72 269 moveto
12 /Palatino-Roman SelectFont
(6.  Troubleshooting) show
5.004 MX
9 39 LTAB 354 MX
(4) show
72 283 moveto
(7.  Documentation) show
1.416 MX
9 40 LTAB 363 MX
(4) show
72 297 moveto
(8.  Training) show
2.280 MX
9 44 LTAB 399 MX
(4) show
72 756 moveto
17 /AvantGarde-Book SelectFont
(RATIONAL) show
10 /Palatino-Roman SelectFont
(     December 1992) show
297.640 MX
(iii) show
EndPage
%%Page: iv 8
BeginPage
792 false PositionPage
72 36 moveto
10 /Palatino-Roman SelectFont
(Alsys i386 LynxOS RCI Release Information) show
72 756 moveto
(iv) show
295.601 MX
(December 1992    ) show
17 /AvantGarde-Book SelectFont
( RATIONAL) show
EndPage
%%Trailer
%%Pages: 8 1
%%DocumentFonts: Times-Roman Courier-Bold Courier-BoldOblique AvantGarde-Book Palatino-Roman Palatino-Bold Palatino-Italic