doc: Add RFC documents

1 files changed, 271 insertions, 0 deletions

diff --git a/doc/rfc/rfc379.txt b/doc/rfc/rfc379.txt
new file mode 100644
index 0000000..63e5f51
--- /dev/null
+++ b/doc/rfc/rfc379.txt
@@ -0,0 +1,271 @@
+
+
+
+
+
+
+NETWORK WORKING GROUP                                     R.T. BRADEN
+REQUEST FOR COMMENTS #379                                 UCLA/CCN
+NIC 11121                                                 AUGUST 11, 1972
+CATEGORIES :
+OBSOLETES:
+UPDATES:
+
+
+                            USING TSO AT CCN
+
+    IBM's Time Sharing Option ("TSO") is now available at CCN for use via
+the Network with Telnet Protocol.  TSO is not yet considered "production"
+by CCN, since there are a number of restrictions and glitches to be removed
+or documented.  However, TSO is now quite stable and is up on a regularly
+scheduled basis; the system will allow an experienced programmer to work
+productively at CCN.  To use TSO, you will need a valid CCN charge (billing)
+number, and a user-id.  To obtain a charge number (if you do not already
+have one), or to obtain a TSO user-id, contact Barbara Noble at (213)
+825-7438 or (213) 825-7452.  At present we are not charging for TSO use
+(although any batch jobs submitted from TSO will be charged to your account).
+Barbara can assign on overhead charge number for experimental use of TSO if
+you do not have a paid account.
+
+Modes of TSO Use
+----------------
+
+    (1)  Conversational Remote Job Entry
+         -------------------------------
+
+         Using TSO you can prepare an OS job stream using the TSO EDIT command,
+         SUBMIT the job to batch execution, monitor its STATUS, and ship the
+         OUTPUT back to EDIT for examination.  This allows those of you with
+         TIP'S to process jobs at CCN without using NETRJS via a friendly
+         TENEX machine.  Any batch job can be submitted this way.
+
+
+    (2)  Foreground Execution
+         --------------------
+
+         Many OS/360 programs can be run, with varying degrees of inconvenience,
+         directly from the terminal.  There are TSO commands providing the
+         facilities of EXEC and DD cards; the output stream can be directed to
+         the user's terminal.  There are some important limitations to fore-
+         ground operation, however:
+
+              (1)  The foreground region size is limited; at present, it is
+                   128K, though this will be expanded.
+
+
+
+
+                                                                [Page 1]
+
+              (2)  All datasets referenced must be on resident disk packs;
+                   no disks or tapes can be mounted.
+
+              (3)  Since you are time-sliced and swapped, it can be very
+                   slow.
+
+    There are two important cases of foreground execution:
+
+         (A)  The TEST command provides DDT-like debugging capability
+              for foreground programs.
+
+         (B)  The user's own program can interact with his terminal.
+
+NOTE:  It is not yet possible for a program, either in batch or foreground,
+       to open direct Network connections.
+
+Hours of Operation
+------------------
+
+     Monday through Friday, 6 A.M. - Noon PDT (or 9 A.M. - 3 P.M. EDT).
+     These hours will be extended before September 1, 1972.
+
+Telnet Protocol
+---------------
+
+     The document "USING TSO VIA ARPA NETWORK VIRTUAL TERMINAL", RFC #377
+     describes the use of a Telnet NVT to access TSO.  There are some signi-
+     ficant differences from using a real 2741 locally.  RFC #377 describes
+     the current server Telnet, complete with an annoying bug.  A later
+     version will include the following capabilities not presently available:
+
+          (a)  "FULL DUPLEX", i.e., CCN echoing.
+
+          (b)  Lower case input.
+
+          (c)  The special character translation included in NETRJS
+               users with Model 33 Teletypes. (see RFC #338).
+
+          (d)  Optional specification of single CR or single LF as end-of-line
+               indication
+
+          (e)  Hopefully, the input attention bug described in RFC #377 will
+               be fixed.
+
+
+
+
+
+
+
+
+                                                                [Page 2]
+
+Disk Space
+----------
+
+     TSO will automatically place datasets created in the foreground (e.g., by
+     EDIT or ALLOC) on the proper resident disk pack.  All TSO datasets are
+     cataloged, and can be referenced by name alone (no volume or unit specifi-
+     cation is necessary).  For most purposes, you can pretend we have one big
+     disk.                                                             --- ---
+     ----
+
+Dataset Names
+-------------
+
+     The standard IBM version of TSO uses the TSO user-id as the highest
+     index of each dataset name.  At CCN, the _two_ highest levels are the
+     charge number and the user-id of the person who created the dataset.
+     TSO has been modified accordingly.
+
+Dataset Access Control
+----------------------
+
+     In general, under TSO a user can access for reading, writing, or
+     execution any dataset named with the charge number with which he is
+     logged on.  In addition, he can rename or scratch any dataset with the
+     logon charge number.  There is no provision for public or read-only
+     datasets a present.
+
+Logging On
+----------
+
+     Most Network users will need only the simple form of LOGON:
+
+                   logon     <user-id>
+
+     EXAMPLE:                         NOTES:
+     -------                          -----
+
+          user:  logon uid            (Use your user-id)
+
+          TSO:   LOGON UID            (TSO repeats line for reasons of its own)
+
+          TSO:  ENTER PASSWORD        (TSO asks for password)
+
+          user:  xyz
+
+          TSO:  UID LOGON IN PROGRESS AT 11:37:43 ON AUGUST 9, 1984
+
+
+
+
+
+                                                                [Page 3]
+
+          TSO:  LOGON PROCEEDING      (It may take a while.  This message will
+                                      come every 30 seconds.)
+
+          TSO:  WELCOME TO TSO.  GOOD LUCK
+
+          TSO:  READY
+
+     User-id's are created in TSO with a blank password.  To add or change your
+     password, use the CHANGE command.  If you have TSO access under more than
+     one charge number, LOGON will prompt you for the charge number to be used
+     for the session.
+
+Where to Get Help
+-----------------
+
+    1.  To obtain a list of TSO commands enter:  "help commands"
+
+    2.  To get detailed information on syntax and function of a particular
+        command, enter: "help <command name> <qualifiers>"
+        Type "help help" for details.
+
+    3.  The SEND command may be useful for on-line help from PCN (Pete Nielsen)
+        or WDD (Bill Drain), when they are signed on.  You can find out if PCN
+        or WDD is on by sending them a trial message.
+
+        EXAMPLE:
+        -------
+
+               User:  send 'hello' user(wdd)
+
+               TSO:   USER WDD NOT LOGGED ON
+
+               TSO:   READY
+
+               user:  send 'hello' user(pcn)
+
+               TSO:   READY
+
+               user:  send 'edit is acting funny' user(pcn)
+
+               TSO:   READY
+
+        Here "PCN" was logged on and got your message.  You can, therefore,
+        converse with him through SEND.  The text in one SEND is limited to
+        115 characters.
+
+    4.  You can also leave a message for wdd to receive when he logs on by
+        typing:  send '<message>' user(wdd) logon.
+
+
+
+                                                                [Page 4]
+
+    5.  To send a message to the CCN operator, enter simply:  send '<message>'
+
+    6.  You can call the CCN Telephone Consultant at (213) 825-7452, Monday
+        through Friday during the hours 10-12 A.M. PDT and 1-4 P.M. (except
+        3-4 P.M. on Thursday).  If the consultant does not know the answer,
+        he/she will investigate and call you back.
+
+    7.  You can call the general contact for Network user problems, Barbara
+        Noble, at (213) 825-7438.  Barbara is also one of the Telephone
+        consultants.
+
+    8.  If all else fails, call Bill Drain, the CCN Systems Programmer in
+        charge of TSO installation.  His telephone is (213) 825-7474 (if no
+        answer, call my secretary at (213) 825-7518 and leave a message for
+        Bill).
+
+    9.  You can also send a message to someone at CCN by submitting the
+        following pseudo-job through RJS at TSO:
+
+                   //<charge number>  JOB 'BIN=9906',MSGLASS=C
+                   //*  <message>
+                   //*
+                   //*
+                   //*
+                   //*
+                   etc.
+
+
+
+       [ This RFC was put into machine readable form for entry ]
+       [ into the online RFC archives by BBN Corp. under the   ]
+       [ direction of Alex McKenzie.                      1/97 ]
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+                                                                [Page 5]
+