⟦572232936⟧

TextFile

% run this through LaTeX with the appropriate wrapper

\f

\preface
The software described herein has been developed as a research tool and
represents an effort to promote the use of the International Organization
for Standardization (ISO) interpretation of Open Systems Interconnection (OSI),
particularly in the Internet and RARE research communities.

\newpage

\f

\section*	{Notice, Disclaimer, and Conditions of Use}\label{license}
The ISODE is openly available but is {\bf NOT\/} in the public domain.
You are allowed and encouraged to take this software and build commercial
products.
However, as a condition of use, you are required to ``hold harmless'' all
contributors.

\noindent
Permission to use, copy, modify, and distribute this software and its
documentation for any purpose and without fee is hereby granted, provided
that this notice and the reference to this notice
appearing in each software module be retained unaltered, 
and that the name of any contributors shall not be used in advertising
or publicity pertaining to distribution of the software without specific
written prior permission.
No contributor makes any
representations about the suitability of this software for any purpose.
It is provided ``as is'' without express or implied warranty.

\vskip 0.15in
\noindent
\begin{small}
ALL CONTRIBUTORS DISCLAIM ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
INCLUDING ALL IMPLIED WARRANTIES OF MER\-CHAN\-TI\-BIL\-ITY AND FITNESS.
IN NO EVENT SHALL ANY CONTRIBUTOR BE LIABLE FOR ANY SPECIAL,
INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOSEVER RESULTING FROM
LOSS OF USE,
DATA OR PROFITS,
WHETHER IN ACTION OF CONTRACT,
NEG\-LI\-GENCE OR OTHER TORTIOUS ACTION,
ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
\end{small}

\vskip 0.15in
\noindent
As used above,
``contributor'' includes, but is not limited to:
\begin{quote}
\begin{tabular}{l}
The MITRE Corporation\\
The Northrop Corporation\\
University College London\\
The University of Nottingham\\
The Wollongong Group, Inc.\\
Marshall T. Rose
\end{tabular}
\end{quote}
In particular,
the Northrop Corporation provided the initial sponsorship for the ISODE
and the Wollongong Group, Inc., continued supporting this effort.

\f

\newpage\section*	{Revision Information}
This document (version \versiontag/) and its companion volumes are believed
to accurately reflect release v~\isodevrsn/ of \today{}.
This release contains the following com\-po\-nent/re\-vis\-ion relationships:
\vspace{0.1in}
\[\begin{tabular}{|l|l|}
\hline
	\multicolumn{1}{|c|}{\bf Component}&
					\multicolumn{1}{c|}{\bf Revision}\\
\hline
	Compatibility Services&		\tt compat~\compatvrsn/\\
	Transport Services&		\tt tsap~\tsapvrsn/\\
	Session Services&		\tt ssap~\ssapvrsn/\\
	Presentation Services&		\tt psap2~\psapXvrsn/\\
	Encoding of Data-Structures&	\tt psap~\psapvrsn/\\
	ASN.1 compiler&			\tt pepy~\pepyvrsn/\\
	Association Control Services&	\tt acsap~\acsapvrsn/\\
	Reliable Transfer Services&	\tt rtsap~\rtsapvrsn/\\
	Remote Operation Services&	\tt rosap~\rosapvrsn/\\
	Remote Operations Stub-generator&
					\tt rosy~\rosyvrsn/\\
	\ \ and Run-Time Environment&	\\
	Structure-generator&		\tt posy~\posyvrsn/\\
\hline
\end{tabular}\]

\f

\section*	{Comments}\label{comments}
Comments concerning this release should be addressed to:
\[\begin{tabular}{ll}
Postal address:&	The Wollongong Group\\
&			Attn: Marshall T. Rose\\
&			1129 San Antonio Road\\
&			Palo Alto, CA  94303\\
&			USA\\[0.1in]
Telephone:&		+1--415--962--7100\\[0.1in]
Internet Mailbox:&	\tt Bug-ISODE@TWG.COM
\end{tabular}\]

If you'd like a copy of the release described in this document,
there are several avenues available:
\begin{itemize}
\item	NORTH AMERICA\\
For mailings in NORTH AMERICA,
send a check for 365 US Dollars to:
\[\begin{tabular}{ll}
Postal address:&University of Pennsylvania\\
&		\small Department of Computer and Information Science\\
&		Moore School\\
&		Attn: David J. Farber (ISODE Distribution)\\
&		200 South 33rd Street\\
&		Philadelphia, PA 19104-6314\\
&		USA\\[0.1in]
Telephone:&	+1--215--898--8560
\end{tabular}\]
The tape will be written in \man tar(1) format at 1600bpi, and returned with
a documentation set.
Do not send tapes or envelopes.
Documentation only is the same price.

