|
DataMuseum.dkPresents historical artifacts from the history of: Rational R1000/400 Tapes |
This is an automatic "excavation" of a thematic subset of
See our Wiki for more about Rational R1000/400 Tapes Excavated with: AutoArchaeologist - Free & Open Source Software. |
top - downloadIndex: ┃ D R T ┃
Length: 17928 (0x4608)
Types: R1K_ARCHIVE_DATA, TextFile
Names: »DATA«
└─⟦bad92a95e⟧ Bits:30000535 8mm tape, Rational 1000, RPC 1_0_2
└─ ⟦bb34fe6e2⟧ »DATA«
└─⟦this⟧
Rational Remote Procedure Call Facility:
HP 9000 Series 300
Release Information
Rev1_0_2 Release
\f
Copyright 1991 by Rational
Part Number: 508-003259-003
April 1991 (Software Release Rev1_0_2)
Rational and R1000 are registered trademarks and Rational
Subsystems is a trademark of Rational.
UNIX is a registered trademark of AT&T.
Rational
3320 Scott Boulevard
Santa Clara, California 95054-3197
\f
Rev1_0_2 Release
1. Overview
The Rational Remote Procedure Call Facility: HP 9000 Series 300
(RPC) allows users to easily build programs hosted on an R1000
and an HP 9000 that communicate via remote procedure calls. For
example, the RPC facility allows an application running on one
host to access databases and software on another host.
RPC is based on the Ada procedural call model, extending calls
between hosts. In effect, it allows an application to make an
intersystem procedure call. This mechanism allows users to build
their own interfaces to remote resources.
Refer to the Rational Networking-TCP/IP Reference Manual, Volume
2, for more detail.
2. Views
The RPC product is released in three Rational Subsystems:
!Targets.Implementation.Transport
!Targets.Implementation.Rpc
!Targets.Implementation.Rpc_Example
* The Transport subsystem contains the implementation of the
transport layer in two views: Mc68020_Hpux_0_2 and
Mc68020_Hpux_Cdf_0_2. Two views are required because of HP
9000 Ada compiler dependencies; the former is compatible with
the HP 9000 Ada compiler, and the latter with the Rational
M68020/UNIX CDF.
* The Rpc subsystem contains the implementation of the RPC layer
in one view: Mc68020_Hpux_Cdf_0_2. There are no compiler
dependencies in this layer, so the same source code executes
when downloaded and compiled using the HP 9000 Ada compiler or
the Rational M68020/UNIX CDF compiler.
* The Rpc_Example subsystem contains a sample RPC application in
two views: R1000_0_2 and Mc68020_Hpux_Cdf_0_2. Both views are
provided so that users can demonstrate the RPC facility with
clients and servers running on R1000s and/or HP 9000s.
3. Limitations
* Package Transport
Only the subset of procedures necessary to support RPC is
implemented at this time. These procedures are:
RATIONAL April 1991 1\f
Rational Remote Procedure Call Facility:
HP 9000 Series 300 Release Information
Open
Close
Connect (Active Form)
Connect (Passive Form)
Disconnect
Is_Open
Is_Connected
Transmit
Receive
All Max_Wait parameters are ignored in this release and
default to Duration'Last. This has no impact on RPC but
affects users coding directly against package Transport.
All I/O calls in this package are blocking in this release.
This means that, if one task issues an I/O call, the entire
process is blocked until the I/O operation completes.
* Package Transport_Server
The Max_Servers parameter is ignored in all procedures in this
package, and the value defaults to one. That is, servers
implemented with this release of RPC are single-threaded and
only one client is serviced at a time. This is because package
Transport provides only blocking I/O.
* Package Rpc_Server
The generic procedure Serve_With_Username is not implemented
in this release.
* Package Complex_Service (included with the example)
The Value and Image functions are not implemented in this
release.
4. Known Problems
A bug causes the example server generated by the HP 9000 Ada
compiler to malfunction. This bug is manifested by the sample
client getting the exception Transport_Stream.Not_Connected when
running on the R1000. The workaround is:
1. Start the example server under the HP 9000 Ada debugger, Ada
Probe.
2. Kill the debugger using the UNIX Kill command on the
debugger's Process ID.
3. Kill the client job on the R1000, if necessary.
4. Restart the server on the HP.
2 April 1991 RATIONAL\f
Rev1_0_2 Release
5. Fixed Problems
In Rev1_0_1 of the RPC, if a server runs on a machine whose
Internet address has a high order byte greater than 127, the
client dies the first time that it requests service from that
server. Rev1_0_2 fixes this problem.
6. Compatibility
Other than the limitations described above, all specs released
with the RPC facility are compatible with the R1000 networking
product. Users can port code that has been implemented against
the R1000 networking product simply by recompiling.
7. Documentation
The RPC facility is documented in the Rational Networking-TCP/IP
Reference Manual, Volume 2.
RATIONAL April 1991 3\f
Rev1_0_2 Release
Contents
1. Overview 1
2. Views 1
3. Limitations 1
4. Known Problems 2
5. Fixed Problems 3
6. Compatibility 3
7. Documentation 3
RATIONAL April 1991 iii\f
Rational Remote Procedure Call Facility:
HP 9000 Series 300 Release Information
iv April 1991 RATIONAL\f
%!PS-Adobe-2.0
%%Title: !DOCUMENTATION.RELEASE_NOTES.R_P_C.HP_9000_WORKING.UNITS.RPC_RELEASE1_0_3'V(1)
%%Creator: COMPOSE 10.7.11
%%CreationDate: April 18, 1991 at 12:11:04 PM
%%For: ELF
%%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
126.630 328 moveto
(Rational Remote Procedure Call Facility:) show
223.210 350 moveto
(HP 9000 Series 300) show
217.090 372 moveto
(Release Information) show
228.180 416 moveto
(Rev1_0_2 Release) show
72 756 moveto
10 /Palatino-Roman SelectFont
( ) 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
( 1991 by Rational) show
72 192 moveto
(Part Number: 508-003259-003) show
72 216 moveto
(April 1991 \050Software Release Rev1_0_2\051) show
72 588 moveto
9 /Palatino-Roman SelectFont
(Rational and R1000 are registered trademarks and Rational Subsystems is a trademark of Rational.) show
72 610 moveto
(UNIX is a registered trademark of AT&T.) show
287.480 670 moveto
10 /Palatino-Roman SelectFont
(Rational) show
259.660 682 moveto
(3320 Scott Boulevard) show
229.255 694 moveto
(Santa Clara, California 95054-3197) show
72 756 moveto
( ) show
EndPage
%%Page: 1 3
BeginPage
792 false PositionPage
72 36 moveto
10 /Palatino-Roman SelectFont
390.180 MX
(Rev1_0_2 Release) show
72 76 moveto
15 /Palatino-Bold SelectFont
(1. Overview) show
72 100 moveto
11 /Palatino-Roman SelectFont
(The Rational Remote Procedure) 1.285 WS
4.034 MX
(Call Facility: HP 9000 Series 300 \050RPC\051 allows users to easily) 1.284 WS
72 113 moveto
(build programs hosted on an R1000) 0.836 WS
0 -2.750 rmoveto
8 /Palatino-Roman SelectFont
/registered SYM 5.976 MX
11 /Palatino-Roman SelectFont
0 2.750 rmoveto
( and an HP 9000 that communicate via) 0.836 WS
3.587 MX
(remote procedure) 0.837 WS
72 126 moveto
(calls. For example, the RPC facility allows an application running on) 3.314 WS
6.063 MX
(one host to access) 3.313 WS
72 139 moveto
(databases and software on another host.) show
72 163 moveto
(RPC is based on the) 2.083 WS
4.834 MX
(Ada procedural call model, extending calls between hosts. In effect, it) 2.084 WS
72 176 moveto
(allows an application to make an intersystem procedure call. This mechanism allows) 1.208 WS
3.957 MX
(users to) 1.207 WS
72 189 moveto
(build their own interfaces to remote resources.) show
72 213 moveto
(Refer to the) show
11 /Palatino-Italic SelectFont
( Rational Networking\320TCP/IP Reference Manual) show
11 /Palatino-Roman SelectFont
(, Volume 2, for more detail.) show
72 253 moveto
15 /Palatino-Bold SelectFont
(2. Views) show
72 277 moveto
11 /Palatino-Roman SelectFont
(The RPC product is released in three Rational Subsystems) show
/trademark SYM 10.769 MX
(:) show
72 301 moveto
(!Targets.Implementation.Transport) show
72 314 moveto
(!Targets.Implementation.Rpc) show
72 327 moveto
(!Targets.Implementation.Rpc_Example) show
72 351 moveto
0 -1.100 rmoveto
6 /ZapfDingbats SelectFont
(n) show
11 /Palatino-Roman SelectFont
0 1.100 rmoveto
19.434 MX
(The Transport subsystem) 0.448 WS
3.199 MX
(contains the implementation of the transport layer in two views:) 0.449 WS
96 364 moveto
(Mc68020_Hpux_0_2 and Mc68020_Hpux_Cdf_0_2. Two views are required because of) 0.689 WS
3.438 MX
(HP) show
96 377 moveto
(9000 Ada compiler dependencies; the former is compatible with the HP 9000 Ada compiler,) 0.009 WS
96 390 moveto
(and the latter with the Rational M68020/UNIX CDF.) show
72 414 moveto
0 -1.100 rmoveto
6 /ZapfDingbats SelectFont
(n) show
11 /Palatino-Roman SelectFont
0 1.100 rmoveto
19.434 MX
(The Rpc subsystem contains the implementation of the RPC) 5.313 WS
8.062 MX
(layer in one view:) 5.312 WS
96 427 moveto
(Mc68020_Hpux_Cdf_0_2. There are no compiler) 1.616 WS
4.367 MX
(dependencies in this layer, so the same) 1.617 WS
96 440 moveto
(source code executes when downloaded and compiled using the HP 9000 Ada compiler or) 0.361 WS
96 453 moveto
(the Rational M68020/UNIX CDF compiler.) show
72 477 moveto
0 -1.100 rmoveto
6 /ZapfDingbats SelectFont
(n) show
11 /Palatino-Roman SelectFont
0 1.100 rmoveto
19.434 MX
(The Rpc_Example subsystem contains a) 0.756 WS
3.507 MX
(sample RPC application in two views: R1000_0_2) 0.757 WS
96 490 moveto
(and Mc68020_Hpux_Cdf_0_2. Both views are provided so that) 0.952 WS
3.701 MX
(users can demonstrate the) 0.951 WS
96 503 moveto
(RPC facility with clients and servers running on R1000s and/or HP 9000s.) show
72 543 moveto
15 /Palatino-Bold SelectFont
(3. Limitations) show
72 567 moveto
11 /Palatino-Roman SelectFont
0 -1.100 rmoveto
6 /ZapfDingbats SelectFont
(n) show
11 /Palatino-Roman SelectFont
0 1.100 rmoveto
19.434 MX
(Package Transport) show
96 585 moveto
(Only the subset of procedures necessary to support RPC) 0.070 WS
2.821 MX
(is implemented at this time. These) 0.071 WS
96 598 moveto
(procedures are:) show
96 616 moveto
(Open) show
96 629 moveto
(Close) show
96 642 moveto
(Connect \050Active Form\051) show
96 655 moveto
(Connect \050Passive Form\051) show
96 668 moveto
(Disconnect) show
96 681 moveto
(Is_Open) show
96 694 moveto
(Is_Connected) show
96 707 moveto
(Transmit) show
96 720 moveto
(Receive) show
72 756 moveto
(RATIONAL) show
10 /Palatino-Roman SelectFont
( April 1991) show
345.018 MX
(1) show
EndPage
%%Page: 2 4
BeginPage
792 false PositionPage
72 36 moveto
10 /Palatino-Roman SelectFont
(Rational Remote Procedure Call Facility:) show
72 48 moveto
(HP 9000 Series 300 Release Information) show
96 84 moveto
11 /Palatino-Roman SelectFont
(All Max_Wait parameters are ignored in this release and default) 0.242 WS
2.991 MX
(to Duration'Last. This has) 0.241 WS
96 97 moveto
(no impact on RPC but affects users coding directly against package Transport.) show
96 115 moveto
(All I/O calls in this package) 0.331 WS
3.082 MX
(are blocking in this release. This means that, if one task issues) 0.332 WS
96 128 moveto
(an I/O call, the entire process is blocked until the I/O operation completes.) show
72 152 moveto
0 -1.100 rmoveto
6 /ZapfDingbats SelectFont
(n) show
11 /Palatino-Roman SelectFont
0 1.100 rmoveto
19.434 MX
(Package Transport_Server) show
96 170 moveto
(The Max_Servers parameter is ignored in all procedures in this package,) 1.820 WS
4.569 MX
(and the value) 1.819 WS
96 183 moveto
(defaults to one. That) 0.752 WS
3.503 MX
(is, servers implemented with this release of RPC are single-threaded) 0.753 WS
96 196 moveto
(and only one client is serviced at a time. This is because package) 0.701 WS
3.450 MX
(Transport provides only) 0.700 WS
96 209 moveto
(blocking I/O.) show
72 233 moveto
0 -1.100 rmoveto
6 /ZapfDingbats SelectFont
(n) show
11 /Palatino-Roman SelectFont
0 1.100 rmoveto
19.434 MX
(Package Rpc_Server) show
96 251 moveto
(The generic procedure Serve_With_Username is not implemented in this release.) show
72 275 moveto
0 -1.100 rmoveto
6 /ZapfDingbats SelectFont
(n) show
11 /Palatino-Roman SelectFont
0 1.100 rmoveto
19.434 MX
(Package Complex_Service \050included with the example\051) show
96 293 moveto
(The Value and Image functions are not implemented in this release.) show
72 333 moveto
15 /Palatino-Bold SelectFont
(4. Known Problems) show
72 357 moveto
11 /Palatino-Roman SelectFont
(A bug causes the example server generated by the HP 9000 Ada compiler to) 0.724 WS
3.475 MX
(malfunction. This) 0.725 WS
72 370 moveto
(bug is manifested by the sample client getting the exception Transport_Stream.Not_Connected) 0.721 WS
72 383 moveto
(when running on the R1000. The workaround is:) show
72 407 moveto
(1.) show
15.750 MX
(Start the example server under the HP 9000 Ada debugger, Ada Probe.) show
72 425 moveto
(2.) show
15.750 MX
(Kill the debugger using the UNIX) show
0 -2.750 rmoveto
8 /Palatino-Roman SelectFont
/registered SYM 5.976 MX
11 /Palatino-Roman SelectFont
0 2.750 rmoveto
( Kill command on the debugger's Process ID.) show
72 443 moveto
(3.) show
15.750 MX
(Kill the client job on the R1000, if necessary.) show
72 461 moveto
(4.) show
15.750 MX
(Restart the server on the HP.) show
72 501 moveto
15 /Palatino-Bold SelectFont
(5. Fixed Problems) show
72 525 moveto
11 /Palatino-Roman SelectFont
(In Rev1_0_1 of the RPC, if a server runs on a machine whose) 0.553 WS
3.304 MX
(Internet address has a high order) 0.554 WS
72 538 moveto
(byte greater than 127, the client dies the first time that it requests service from that server.) 2.080 WS
72 551 moveto
(Rev1_0_2 fixes this problem.) show
72 591 moveto
15 /Palatino-Bold SelectFont
(6. Compatibility) show
72 615 moveto
11 /Palatino-Roman SelectFont
(Other than the limitations described above, all specs released with the RPC facility) 3.808 WS
6.559 MX
(are) show
72 628 moveto
(compatible with) 0.135 WS
2.884 MX
(the R1000 networking product. Users can port code that has been implemented) 0.134 WS
72 641 moveto
(against the R1000 networking product simply by recompiling.) show
72 681 moveto
15 /Palatino-Bold SelectFont
(7. Documentation) show
72 705 moveto
11 /Palatino-Roman SelectFont
(The RPC facility is documented in the) show
11 /Palatino-Italic SelectFont
( Rational Networking\320TCP/IP Reference Manual) show
11 /Palatino-Roman SelectFont
(, Volume 2.) show
72 756 moveto
10 /Palatino-Roman SelectFont
(2) show
344.768 MX
(April 1991 ) show
11 /Palatino-Roman SelectFont
( RATIONAL) show
EndPage
%%Trailer
%%Pages: 4 1
%%DocumentFonts: Times-Roman Palatino-Roman Palatino-Bold Palatino-Italic ZapfDingbats
INDEX: ⟦8641011a6⟧ R1K_ARCHIVE_INDEX DATA: ⟦a9a24a109⟧ R1K_ARCHIVE_DATA, TextFile
0x0000…1b66 ⟦5d0c3047b⟧ 0x1b66…4608 ⟦9947eb11a⟧