rfc407.txt

RFC技术文档 从0000－05

      OP (any string)

         The specified string is to be displayed to the Server site
         operator when any following job is initiated from the batch
         queue of the Server.  This command usually appears in the input
         file as a NET OP control card, but may be a TELNET command.  It
         is cancelled as an all-jobs command by an OP "crlf" command (no
         text supplied).







                                   10

                                               REMOTE Job Entry Protocol
                                                         (Oct. 16, 1972)
                                                       RFC 407 NIC 12112
                                                                        
                                                                        
RJE CONTROL CARDS IN THE INPUT FILE

   Certain RJE commands may be specified by control cards in the front
   of the input file.  If these controls appear, they take precedence
   over the same command given thru the RJE-TELNET connection and affect
   only this specific job.  All these RJE control cards must appear as
   the first records of the job's input-file.  They all contain the
   control word NET in columns 1 through 3.  Scanning for these controls
   stops when the first card without NET in col 1-3 is encountered.

   The control commands appear in individual records and are terminated
   by the end-of-record (usually an 80 column card-image).  Continuation
   is permitted onto the next record by the appearance of NET+ in
   columns 1-4 of the next record.  Column 5 of the next record
   immediately follows the last character of the previous record.

      NET OUTUSER = <user-id>
      NET OUTPASS = <password>
      NET OUT <out-file> = <disp>
      NET OP <any string>

   See the corresponding TELNET command for details.  One option
   permitted by the NET OUTUSER and NET OUT controls not possible from
   the TELNET connection is specification of different OUTUSERs for
   different OUTS, since the TELNET stored and supplies only an initial
   OUTUSER, but the controls may change OUTUSERs before each OUT control
   is encountered.

RJE USE OF FILE TRANSFER PROTOCOL

   Most non-TIP files will be transferred to or from the RJE-server
   through the FTP process.  RJE-server will call upon its local
   FTP-user supplying the Host, File-pathname, User-id, Password, and
   Mode of the desired transfer.  FTP-user will then connect to its
   FTP-server counterpart in the specified host and set up a transfer
   path.  Data will then flow through the RJE-FTP interface in the
   Server, over the Network, from/to the foreign FTP-server and then
   from/to the specified File-pathname in the foreign host's file
   storage space.  On output files, the file-pathname may be recognized
   by the foreign host as directions to a printer or the file may simply
   be stored; a User-RJE-process can supply an output <file-id> by
   default which is recognized by its own Server-FTP as routing to a
   printer.

   Although many specifics of the RJE-Server/User-FTP interface are
   going to be site dependent, there are several FTP options which will
   be used in a standard way by RJE-Servers:





                                   11

                                               REMOTE Job Entry Protocol
                                                         (Oct. 16, 1972)
                                                       RFC 407 NIC 12112
                                                                        
                                                                        
      1. A new FTP connection will be initiated for each file to be
         transferred.  The connection will be opened with the RJE User
         supplied User-id (OUTUSER or INUSER) and Password.

      2. The data bytesize will be 8 bits.

      3. The FTP Type, Structure, and Mode parameters are determined by
         the RJE transfer direction (I/O), and the <transmission> and
         <code> options supplied by the User:

     I/O   <TRANS>   <CODE>   FTP-TYPE   FTP-STRUCTURE   FTP-MODE
      I*      N        -         A             R            B
      I       N        E         E             R            B
      I       T        -         A             F            S
      I       T        E         E             F            S
      I       A        -         P             R            B
      I       A        E         F             R            B
   
      O*      A        -         P             R            B
      O       A        E         F             R            B
      O       N        -         A             R            B
      O       N        E         E             R            B
      O       T        -         A             F            S
      O       T        E         E             F            S
   
              (*indicates default)

      4. The service commands used will be Retrieve for input and Append
         (with create) for output.  The FTP pathname will be the
         <pathname> supplied by the RJE User.

      5. On output in B form, the User-FTP at the RJE-Server site will
         send Restart-markers at periodic intervals (like every 100
         lines, or so), and will remember the latest
         Restart-marker-reply with the file.  If the file transfer is
         not completed and the <disp> is (S) then the file will be held
         pending User intervention.  The User may then use the RECOVER
         command to cause a FTP restart at the last remembered
         Restart-marker-reply.

      6. The FTP Abort command will be used for the RJE ABORT and CANCEL
         commands.

      7. For transfers where the FTP-MODE is defined as B, the user FTP
         may optionally attempt to use H mode.

   The specific form of the FTP commands used by an RJE-Server site, and
   the order in which they are used will not be specified in this
   protocol.



                                   12

                                               REMOTE Job Entry Protocol
                                                         (Oct. 16, 1972)
                                                       RFC 407 NIC 12112
                                                                        
                                                                        
   Errors encountered by FTP fall into three categories:  a) access
   errors or no storage space error; b) command format errors; and c)
   transfer failure errors.  Since the commands are created by the
   RJE-Server process, an error is a programming problem and should be
   logged for attention and the situation handled as safely as possible.
   Transmission failure or access failure on input cause an effective
   ABORT and user notification.  Transmission failure on output causes
   RESTART or Save depending on <disp> (see OUT command).  Access
   failure on output is a problem since the User may not be accessible.
   A status response should be queued for him, should he happen to
   inquire; a <disp> = (S) file should be Held; and a <disp> = <empty>
   transmit-and-discard file should be temporarily held and then
   discarded if not claimed.  "Temporarily" is understood here to mean
   at least several days, since particularly in the case of jobs which
   generate voluminous output at great expense to the User, he should be
   given every chance to retrieve his rightful output.  Servers may
   elect, however, to charge the User for the file-storage space
   occupied by the held output.


































                                   13

                                               REMOTE Job Entry Protocol
                                                         (Oct. 16, 1972)
                                                       RFC 407 NIC 12112
                                                                        
                                                                        