\item	EUROPE\\
For mailings in EUROPE, send a cheque or bankers draft and a purchase order
for 200 Pounds Sterling to:  
\[\begin{tabular}{ll}
Postal address:&	Department of Computer Science\\
&			Attn: Natalie May/Dawn Bailey\\
&			University College London\\
&			Gower Street\\
&			London, WC1E 6BT\\
&			UK\\[0.1in]
For information only:&\\
\ Telephone:&		+44--1--380--7214\\
\ Fax:&			+44--1--387--1397\\
\ Telex:&		28722\\
\ Internet::&		\verb"natalie@cs.ucl.ac.uk"\\
&			\verb"dawn@cs.ucl.ac.uk"\\
\end{tabular}\]
Specify one of:
\begin{enumerate}
\item	1600bpi 1/2--inch tape, or

\item	Sun 1/4--inch cartridge tape.
\end{enumerate}
The tape will be written in \pgm{tar} format and returned with
a documentation set.
Do not send tapes or envelopes.
Documentation only is the same price.  

\item	EUROPE (tape only)\\
Tapes without hardcopy documentation can be obtained via the European \unix/
User Group (EUUG).
The ISODE~\isodevrsn/ distribution is called EUUGD14.
\[\begin{tabular}{ll}
Postal address:&	EUUG Distributions\\
&			c/o Frank Kuiper\\
&			Centrum voor Wiskunde en Informatica\\
&			Kruislann 413\\
&			1098 SJ  Amsterdam\\
&			The Netherlands\\[0.1in]
For information only:&\\
\ Telephone:&		+31--20--5924056\\
	&		(or +31--20--5929333)\\
\ Telex:&		12571 mactr nl\\
\ Telefax:&		+31--20--5924199\\
\ Internet:&		\verb"euug-tapes@cwi.nl"\\
	&		(or \verb"euug-tapes@mcvax.uucp")
\end{tabular}\]
Specify one of:
\begin{enumerate}
\item	1600bpi 1/2--inch tape: 120 Dutch Guilders

\item	800bpi 1/2--inch tape: 120 Dutch Guilders

\item	Sun 1/4--inch cartridge tape (QIC-24 format): 180 Dutch Guilders

\item	1600 1/2--ince tape (QIC-11 format): 180 Dutch Guilders
\end{enumerate}
If you require DHL this is possible and will be billed through.
Note that if you are not a member of EUUG,
then there is an additional handling fee of 300 Dutch Guilders
(please encloses a copy of your membership or contribution payment form when
ordering). 
Do not send money, cheques, tapes or envelopes,
you will be invoiced.

\item	AUSTRALIA and NEW ZEALAND\\
For mailings in AUSTRALIA and NEW ZEALAND,
send a cheque for 250 dollars Australian to:  
\[\begin{tabular}{ll}
Postal address:&	CSIRO DIT\\
&			Attn: Andrew Waugh (ISODE Distribution)\\
&			55 Barry Street\\
&			Carlton, 3053\\
&			Australia\\[0.1in]
Telephone:&		+61--3--347--8644
\end{tabular}\]
The tape will be written in \pgm{tar} format at 1600bpi, and returned with
a documentation set.
Do not send tapes or envelopes.
Documentation only is the same price.  

\item	Internet\\
If you can FTP to the Internet,
you can use anonymous FTP to the host \verb"spam.istc.sri.com"
\verb"[10.2.0.107]"
to retrieve the file \tarfile/ in BINARY mode.
This is a \tarsize/ \pgm{tar} image.
The file \compressfile/ is the \pgm{tar} image after being
run through the compress program (\compressize/).
The compressed file is also available from the host \verb"nisc.nyser.net"
\verb"[192.33.4.10]" via anonymous FTP in the \verb"pub/isode/" directory.

\item	NIFTP\\
If you run NIFTP over the public X.25 or over JANET, and are
registered in the NRS at Salford, you can use NIFTP with username
``guest'' and your own name as password, to access \verb"UK.AC.UCL.CS" to
retrieve the file \uktarfile/.
This is a \tarsize/ \pgm{tar} image.
The file \ukcompressfile/ is the \pgm{tar} image after being
run through the compress program (\compressize/).

\item	FTAM on the JANET or PSS\\
The source are available by FTAM at the University College London over X.25
using JANET (\verb"00000511160013") or PSS (\verb"23421920030013") with
TSEL~\verb"259" (ascii encoding).
Use the ``anon'' user-identity, supply any password,
and retrieve the file \uktarfile/.
This is a \tarsize/ \pgm{tar} image.
The file \ukcompressfile/ is the \pgm{tar} image after being
run through the compress program (\compressize/).

