doc: Add RFC documents

1 files changed, 899 insertions, 0 deletions

diff --git a/doc/rfc/rfc216.txt b/doc/rfc/rfc216.txt
new file mode 100644
index 0000000..a092b9d
--- /dev/null
+++ b/doc/rfc/rfc216.txt
@@ -0,0 +1,899 @@
+
+
+
+
+
+
+Network Working Group                                           J. White
+Request for Comments: 216                     UCSB Computer Research Lab
+Categories: D.3, G.3                                      September 1971
+NIC: 7546
+
+
+                 Telnet Access To UCSB's Online System
+
+Contents
+
+   I.      Motivation .................................................1
+   II.     Limitations ................................................2
+   III.    System Documentation .......................................2
+   IV.     System Access ..............................................3
+   V.      Software Structure .........................................3
+   VI.     Virtual OLS Keyboard .......................................4
+   VII.    NETOLS Commands ...........................................10
+           A. HELP ...................................................10
+           B. PREFIX .................................................10
+           C. SHIFT and UNSHIFT ......................................10
+           D. FULLDUPLEX and HALFDUPLEX ..............................10
+           E. STATE ..................................................11
+           F. LOGOUT .................................................11
+   VIII.   OLS Display ...............................................11
+   IX.     Instructing User Telnet ...................................12
+   X.      Examples ..................................................14
+           A. Logon ..................................................14
+           B. Newton-Raphson Square Root Approximation ...............15
+           C. Remote Job Entry .......................................16
+
+   Figures
+
+   Figure 1. OLS Keyboard .............................................2
+   Figure 2. Keys With One-for-One Mappings ...........................6
+   Figure 3. Keys Represented as Strings ..............................7
+   Figure 4. Characters With One-for-One Mappings ....................12
+   Figure 5. Characters Which Map Into Strings .......................13
+
+I.  Motivation
+
+   A teletype-compatible interface to UCSB's Online System (OLS) has
+   been implemented in accordance with the Telnet protocol adopted by
+   the NWG.  This Server Telnet is responsive to connection requests
+   directed by User Telnet's to socket number 1, host address 3.
+   Although OLS is not a teletype system and although much of its power
+   as mathematical tool rests in its graphical display capabilities,
+   enough of the System survives the Telnet transformation to justify
+   such an implementation.
+
+
+
+White                                                           [Page 1]
+
+RFC 216          Telnet Access To UCSB's On-Line System   September 1971
+
+
+II.  Limitations
+
+   In this Telnet-style implementation of OLS, all curvilinear display
+   generated by the user on Levels II and III, Real and Complex, is
+   disregarded by the System and hence not returned to the user through
+   the Net.  The same is true of the display of special, user-created
+   characters.  Although special characters may be constructed and
+   stored, their display will be suppressed, both during the process of
+   construction and later when they are invoked from the Type level.
+   All other display generated by the System will be relayed to the user
+   intact, in some cases with stylistic transformation having first been
+   applied.  For example, Greek characters are displayed as lower-case
+   a-z.  All such transformations are described in detail in this
+   document.  Finally, those elements of the System (the operators which
+   edit user programs are prime examples) which assume a fixed-screen
+   display device function abnormally in a Telnet environment.  For such
+   a device, the System can "remember" the position on the screen of a
+   previously displayed segment of text and return to that position to,
+   for example, underscore it.  But when the "screen" marches forward --
+   relentlessly -- through a continuous medium, as it does with Telnet's
+   virtual teletype, that kind of strategy fails.  Hence, the
+   underscoring is not relocated, but rather appears on the current
+   line, beginning in the next available character frame.
+
+   OLS assumes, normally, that the user is equipped with the specially-
+   designed double keyboard depicted in Figure 1.  Conventions are
+   defined in this document, which enable a Telnet user to simulate that
+   keyboard; in particular, a means is provided for designating keys on
+   the upper, or operator keyboard.
+
+III.  System Documentation
+
+   This document has three purposes:
+
+   Figure 1. OLS Keyboard. [Please view the PDF version of this RFC.]
+
+   (1) to describe the means by which a Telnet user simulates an OLS
+       keyboard,
+
+   (2) to describe the transformations applied to output generated by
+       the System, and
+
+   (3) to enumerate those aspects of the System, which are unique to or
+       behave differently for Network (Telnet) users.
+
+   In particular, this document is not a user's manual for OLS.  Such a
+   manual is available and on file with the NIC.  In addition, a copy
+   should exist at each Network site in its NIC collection; the user
+
+
+
+White                                                           [Page 2]
+
+RFC 216          Telnet Access To UCSB's On-Line System   September 1971
+
+
+   should consult his Station Agent.  This document is titled "UCSB On-
+   Line System Manual" [NIC 5748]; its contents are current as of 1
+   January 71.  A revision to the manual is currently in preparation and
+   will be distributed when available.  In addition, tutorial manuals
+   for two of the subsystems available under OLS-MOLSF (Mathematically-
+   Oriented Language Single-Precision Floating-Point) and COL (Card
+   Oriented Language) -- will soon be made available.  The latter has
+   already been published and is being transmitted to the NIC for
+   distribution, while the former is nearing completion.
+
+   Documentation of the third subsystem of OLS--NET-- has already been
+   distributed through the NIC as two RFC's: "Network On-Line Operators"
+   [21 April 71, RFC 121, NIC 5833] and "A User Telnet--Description of
+   an Initial Implementation" [9 August 71, RFC 206, NIC 7176].  Net
+   currently houses a set of operators for system-call-level interaction
+   with UCSB's NCP, a User Telnet, and an operator (invoked by ID on
+   Level II), which returns the status of Network hosts.
+
+   Staff members at the Computer Center will be happy to field questions
+   about OLS from Network users.  In particular, an OLS consultant is
+   available for such purposes at (805) 961-4044.  Questions about OLS,
+   including those specific to use of the System through the Network,
+   may also be addressed to Jim White, UCSB's Technical Liaison, at
+   (805) 961-3454 (if necessary, messages can be left at the Computer
+   Center Office, (805) 961- 2261).
+
+IV.  System Access
+
+   The Network user is encouraged to explore the System and is invited
+   to do so with the following accounting parameters:
+
+   User Number: 196
+   Id Number: 57372
+   User Name: ARPA
+   Problem Name: (affiliation)-(name)
+                   in 16 characters or less
+                   (e.g., UCSB-White)
+
+   Such use of the System will not be billed.  Production users are
+   asked to establish their own accounts with the Computer Center ((805)
+   961-2261), the use of which will be billed in accordance with the
+   then-current rate structure.
+
+V.  Software Structure
+
+   This document is the description of a Network front-end to the Online
+   System, logically distinct from OLS itself.  This front-end is
+   hereafter referred to as NETOLS.  NETOLS is always responsive to
+
+
+
+White                                                           [Page 3]
+
+RFC 216          Telnet Access To UCSB's On-Line System   September 1971
+
+
+   connection requests direct4ed to socket 1.  When contacted by a
+   Network user, NTCLS performs the Network functions required to
+   establish a duplex connection to him.  The number of such duplex
+   connections (and hence the number of Network users) is bounded by an
+   assembly parameter whose current value is five.
+
+   Before the Network connection is established, NETOLS secures for the
+   user a port into OLS.  Sixty-four such ports exist and are shared by
+   local, dial-up, and Network users.  Should none be available, NETOLS
+   will abort the connection sequence.
+
+   Once a port has been secured and a Network connection established,
+   NETOLS will effectively push the _SYST_ key for the user by
+   transmitting to OLS the 8-bit code representing that key.  A login
+   sequence is thus initiated and the user is transmitted the lines:
+
+      UCSB ON-LINE SYSTEM
+      ENTER USER NUBMER
+
+   to which he should respond with his user number.  Beginning at this
+   point in time and continuing for the life of the Network connection,
+   NETOLS's sole function is that of interpreter--interpreting input
+   from the user and making it meaningful to the user (it is at this
+   point, for example, that curvilinear and special-character display
+   are discarded).
+
+   When the user breaks his Network connection to NETOLS, if eh hasn't
+   logged out of OLS already, NETOLS performs that function for him by
+   pushing_ SYST_ _DOWN_, just as it pushed the initial _SYST_.  The OLS
+   port acquired for the user is then released, and hence available for
+   use by other users.  It should be noted that the user can log out of
+   OLS and back on again without the Network connection's being broken,
+   since that action is transparent to NETOLS, who attaches no special
+   significance to the Key sequence, which accomplishes it.
+
+VI.  Virtual OLS Keyboard
+
+   A major function of NETOLS is to provide a mapping between elements
+   of the Telnet character set and the keys on an OLS keyboard (Figure
+   1).  The lower, or operand portion of that keyboard is fairly easily
+   represented, since it's similar to a standard typewriter keyboard.
+   Most of the keys on the lower keyboard are mapped on a one-for-one
+   basis from elements of the Telnet character set.  Upper-case
+   alphabetics are mapped into the alphabetics, lower-case, and
+   miscellany of punctuation into itself.  All such one-for-one mappings
+   are depicted in Figure 2.  A line of that figure reads as follows:
+
+      For ['half arrow' - see the PDF version of this RFC]:
+
+
+
+White                                                           [Page 4]
+
+RFC 216          Telnet Access To UCSB's On-Line System   September 1971
+
+
+      The key labeled ['half arrow'] (meaning logical not) on the lower
+      portion of an OLS keyboard is struck by causing the user's User
+      Telnet to transmit '~' (tilde).
+
+   Those lower-keyboard keys not listed in Figure 2, and _all_ the keys
+   on the upper- keyboard (hereafter referred to collectively as _non-
+   standard_ keys), are represented by the Telnet user in the following
+   manner.  For each such key, a character string has been defined; the
+   string is called the _name_ of the key.  In most cases, the name of a
+   key is identical to its label in Figure 1.  The name of the _SIN_
+   key, for example, is 'SIN (in the Online System User's Manual,
+   upper-keyboard keys are denoted by underscoring their labels, to
+   distinguish, for example, the key _SIN_ from the three keys 'SIN').
+
+      Every non-standard key on the OLS keyboard is struck by typing its
+      name (or any unique abbreviation thereof), preceded by a special
+      _prefix_ character and followed by a space.
+
+   NETOLS interprets the prefix, name, and space from them generates a
+   single, 8-bit code, which forwards to OLS.
+
+   The default prefix character is semi-colon (';'), chosen simply
+   because for touch typists it's one of the home keys.  The prefix can
+   be changed by the user to any character listed in Figure 2.  The
+   procedure for so doing is described in Section VII-B. To send the
+   prefix character through NETOLS to OLS, type it twice in succession.
+   Thus, if the default prefix is in effect, ';;' is mapped into a
+   single semi-colon and relayed to OLS.
+
+   The names of all non-standard keys are listed in Figure 3.  A line of
+   that figure reads as follows:
+
+      For _SIN_:
+
+      They key denoted _SIN_ in the OLS User's Manual (the trigonometric
+      function sine) is named 'SIN', and hence is struck by typing
+      'SIN', preceded by the prefix and followed by a space.
+
+   Assuming, then, that the default prefix ';' is in effect, SIN is
+   struck by ';SIN_' ('_' is used here and in following examples to
+   denote a space).  Furthermore, if the user chooses, he may abbreviate
+   that as ';SI_', since the key desired remains uniquely identified.
+   Further abbreviation (to ';S_') is unsatisfactory and hence
+   disallowed since the single character 'S' is insufficient to
+   distinguish between a number of keys whose names begin with that
+   character.  Key names may be typed by the user in either upper- or
+   lower-case.
+
+
+
+
+White                                                           [Page 5]
+
+RFC 216          Telnet Access To UCSB's On-Line System   September 1971
+
+
+   As each character of a non-standard key's name is typed by the user,
+   NETOLS consults it table of key names.  If the character string so
+   far specified cannot possibly lead to a valid name, the most recent
+   character is ignored ('?' echoed).  Hence, typing ';SJIN_' will be
+   accepted as _SIN_, the erroneous 'J' being ignored (and a question
+   mark echoed), and the subsequent 'JN_' accepted.  If when the
+   terminating space is typed, no single key is uniquely identified a
+   '?'  is echoed and the space ignored.  Thus, ';S_I_' will be
+   recognized as _SIN_; the first space is
+
+To Push         (OLS Explanation)        Send      (Telnet Explanation)
+
+0-9             Decimal Digits           0-9         Decimal Digits
+A-Z             Alphabetics              A-Z         UC Alphabetics
+_-5             Greek Characters         a-z         LS Alphabetics
+!               Exclamation Mark          !          Exclamation Mark
++               Plus Sign                 +          Plus Sign
+_               Underscore                _          Underscore
+-               Minus Sign                -          Minus Sign
+@               Commercial At             @          Commercial At
+/               Slash                     /          Slant
+#               Number Sign               #          Number Sign
+'               Apostrophe                '          Apostrophe
+&               Ampersand                 &          Ampersand
+$               Dollar Sign               $          Dollar Sign
+*               Asterisk                  *          Asterisk
+%               Percent                   %          Percent
+=               Equal Sign                =          Equal Sign
+TAB             Horizontal Tab           HT          Horiz. Tab. (_[)
+:               Colon                     :          Colon
+;               Semi-Colon                ;          Semi-Colon
+[               Left Bracket              [          Left Bracket
+]               Right Bracket             ]          Right Bracket
+(               Left Parenthesis          (          Left Parenthesis
+)               Right Parenthesis         )          Right Parenthesis
+<               Less Than                 <          Less Than
+>               Greater Than              >          Greater Than
+,               Comma                     ,          Comma
+"               Quotation Marks           "          Quotation Marks
+?               Question Mark             ?          Question Mark
+[half arrow]    Logical Not               ~          Tilde
+|               Logical Or                |          Vertical Line
+BACK            Backspace              BS, DEt       Backspace/Rubout
+RETURN          Carriage Return           CR         Carr. Return (_M)
+SPACE           Space                     SP         Space
+
+                Figure 2. Keys With One-for-One Mappings
+
+
+
+
+White                                                           [Page 6]
+
+RFC 216          Telnet Access To UCSB's On-Line System   September 1971
+
+
+To Push          (OLS Explanation)          The Key Name Is
+
+[circle .]           Multiply                       *          1
+[circle +]           Add                            +
+[circle -]           Subtract                       -
+RETURN               Carriage Return                .
+[circle /]           Divide                         /
+L0                   Level 0                        0
+LI                   Level I                        1
+L II                 Level II                       2
+L III                Level III                      3
+L IV                 Level IV                       4
+L V                  Level V                        5
+L VI                 Level VI                       6
+L VII                Level VII                      7
+[circle +]           Add                            ADD        2
+ARC                  Argument                       ARG
+ATAN                 Arc Tangent                    ATAN
+BACK                 Backspace                      BACK       3
+CASE                 Case                           CASE
+[cent sign]          Cent                           SignCENT
+CLR                  Clear Tab                      CLEAR
+CMPLX                Complex                        CMPLX
+CON                  Contract                       CON
+CONJ                 Conjugate                      CONJ
+CONV                 Convolve                       CONV
+COS                  Cosine                         COS
+CTX                  Context                        CTX
+DEL                  Delta                          DEL
+DIFF                 Forward Difference             DIFF
+DISPLAY              Display                        DISPLAY
+[circle /]           Divide                         DIV        4
+DWN                  Down                           DOWN
+ENL                  Enlarge                        ENL
+ENTER                Enter                          ENTER
+ERASE                Erase                          ERASE
+ESCAPE               Escape                         ESCAPE
+EVAL                 Evaluate                       EVAL
+EXP                  Exponentiate                   EXP
+                     NETOLS Command                 FULLDUPLEX 5
+                     NETOLS Command                 HALFDUPLEX
+                     NETOLS Command                 HELP
+ID                   Identity                       ID
+INV                  Invert                         INV
+[down arrow]         Line Feed Down                 LFDN
+[up arrow]           Line Feed Up                   LFUP
+
+                 Figure 3. Keys Represented As Strings
+
+
+
+White                                                           [Page 7]
+
+RFC 216          Telnet Access To UCSB's On-Line System   September 1971
+
+
+To Push           (OLS Explanation)        The Key Name Is
+
+LIST                 List                         LIST
+LOAD                 Load                         LOAD
+LOG                  Logarithm                    LOG
+                     NETOLS Command               LOGOUT
+LS                   Left Shift                   LS
+MAX                  Maximum                      MAX
+MOD                  Modulus                      MOD
+[circle .]           Multiply                     MULT         6
+NEG                  Negate                       NEG
+[half arrow]         Logical Not                  NOT          7
+|                    Logical Or                   OR           8
+PRED                 Predicate                    PRED
+                     NETOLS Command               PREFIX
+PROD                 Running Product              PROD
+PT                   Point                        PT
+PWR                  Power                        PWR
+REAL                 Real                         REAL
+REFL                 Reflect                      REFL
+REPT                 Repeat                       REPT
+RESET                Reset                        RESET
+RETURN               Carriage Return              RETURN       9
+RS                   Right Shift                  RS
+0-9                  Superscript 0-9              S0-S9
+SEL                  Select                       SELECT
+SET                  Set Tab                      SET
+                     NETOLS Command               SHIFT
+SIN                  Sine                         SIN
+SORT                 Sort                         SORT
+SQ                   Square                       SQ
+SQRT                 Square Root                  SQRT
+                     NETOLS Command               STATE
+STORE                Store                        STORE
+SUB                  Substitute                   SUB
+[circle -]           Subtract                     SUBTRACT     10
+SUM                  Running Sum                  SUM
+SYST                 System                       SYST
+TEST                 Test                         TEST
+TYPE                 Type                         TYPE
+                     NETOLS Command               UNSHIFT
+UP                   Up                           UP
+USER                 User                         USER
+
+             Figure 3 (cont'd) Keys Represented As Strings
+
+
+
+
+
+
+White                                                           [Page 8]
+
+RFC 216          Telnet Access To UCSB's On-Line System   September 1971
+
+
+   1. Alternate names for [circle .], [circle +], [circle -], RETURN,
+      and [circle /] are 'MULT', 'ADD', 'SUBTRACT', 'RETURN', and 'DIV',
+      respectively. RETURN can also be represented as the single
+      character CR (carriage return), as indicated in Figure 2.
+
+   2. An alternate name for [circle +] is '+'
+
+   3. Alternates for BACK are the single characters BS (backspace) and
+      DEL (rubout), as indicated in Figure 2.
+
+   4. An alternate name for [circle /] is 'DIV'.
+
+   5. NETOLS commands are explained in Section VII.
+
+   6. An alternate name for [circle .] is 'MULT'.
+
+   7. An alternate for '[half arrow]' is the single character '~'
+      (tilde), as indicated in Figure 2.
+
+   8. An alternate for '|' is the single character '[2 vertical lines]'
+      (vertical line), as indicated in Figure 2.
+
+   9. An alternate name for RETURN is '.' RETURN can also be represented
+      as the single character CR (carriage return), as indicated in
+      Figure 2.
+
+  10. An alternate name for [circle -] is '-'.
+
+   Notes for Figure 3.
+
+   Ignored (and a '?' echoed, indicating that 'S' alone is ambiguous).
+
+   At any point in the entry of a key name, either Altmode (ESC) or '?'
+   may be typed by the user.  NETOLS will then determine whether a key
+   has been uniquely specified by the characters already typed.  If so,
+   it will echo the remaining characters of the key's name, and consider
+   them entered by the user.  A subsequent space from the user will
+   cause the indicated key to be pushed.  If no single key is uniquely
+   specified, NETOLS will echo Bel, causing a bell to be run on many
+   terminals.  More of the key name is then expected from the user.
+
+   If after at least one character of the key name has been entered by
+   the user and accepted by NETOLS (and before the terminating space is
+   typed) the prefix is typed a second time, all already entered
+   characters of the name are discarded by NETOLS.  Thus ';CO;SIN_' is
+   interpreted as _SIN_.  If a carriage return is typed in the same
+
+
+
+
+
+White                                                           [Page 9]
+
+RFC 216          Telnet Access To UCSB's On-Line System   September 1971
+
+
+   context, the initial prefix will also be discarded.  Hence, ';CO%S'
+   ('%' denotes carriage return) is interpreted as the lower-keyboard
+   key 'S'.
+
+VII.  NETOLS Commands
+
+   A number of commands to LETOLS are defined and all are described in
+   this section.  The format for each such command is the same as that
+   for the non-standard keys, and hence the command keywords are
+   included in Figure 3.  All of the conventions of Section VI apply as
+   well to the entry of commands.  The user should understand, however,
+   that such commands are processed by NETOLS, not OLS, and that they
+   are defined only for Network users of OLS.
+
+A.  HELP
+
+   The HELP command (invoked with ';HELP_' if';' is the prefix)
+   reproduces for the user the third column of Figure 3; the names of
+   all non-standard keys and the keywords for all defined NEOLS commands
+   are listed in their collating sequence on the user's virtual
+   teletype.
+
+B.  PREFIX
+
+   Issuing the PREFIX command causes the next character typed to become
+   the prefix, provided it is one of those listed in Figure 2.
+   Consequently, ';PREFIX_@' makes '@' the prefix, '@PREFIX_;' restores
+   the defaults situation.
+
+C.  SHIFT and UNSHIFT
+
+   The SHIFT command causes a perturbation of lines 2 and 3 of Figure 2.
+   After SHIFT is issued, all subsequent upper-case alphabetics are
+   mapped into the Greek characters (rather than into the alphabetics),
+   and lower-case alphabetics into alphabetics (rather than into the
+   Greek characters).  This convention change may be found convenient if
+   the user's User Telnet sends lower-case alphabetics by default, and
+   requires, for example, that a shift key be held down to send upper-
+   case characters.
+
+   The UNSHIFT command nullifies the effect of SHIFT.
+
+D.  FULLDUPLEX and HALFDUPLEX
+
+   Issuing the FULLDUPLEX command causes all subsequent characters typed
+   by the user to be echoed by _NETOLS_.  HALFDUPLEX nullifies the
+   effect of FULLDUPLEX, disabling echo by NETOLS.  Half-duplex is the
+   default situation.
+
+
+
+White                                                          [Page 10]
+
+RFC 216          Telnet Access To UCSB's On-Line System   September 1971
+
+
+E.  STATE
+
+   The STATE command causes the current prefix, the mode of operation
+   ('HALFDUPLX' or 'FULLDUPLEX'), and the case convention ('SHIFT IS ON'
+   or 'SHIFT IS OFF') to be displayed on the user's virtual teletype in
+   the following form:
+
+      PREFIX IS;
+      HALFDUPLEX
+      SHIFT IS OFF
+
+F.  LOGOUT
+
+   Issuing the LOGOUT command causes the user to be logged out of OLS
+   (i.e., _SYST_ _DOWN_ to be pushed) and his Network connection to
+   NETOLS to be broken.  About three seconds elapse between the two
+   events.
+
+VIII.  OLS Display
+
+   NETOLS suppresses all but alphameric display before it reaches the
+   user.  Alphameric display is mapped into the Telnet character set
+   according to Figures 4 and 5.  Figure 4 lists all those OLS display
+   character, which have one-for-one mappings.  A line of that figure
+   reads as follows:
+
+      For '[half harrow]'
+
+      The character logical not, displayed as '[half arrow]' on an OLS
+      terminal, is represented in Telnet as '~' (tilde).
+
+   Alphabetics are mapped into upper-case alphabetics and Greek
+   characters into lower-case alphabetics.  Numerics are mapped into
+   numerics, and a miscellany of punctuation into itself.  In addition a
+   number of carriage control characters are appropriately mapped-- line
+   feed down into LF, TAB into HT, BACK into BS, etc.; line feed up is
+   suppressed.  ERASE is represented as Bel.
+
+   Figure 5 lists those OLS display characters which are mapped into
+   strings of Telnet characters.  In most cases, these character strings
+   are stylistic representations of characters peculiar to OLS.  For
+   example, the _ADD_ key is normally displayed in List mode as '[circle
+   +]'.  In this Telnet implementation, '(+)' is an attempt to represent
+   that graphic.  Superscripts are represented as underscored numerics.
+   Carriage return is represented as CR LF.  No attempt is made to
+   effectively represent RS which, on an OLS display device, repositions
+   the beam to the upper left corner of the screen; it is made
+   equivalent to carriage return.
+
+
+
+White                                                          [Page 11]
+
+RFC 216          Telnet Access To UCSB's On-Line System   September 1971
+
+
+IX.  Instructing a User Telnet
+
+   For local users, all echoing _that's done at all_
+
+To Display       (OLS Explanation)  OLS Sends  (Telnet Explanation)
+0-9                Decimal Digits     0-9        Decimal Digits
+_-Z                Alphabetics        A-ZUC      Alphabetics
+_-5                Greek Characters   a-z        LC Alphabetics
+!                  Exclamation Mark   !          Exclamation Mark
++                  Plus Sign          +          Plus Sign
+_                  Underscore         _          Underscore
+-                  Minus Sign         -          Minus Sign
+@                  Commercial At      @          Commercial At
+/                  Slash              /          Slant
+#                  Number Sign        #          Number Sign
+'                  Apostrophe         '          Apostrophe
+&                  Ampersand          &          Ampersand
+$                  Dollar Sign        $          Dollar Sign
+*                  Asterisk           *          Asterisk
+%                  Percent            %          Percent
+=                  Equal Sign         =          Equal Sign
+TAB                Horizontal Tab.    HT.        Horiz. Tab (_I)
+:                  Colon              :          Colon
+;                  Semi-Colon         ;          Semi-Colon
+[                  Left Bracket       [          Left Bracket
+]                  Right Bracket      ]          Right Bracket
+(                  Left Parenthesis   (          Left Parenthesis
+)                  Right Parenthesis  )          Right Parenthesis
+<                  Less Than          <          Less Than
+>                  Greater Than       >          Greater Than
+,                  Comma              ,          Comma
+"                  Quotation Marks    "          Quotation Marks
+?                  Question Mark      ?          Question Mark
+[half arrow]       Logical Not        ~          Tilde
+|                  Logical Or         |
+                                      |          Vertical Line
+BACK               Backspace          BS         Backspace
+SPACE              Space              SP         Space
+ENL/[up arrow]     Line Feed Up
+CON/[down arrow]   Line Feed Down     LF         Line Feed ([up arrow]J)
+_                  List Mode Space    _          Underscore
+[shaded rectangle] List Mode Rubout   X          Upper-case X
+_                  List Mode Pointer  _          Underscore
+BREAK              Break              SP         Space
+ERASE              Erase              BEL        Bell (_G)
+
+             Figure 4. Characters With One-for-One Mappings
+
+
+
+
+White                                                          [Page 12]
+
+RFC 216          Telnet Access To UCSB's On-Line System   September 1971
+
+
+To Display          (OLS Explanation)              OLS Sends
+
+:                     Post List                  (:)
+[circle +]            List Mode Add              (+)
+[circle -]            List Mode Subtract         (-)
+[circle .]            List Mode Multiply         (*)
+[circle /]            List Mode Divide           (/)
+[arrow]               List Carriage Return       ([2 vertical lines])
+RETURN                Carriage Return            CR LF
+RS                    Reset to Upper Left        CR LF
+[cent sign]           Cent Sign                  C BS [2 vertical lines]
+0-9                   Superscript 0-9            0 BS _
+                                                  -
+                                                 9 BS _
+
+              Figure 5. Characters Which Map Into Strings
+
+   is done by OLS; the terminal never echoes.  In general, OLS does not
+   echo the user's input.  There are exceptions to this rule, but they
+   are relatively few in number and occur primarily on the SYST level.
+   In particular, upper keyboard keys are never echoed except in List
+   mode.  The Network user is advised to instruct his telnet to operate
+   in full-duplex mode, i.e., to echo nothing.  The FULLDUPLEX command
+   provided by NETOLS is provided because it can be provided, but its
+   use is not recommended.
+
+   OLS is meant to be used in character-at-a-time mode, and the user
+   should so instruct his User Telnet.  For those users provided with
+   only a line-at-a-time mode, the end-of-line character should not be
+   transmitted to NETOLS.
+
+   NETOLS flushes without comment all Telnet control characters it
+   detects in the input stream.  Characters in the Telnet character set
+   which have no meaning to NETOLS are echoed as '?' and discarded.
+   Exceptions are LF (line feed) and NUL, which are flushed without
+   comment.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+White                                                          [Page 13]
+
+RFC 216          Telnet Access To UCSB's On-Line System   September 1971
+
+
+X.  Examples
+
+A.  LOGON
+
+   The dialogue which logs a user onto OLS, assuming the user number of
+   Section IV, is as followings:
+
+   TELNET ENTRY            OLS QUERY/RESPONSE
+
+                                   UCSB ONLINE SYSTEM
+                                   ENTER USER NUBMER (196)
+   196%                            ID NUMBER=
+   57372%                  USER NAME= (ARPA)
+   ARPA%                   JOB NAME= (UCSB-WHITE)
+   UCSB-WHITE%             AUTOSAVE CODE = integer
+   MOLSF %                 LOAD (MOLSF)
+                                   FILE LOADED
+
+   In this and succeeding examples, '%' denotes CR (carriage return).
+   Entries echoed by OLS are enclosed in parentheses above.  The user
+   should substitute for 'UCSB-WHITE' his own affiliation and name.  The
+   procedure above loads the math subsystem of OLS.  To load instead
+   either COL or NET, substitute its name for 'MOLSF'.  To load a
+   different subsystem (say COL) after logging in:
+
+   TELNET ENTRY                    OLS QUERY/RESPONSE
+   ;SYST_                          WORK AREAS UPDATED
+   ;LOAD _COL%                     LOAD (COL)
+                                           FILE LOADED
+
+   Again, '_' denotes a space, not an underscore.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+White                                                          [Page 14]
+
+RFC 216          Telnet Access To UCSB's On-Line System   September 1971
+
+
+B.  NEWTOWN-RAPHSON SQUARE ROOT APPROXIMATION
+
+   A simple user program can be constructed to approximate the square
+   root of a number N using the Newton-Rapshon iteration procedure,
+   which derives the (k+1)th approximation from the kth by the following
+   algorithm:
+
+      X k+1= (xk+n/kk)/2
+
+   The following entries construct the user program:
+
+   ;LIST_)TYPE_%ENTER_N
+   ;1_;REAL_;LOAD_;ENTER_;STORE_N
+   ;TYPE_% ENTER_FIRST_GUESS
+   ;1_;LOAD_;ENTER_;STORE_X
+   ;TYPE_%#_OF_INTERATIONS?
+   ;0_;LOAD_;ENTER_;STORE_N
+   ;1_;REPT_(;LOAD_N ;/_X;+_X ;/_2
+           ;STORE_X ; DISP_%/_X ;+_X ;/_2
+   ;LIST_;STORE_;USER_;1_;SQRT_
+
+   To display the user program, enter:
+
+   ;USER_;DISP_;SQRT_
+
+   When executed, the program obtains from the user the number N whose
+   square root is sought, an initial guess, and the number of iterations
+   to be performed.  The program then computes and displays the results
+   of each iteration, and then calls itself, permitting a second square
+   root to be computed.  The program is executed as follows:
+
+   TELNET ENTRY                    OLS QUERY/RESPONSE
+
+   ;USER_;1_;SQRT_                 ENTER N
+   3 ;ENTER_                               ENTER FIRST GUESS
+   1 ;ENTER_                               #OF ITERATIONS?
+   4 ;ENTER_                               2.       +00
+                                           1.75     +00
+                                           1.73214+00
+                                           1.73205+00
+
+                                           ENTER N
+                   etc.
+
+
+
+
+
+
+
+
+White                                                          [Page 15]
+
+RFC 216          Telnet Access To UCSB's On-Line System   September 1971
+
+
+C.  Remote Job Entry
+
+   A file of card images can be constructed with the help of the COL
+   subsystem of OLS ard submitted as a batch job.  Assuming COL has been
+   loaded, the following entries construct a card file which invokes the
+   Fortran compiler:
+
+   ;2_//jobname_JOB_(acct#,name , , , , , ,T) ; STORE_
+   //_EXEC_FORTGCLG ; STORE_
+   //FORT.SYSIN_DD_* ; STORE_
+   source-statement-1 ;STORE_
+
+                   ...
+   source-statement-N ; STORE_
+   /* ; STORE_
+
+   To display the completed file, type:
+
+           ;3_;DISP_%
+
+   To submit the file, type:
+
+           ;4_;SUB_%
+
+   To watch for it in execution, type:
+
+           ;DISP_J%%%...
+
+   When execution is complete, 'printed' output can be retrieved with
+   the following dialogue:
+
+   TELNET ENTRY                    OLS QUERY/RESPONSE
+
+   ;CMPLX_;LOAD_                   UNIT = (2314)
+   2314%                                   VOL=SER= (MVT180)
+   MVT180%                         DSNAME= (RJEOUT)
+   RJEOUT%                         MEMBER= (jobname)
+   Jogname%                                NOW LOADING
+                                           FILE LOADED
+
+   The output can then be examined by entering:
+
+      ;2_;DISP_1%%%...
+
+
+   NOTE: Text within brackets describes non-ASCII characters that were
+   part of the original document.  Please see the PDF file for the
+   original representation.
+
+
+
+White                                                          [Page 16]
+