rfc105.txt

RFC技术文档 从0000－05

is not in core, the Logger listens on socket x'300', and will reject the
first call it receives, read RJOR into core, and dispatch it.  RJOR will
then listen on that socket.  Thus to initiate a login sequence, the user
requests connection to socket x'300'.  If accepted, he is in contact
with RJOR.  If rejected, he should reissue the connection request; when
accepted, he will be connected to RJOR.  A second rejection would
indicate that the NCP's resources were exhausted.  Once this first half
of the required duplex connection has been established, RJOR will
consider the user logged in.

     Over this first connection (hereafter called the Input Connection),
the user transmits flags designating the function(s) to be performed by
RJOR, and the name of the job to which the function(s) is(are) to be
applied.  RJOR then closes this connection.  RJOR transmits control
information specifying the disposition of the user's request and the
output file (if requested) over a secondary connection involving RJOR's
socket number x'301', site 3, and the socket at the user's site whose
socket number is one less than that on which RJOR was contacted by the
user.  The user's request may or may not be immediately executable.  If
the former is the case, RJOR issues a connection request to the
designated user receive socket, and when the connection is established
transmits whatever control information is appropriate along with the
user's output (if required); RJOR then closes the connection and the
user is considered logged out.  If the user's request cannot be



White                                                           [Page 5]

RFC 105                       RJE at UCSB                     March 1971


immediately satisfied (e.g., the job whose output is sought hasn't been
submitted yet or hasn't finished execution), the second connection is
opened by RJOR just long enough to inform the user of the delay, and
then closed.  Then when the request can be serviced, the connection is
reopened, the required data transmitted, and the connection closed; the
user is then considered logged out.

     To prevent RJOR from being monopolized by a single user, provision
is made within the software for terminating a connection if RJOR is ever
required to wait more than a certain amount of time for completion of a
transmission to or from the connected user.  For now, this time limit
has been set at one minute per record, but it may be shortened or
lengthened as required in the future.

II.B - The Input Connection

     RJOR expects the first byte of data it receives over the Input
Connection to be zeros, indicating message Type 0; it discards this byte
unexamined, and thereafter, attaches no significance to IMP-message
boundaries.  The second byte of data received is interpreted as flags
specifying the function(s) to be performed.  Following the flag byte,
RJOR expects an eight-byte, EBCDIC job name, padded on the right with
blanks if necessary.  The flag byte is interpreted as follows:

     Bit 0 = 1:  transmit the output generated by the specified job.
     Bit 1 = 1:  purge the output file created by the specified job.
     Bit 2 = 1:  wait as long as is required to execute the
                 function(s) specified by Bits 0-1.
           = 0:  if the function(s) specified by Bits 0-1 cannot be
                 executed immediately, simply return an indication of
                 that fact.
     Bit 3 = 1:  an earlier request pertaining to the specified job
                 which exercised the wait-for-output (Bit 2) option
                 is to be canceled.
     Bits  4-7:  not examined, should be zeros.

Any combination of Bits 0-2 is permissible.  If Bit 3 = 1, no other bits
are examined.  If Bit 0 = 1 and Bit 1 = 1, the output file is
transmitted before it is purged.  If two jobs with the same name are
executed in succession, output from the second job will overlay that
produced by the first.  In such cases, the user should purge the output
from the first job after it has been transmitted to him so that a
request for output from the second job will not simply return a second
copy of the first job's output.

II.C - The Output Connection

     RJOR may open the output connection either one or two times as the



White                                                           [Page 6]

RFC 105                       RJE at UCSB                     March 1971


result of a single transmission on the Input Connection.  In each case,
the first byte transmitted will consist of zeros indicating message Type
0, and thereafter for the life of the connection, IMP-message boundaries
are not significant.  Following the first byte, RJOR will transmit the
name of the job to which the response applies.  The job name will be
contained in an 8-byte field identical to that supplied by the user over
the Input Connection.  Following the job name, RJOR will transmit zero
or more variable length logical records.  Each will consist of a one-
byte op code, a two-byte length field which specifies the unsigned
length in bits of the variable length text field which follows.  The
text field may be zero or more bytes in length; the length field will
contain an integer which is a multiple of eight.

     The op codes presently defined are listed in Figure 1.  An op code
of x'01' indicates that the text field contains one record of one of the
SYSOUT data sets created by the job whose output was requested.  The
length fields of all logical records with an op code of x'01' will be
identical.  For data sets with record lengths other than this value,
records are padded on the right side with blanks or truncated on the
right to this standard record length.  Carriage control characters which
would ordinarily appear in column 1 for printer-destined output have
been discarded and do not appear.* The records are transmitted to the
user in the same sequence as they would be printed on the printer, and
collectively include everything that would appear in printed output with
the exception of HASP separator sheets.

     In all logical records but those with an op code of x'01', the
length field contains the value zero, and the op code conveys the entire
meaning of the logical record.
















________________________________________________________________________
*This restriction is temporary; a fix is in the works and will be
announced.



White                                                           [Page 7]

RFC 105                       RJE at UCSB                     March 1971


Figure 1.  Output Connection Op Codes
---------  --------------------------

Op Code
 (Hex)    Name                   Explanation
-------   ----                   -----------

  00      End-of-File.           All output from the job has been
                                 transmitted (follows last op-code-x'01'
                                 logical record).
  01      Output.                The text field contains one record of
                                 one SYSOUT data set generated by the
                                 job.
  02      Output file purged.    Output from the job has been purged as
                                 requested.
  03      No core for buffer.    Insufficient main storage is available
                                 for transmitting output from the job.
                                 The transmission request has been
                                 aborted and the purge request (if any)
                                 has been suppressed.
  04      I/O Error reading      An irrecoverable I/O error was
          file.                  encountered reading the output file.
                                 The transmission request has been
                                 aborted and the purge request (if any)
                                 suppressed.
  05      I/O Error purging      An irrecoverable I/O error was
          file.                  encountered purging the output file.
                                 The purge request was aborted.
  06      No queue space for     Output from the job was not available
          request.               and the wait-for-output option was
                                 specified, but RJOR's resources were
                                 insufficient to queue the request,
                                 which was suppressed.
  07      Waiting for output.    Output from the job is not available
                                 and the wait-for-output option was
                                 specified.  RJOR is waiting for the
                                 job's output.
  08      Canceled request not   The user requested that a previously
          found.                 made request specifying the
                                 wait-for-output option be canceled.  No
                                 such request was found by RJOR.
  09      Request canceled.      At the user's request, a previously
                                 made request specifying the
                                 wait-for-output option has been
                                 canceled.
  0A      I/O Error seeking      An irrecoverable I/O error was
          file.                  encountered attempting to locate output
                                 from the job.  The user's request was



White                                                           [Page 8]

RFC 105                       RJE at UCSB                     March 1971


                                 aborted.
  0B      Output not found.      Output from the job was not found.  The
                                 wait-for-output option was not
                                 specified by the user.

       [ This RFC was put into machine readable form for entry ]
         [ into the online RFC archives by Randy Dunlap 4/97 ]












































White                                                           [Page 9]