\item	FTAM on the Internet\\
The source are available by FTAM at SRI over the
Internet at host \verb"spam.istc.sri.com" \verb"[10.2.0.107]"
(TCP port~102 selects the OSI transport service)
with TSEL~\verb"259" (numeric encoding).
Use the ``anon'' user-identity, supply any password,
and retrieve the file \tarfile/.
This is a \tarsize/ \pgm{tar} image.
The file \compressfile/ is the \pgm{tar} image after being
run through the compress program (\compressize/).
\end{itemize}
For distributions via FTAM,
the file service is provided by the FTAM implementation in ISODE~\isodevrsn/.

If you wish to use the FTAM implementation in ISODE 4.0,
which was a DIS implementation of FTAM but with an IS
implementation of the rest of the stack
(i.e., association control, presentation, and so on), use TSEL 258 instead
(ascii encoding at UCL, and numeric encoding at SRI).
This older service is temporary and is provided for bootstrap purposes only.

If you wish to use the FTAM implementation in ISODE 3.0, which was a DIS
implementation both of FTAM and the rest of the stack, use TSEL 256 instead
(ascii encoding at UCL, and numeric encoding at SRI).
This older service is temporary and is provided for bootstrap purposes only.

For distributions via either FTAM or FTP, there is an additional file
available for retrieval, called \PSfile/ which is a compressed tar
image (\PSsize/) containing the entire documentation set in PostScript format.

\f

\section*	{Discussion}
The Internet discussion group {\tt ISODE@SRI-NIC.ARPA\/} is
used as a forum to discuss ISODE.
Contact the Internet mailbox {\tt ISODE-Request@SRI-NIC.ARPA\/}
to be asked to be added to this list.

\f

\newpage\section*	{Acknowledgements}
Many people have made comments about and contributions to the ISODE which have
been most helpful.
The following list is by no means complete:

The first three releases of the ISODE were developed at the Northrop
Research and Technology Center,
and the first version of this manual is referenced as NRTC Technical
Paper \#702.
The initial work was supported in part by Northrop's Independent
Research and Development program.

The Wollongong Group now continues to support work on the ISODE,
and they deserve much credit for that!

Christopher W.~Moore\index{Moore, Christopher W.}
of the Wollongong Group has provided much help with ISODE both in terms of
policy and implementational matters.
He also performed Directory interoperability testing againast a different
implementation of the OSI Directory.

Dwight E.~Cass\index{Cass, Dwight E.}
of the Northrop Research and Technology Center was one of the original
architects of {\em The ISO Development Environment}.
His work was critical for the original proof of concept and should not be
forgotten.
John L.~Romine\index{Romine, John L.}
also of the Northrop Research and Technology Center provided many
fine comments concerning the presentation of the material herein.
This resulted in a much more readable manuscript.
Stephen H.~Willson\index{Willson, Stephen H.},
also of the Northrop Research and Technology Center,
provided some help in verifying the operation of the
software on a system running the AT\&T variant of \unix/.

The \man librosap(3n) library was heavily influenced by an earlier native-TCP
version written by George Michaelson\index{Michaelson, George}
of University College London, in
the United Kingdom.
Stephen E.~Kille\index{Kille, Stephen E.},
also of University College London,
provided valuable feedback on the \man pepy(1) utility.
In addition,
both Steve and George provided us with some good comments concerning the
\man libpsap(3) library.
Steve is also the conceptual architect for the addressing scheme used in
the software,
and he modified the \man librosap(3n) library to support half-duplex mode when
providing ECMA ROS service.
George contributed the CAMTEC X.25 interface.
Simon Walton\index{Walton, Simon},
also of University College London,
has been very helpful in providing constant feedback on the ISODE during
beta-testing.

The INCA project donated the QUIPU Directory implementation to the ISODE.
Stephen E.~Kille\index{Kille, Stephen E.},
Colin J.~Robbins\index{Robbins, Colin J.},
and Alan Turland\index{Turland, Alan},
all of University College London,
are the three principals who developed the directory software
and also wrote \volfive/ describing the QUIPU directory.
In addition,
Steve Titcombe\index{Titcombe, Steve},
also of UCL
spent considerable time on the DIrectory SHell (DISH).

The UCL work has been partially supported by the commission of the
EEC\index{EEC} under its ESPRIT\index{ESPRIT} program,
as a stage in the promotion of OSI standards.
Their support has been vital to the UCL activity.
In addition,
QUIPU is also funded by the UK Joint Network Team (JNT).

