doc: Add RFC documents

1 files changed, 339 insertions, 0 deletions

diff --git a/doc/rfc/rfc307.txt b/doc/rfc/rfc307.txt
new file mode 100644
index 0000000..98692f2
--- /dev/null
+++ b/doc/rfc/rfc307.txt
@@ -0,0 +1,339 @@
+
+
+
+
+
+
+Network Working Group                                         E. Harslem
+Request for Comment: 307                                            Rand
+NIC: 9258                                              February 24, 1972
+References: 113, 189
+
+                     USING NETWORK REMOTE JOB ENTRY
+
+OVERVIEW
+
+   As has been mentioned in previous RFCs and at previous Network
+   meetings various groups at Rand have been doing RJE to remote Network
+   sites (UCBS and UCLA) for over a year.  Until recently all this work
+   has been done from our IBM 360/65 which is only a Network using host
+   (not a server).  Recently our PDP-10 has come onto the Network as
+   both a user and server host.  We now have, as well, a program on the
+   PDP-10 allowing access to the Remote Job Service (RJS) at UCLA.  Our
+   normal mode of operation is diagramed below.
+
+
+                    RAND                                     UCLA
+               ________________                        ________________
+              |    PDP-10      |                      |     360/91     |
+    ______    |                |                      |                |
+   |      |   |   __________   |                      |   __________   |
+   |File  |   |  | RJS      |  |                      |  |          |  |
+   |System|___|__| Access   |__|___/\/\ Network /\____|__|    RJS   |  |
+   |      |   |  | Program  |  |       \/     \/      |  |          |  |
+   |______|   |  |__________|  |                      |  |__________|  |
+              |       |        |                      |                |
+              |       |        |                      |                |
+              |_______|________|                      |________________|
+                      |
+                      |
+                    User
+
+   To use RJS the user creates a job source "deck" in the Rand File
+   system.  He then instructs the RJS Access Program (RJSAP) to send
+   that file (job) to RJS.  (Sample session below.)  He can then monitor
+   the status of his job via RJSAP (and hence RJS) and ask that RJSAP
+   retrieve his print output to a local file, (or directly to his
+   console, the line printer or whatever).
+
+   Recently, several people at other Network sites have expressed an
+   interest in using RJS.  However, they are located at a minimal Host
+   or at a host not providing RJS access.  Since the Rand PDP-10 is a
+   Network server, these people can solve their access problem by
+   logging onto the Rand PDP-10, using Telnet, and running the RJSAP
+   themselves.  The remainder of this RFC describe the steps necessary
+
+
+
+Harslem                                                         [Page 1]
+
+RFC 307              Using Network Remote Job Entry        February 1972
+
+
+   to run that program.
+
+The Rand PDP-10
+
+   The Rand PDP-10 operates under the Tenex operating system.  Thus,
+   some understanding of the Tenex Executive is required.  The necessary
+   documents can be obtained from the developers of Tenex:
+
+                    Bolt, Beranek and Newman, Inc.
+                    50 Moulton Street
+                    Cambridge, Massachusetts 02138
+                    (617) 491-1850
+
+   Secondly, it is necessary to establish an account on the Rand PDP-10.
+   This can be done through:
+
+                    Rod Fredrickson
+                    The Rand Corporation
+                    1700 Main Street
+                    Santa Monica, California 90406
+                    (213) 393-0411
+
+UCLA Remote Job Service
+
+   To use the UCLA IBM 360/91 via RJS it is necessary to:
+
+      1) have an account at UCLA
+      2) have an assigned RJS terminal ID.
+
+   These can both be obtained from
+
+                    Bob Braden
+                    UCLA
+                    Math Sciences Building
+                    3531 Boelter Hall
+                    Los Angeles, Calif.  90024
+                    (213) 825-7518
+
+The RJS Access Program (RJSAP)
+
+   A sample session using RJSAP is attached below.  The RJSAP is started
+   by typing "RJS<return>" to the Tenex executive.  The program will
+   then initialize and check (via your login information) to see if you
+   are a user recorded in its tables.  This is done to assure you have a
+   valid RJS terminal ID.  If your ID is not found, the program will
+   terminate with appropriate message.
+
+
+
+
+
+Harslem                                                         [Page 2]
+
+RFC 307              Using Network Remote Job Entry        February 1972
+
+
+   If your ID is found, RJSAP will attempt to connect to RJS.  If UCLA
+   is down, a message to that effect will appear and the program will
+   terminate.  If UCLA is up, RJSAP will connect you to RJS and sign-on
+   your terminal ID (see RFC 189).  RJSAP will respond "YOU ARE
+   CONNECTED TO RJS."
+
+   At this point RJS will acknowledge your signon and print out messages
+   regarding system status.
+
+   The programs (RJSAP and RJS) are now ready to perform RJE functions.
+   All commands are initially interpreted by RJSAP.  They are listed and
+   explained below.
+
+      1. Help
+
+         If the user types "?" RJSAP will echo the "?" and list the
+         valid set of commands (see below).
+
+      2. Message to RJS
+
+         If the first character of a command is a "/" all subsequent
+         characters up to a "return" are transmitted to RJS on the
+         operator input connection.  See RFC 189 for the syntax and
+         semantics of these commands.
+
+         An operator input message can be cancelled with the RUB OUT key
+         or backspaced using BACKSPACE.
+
+      3. Send a Job
+
+         When the user types "S" RJSAP echoes "SEND SOURCE DECK FROM
+         FILE".  The user then enters the file name containing his job
+         followed by a "return."  Obviously the file must already exist.
+         If the file is ok and is transmitted successfully, both RJSAP
+         and RJS will print an acknowledgement on the user's terminal
+         (see example below).
+
+      4. Retrieve Job Output-Printer
+
+         The user can retrieve printed output by entering "PR".  RJSAP
+         will echo "PRINT OUTPUT TO FILE".  The user then enters the
+         files name where he wants the output.  This can be a new file
+         or even a device such as the printer or teletype.  When the
+         print output is completely received, the RJSAP will print an
+         acknowledgment (see example).
+
+
+
+
+
+
+Harslem                                                         [Page 3]
+
+RFC 307              Using Network Remote Job Entry        February 1972
+
+
+      5. Retrieve Job Output-Punch
+
+         This function is currently not implemented, pending a decision
+         on the use of this channel between a PDP-10 and a 360.
+
+      6. Transmission Status
+
+         For long transmissions of job input or output it may be
+         desirable to check on the progress of the transmission.  Typing
+         "R" will cause RJSAP to echo "REPORT ON TRANSMISSIONS--",
+         followed by a record count for the job input and printer output
+         channels.
+
+      7. Termination
+
+         If the user types a "Q" at the start of a command, RJSAP will
+         echo "QUIT IN PROGRESS" and terminate.  This is the preferred
+         way of terminating the program.  (Rather than just ^C).
+
+   NOTE: Since RJSAP has not been extensively used, we expect it to be
+   improved and modified in the future.  Thus, the last section of this
+   RFC -- the explanation of the use of RJSAP -- will be kept in file
+   <HARSLEM>RJSACCESSPROGRAM.EXPLANATION on the Rand PDP-10 and be
+   updated appropriately.
+
+Sample Session
+
+   The follows is a sample session using RJS from RJSAP on the Rand
+   PDP-10.  All user inputs have been underlined (shown as _text_ ).
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Harslem                                                         [Page 4]
+
+RFC 307              Using Network Remote Job Entry        February 1972
+
+
+TENEX 1.28,RAND EXEC 1.33.1                          Rand Exec Prompt
+@_LOGIN_                                        \
+(USER) _HARSLEM_                                 \   User Logs In
+(PASSWORD)______                                 /
+(ACCOUNT #)_1__                                 /
+JOB 12 ON TTY10 25-FEB-72 11:12                      System Acknowledges
+@_RJS_                                               User Starts RJS
+                                                     Access Program
+
+RJS REMOTE ACCESS PROGRAM
+
+HELLO ERIC
+
+YOU ARE CONNECTED TO RJS                          \
+NRJ876I NETWORK REMOTE JOB SERVICE READY           \
+RJS750I TERMINAL NETRAND HAS SIGNED ONTO RJS        \ RJS Recognizes
+RJS652I INFORMATION ALERT -                         / Terminal ID and
+RJS250I OS COLDSTARTED 4:30 PM 24 FEB ALL JOBS     /  Prints System
+**IN SYS LOST AND MUST BE RESUBMITTED             /   News Messages
+RJS650I OS COLDSTARTED 11:07 FEB 25, ALL JOBS LOST MUST RESUBMIT_
+_?_
+VALID COMMANDS ARE:                                User asks for
+SEND A SOURCE FILE                                 Valid Commands
+PRINT OUTPUT RETRIEVAL
+PUNCH OUTPUT RETRIEVAL
+REPORT ON STATUS OF TRANSMISSIONS
+PRECEDE RJS OPERATOR COMMANDS WITH A SLASH
+QUIT TO TERMINATE THE PROGRAM
+_/STATUS JOBS_
+RJS804I TERMINAL NETRAND HAS NO JOBS ACTIVE        User Sends Message to
+_/STATUS LINES_                                    RJS asking Job Status
+RJS800I TERMINAL GSM     ACTIVE ON LINE 1          User asks RJS to
+RJS809I PUNCH REROUTE = ENGR                       show Active Users
+RJS800I TERMINAL ENGR    ACTIVE ON LINE2
+RJS800I TERMINAL CSCSRC  ACTIVE ON LINE7
+RJS800I TERMINAL NETRAND ACTIVE ON LINE8
+_S_END SOURCE DECK FROM FILE _TESTA.;1_
+TESTA.; TRANSMITTED TO RJS                         User Sends Job to RJS
+26 CARDS  SENT                                     Both Access
+RJS534I JOB MES727DS ACCEPTED BY RJS - 0000027     Program and RJS Ack
+**CARDS READ                                       Job Submission
+
+
+
+
+
+
+
+
+
+
+Harslem                                                         [Page 5]
+
+RFC 307              Using Network Remote Job Entry        February 1972
+
+
+_/STATUS JOBS_
+RJS810I TERMINAL NETRAND HAS THE FOLLOWING JOBS IN RJS
+RJS812I MES272DS SPL(A) 001                        User Asks Job Status
+             \                                     And Sees his job
+             /                                     being Spooled.
+             \
+             /
+       (SOMETIME LATER)
+             /
+             \
+_/STATUS JOBS_
+RJS810I TERMINAL NETRAND HAS THE FOLLOWING JOBS     User Checks and
+**IN RJS
+RJS812I MES727DS XEQ   000                          Finds his job ready
+             /
+             \
+        (SOMETIME LATER)
+             /
+             \
+             /
+             \
+_/STATUS JOBS_                                      User sees job
+RJS810I TERMINAL NETRAND HAS THE FOLLOWING JOBS     has been run
+**IN RJS
+RJS812I MES727DS PPT 060                            Print output ready
+_PR_INT OUTPUT TO FILE _LPT_:[CONFIRM]              User asks for output
+                                                    directly to printer
+
+_R_EPORT ON TRANSMISSIONS--
+ NO SEND IN PROGRESS                                User checks to see
+PRINT TO FILE LPT: RECORD COUNT=88                  the print retrieval
+LPT:RECEIVED 197 PRINT LINES                        running
+_Q_UIT IN PROGRESS                                  User Terminates
+BYE, BYE BANANA                                     Access Program
+
+@_LOGOUT_                                           User Logs Out
+KILLED JOB 3, USER HARSLEM, ACC 1, TTY 10, AT 2/25/72 1300
+  USED 0:0:21 IN 1:12:52
+
+
+
+
+
+        [This RFC was put into machine readable form for entry]
+    [into the online RFC archives by Hélène Morin, Viagénie, 12/99]
+
+
+
+
+
+
+Harslem                                                         [Page 6]
+