REPLIES OVER THE TELNET CONNECTION

   Each action of the RJE-server, including entry of each TELNET
   command, is noted over the TELNET connection to the User.  These
   RJE-server replies are formatted for Human or Process interpretation.
   They consist of a leading 3-digit numeric code followed by a blank
   followed by a text explanation of the message.  The numeric codes are
   assigned by groups for future expansion to hopefully cover other
   protocols besides RJE (like FTP).  The numeric code is designed for
   ease of interpretation by processes.  The three digits of the code
   are interpreted as follows:

   The first digit specified the "type" of response indicated:

      000

         These "replies" are purely informative, and are issued
         voluntarily by the Server to inform a User of some state of the
         server's system.

      100

         Replies to a specific status inquiry.  These replies serve as
         both information and as acknowledgment of the status request.

      200

         Positive acknowledgment of some previous command/request.  The
         reply 200 is a generalized "ok" for commands which require no
         other comment.  Other 2xx replies are specified for specific
         successful actions.

      300

         Incomplete information supplied so far.  No major problem, but
         activity cannot proceed with the input specified.

      400

         Unsuccessful reply.  A request was correctly specified, but
         could not be correctly completed.  Further attempts will
         require User commands.

      500

         Incorrect or illegal command.  The command or its parameters
         were invalid or incomplete from a syntactic view, or the
         command is inconsistent with a previous command.  The command
         in question has been totally ignored.



                                   14

                                               REMOTE Job Entry Protocol
                                                         (Oct. 16, 1972)
                                                       RFC 407 NIC 12112
                                                                        
                                                                        
      600-900

         Reserved for expansion

   The second digit specifies the general subject to which the response
   refers:

      x00-x29

         General purpose replies, not assignable to other subjects.

      x30

         Primary access.  These replies refer to the attempt to "log-on"
         to a Server service (RJE, FTP, etc.).

      x40

         Secondary access.  The primary Server is commenting on its
         ability to access a secondary service (RJE must log-on to a
         remote FTP service).

      x50

         FTP results.

      x60

         RJE results.

      x70-x99

         Reserved for expansion.

   The final digit specifies a particular message type.  Since the code
   is designed for an automaton process to interpret, it is not
   necessary for every variation of a reply to have a unique number,
   only that the basic meaning have a unique number.  The text of a
   reply can explain the specific reason for the reply to a human User.

   Each TELNET line (ended by "crlf") from the Server is intended to be
   a complete reply message.  If it is necessary to continue the text of
   a reply onto following lines, then those continuation replies contain
   the special reply code of three blanks.