Julian P.~Onions\index{Onions, Julian},
at the Department of Computer Science at Nottingham University,
is the current \man pepy(1) guru,
having brainstormed and implemented the encoding functionality along with
Stephen E.~Easterbrook\index{Easterbrook, Stephen}
of University College London.
Julian also contributed the UBC X.25 interface 
along with the TCP/X.25 TP0 bridge,
and has also contributed greatly to \man posy(1).

John Pavel\index{Pavel, John}
and Godfrey Cowin\index{Cowin, Godfrey}
of the Department of Trade and Industry/National Physical Laboratory in the
United Kingdom
both contributed significant comments during beta-testing.
In particular, John gave us a lot of feedback on \man pepy(1)
and on the early FTAM DIS implementation.
John also contributed the SunLink X.25 interface.

Keith Ruttle\index{Ruttle, Keith} of CAMTEC Electronics Limited in the United
Kingdom contributed the both the driver for the new CAMTEC X.25 interface and
the CAMTEC CONS interface (X.25 over 802 networks).

In addition,
Andrew Worsley\index{Worsley, Andrew}
of the Department of Computer Science at the University of Melbourne in
Australia
pointed out several problems with the FTAM DIS implementation.

Mark R.~Horton\index{Horton, Mark R.}
of AT\&T Bell Laboratories
also provided some help in verifying the operation of the
software on a 3B2~system running \unix/ System~V release~2.

Jem Taylor\index{Taylor, Jem}
of the Computer Science Department at the University of Glasgow
provided some comments on the documentation.

Hans-Werner Braun\index{Braun, Hans-Werner}
of the University of Michigan provided the inspiration for the initial part of
Section~\ref{name}.

A previous release of the software contained an ISO TP4/CLNP package
derived from a public-domain implementation developed by the National
Bureau of Standards\index{NBS}.
The purpose of including the NBS package (and associated support)
was to give an example of how one would interface the code to a ``generic'' TP4
implementation.
As the software has now been interfaced to various native TP4 implementations,
the NBS package is no longer present in the distribution.

John A.~Scott\index{Scott, John A.}
of the MITRE Corporation contributed the SunLink OSI interface for TP4.
He also wrote the FTAM/FTP gateway which the MITRE Corporation has generously
donated to this package. 

Philip B.~Jelfs\index{Jelfs, Philip B.}
of the Wollongong Group upgraded the FTAM/FTP gateway to the
``IS-level'' (International Standard) FTAM.

Rick Wilder\index{Wilder, Rick}
and
Don Chirieleison\index{Chirieleison, Don}
of the MITRE Corporation contributed the VT implementation which the MITRE
Corporation has generously donated to this package.

Jacob Rekhter\index{Rekhter, Jacob}
of the T.~J.~Watson Research Center, IBM Corporation
provided some suggestions as to how the system should be ported
to the IBM RT/PC running either AIX or 4.3\bsd/.
He also fixed the incompatilibites of the FTAM/FTP gateway when running on
4.3\bsd/ systems.

Peter Vanderbilt\index{Vanderbilt, Peter}
of Sun Microsystems Inc.,
provided some very useful information on modifying the SunLink OSI interface
for TP4.

John Brezak\index{Brezak, John}
of Apollo Computer, Incorporated 
ported the ISODE to the Apollo workstation.
Don Preuss\index{Preuss, Don},
also of Apollo,
contributed several enhancements and minor fixes.

Ole-Jorgen Jacobsen\index{Jacobsen, Ole-Jorgen} of Advanced Computing
Environments provided some suggestions on the presentation of the material
herein.

Nandor Horvath\index{Horvath, Nandor}
of the Computer and Automation Institute of the Hungarian Academy of Sciences
provided some useful feedback on the FTAM documentatoin.

Finally,
James Gosling,\index{Gosling, James}
author of the superb Emacs screen-editor for \unix/,
and
Leslie Lamport,\index{Lamport, Leslie}
author of the excellent \LaTeX{} document preparation system
both deserve much praise for such winning software.
Of course,
the whole crew at U.C.~Berkeley\index{U.C.~Berkeley}
also deserves tremendous praise for their wonderful work on their variant of
\unix/.

\vspace{0.25in}
{\raggedleft /mtr\par}
{\raggedright Palo Alto, California\\
\ifcase\month
    \number\month\or
    January\or February\or March\or April\or May\or June\or
    July\or August\or September\or October\or November\or December\else
\number\month\fi,
{\oldstyle\number\year}\par}
DataMuseum.dk

DKUUG/EUUG Conference tapes

⟦572232936⟧ TextFile

Derivation

TextFile
