RFC 740                                              RTB 42423 22 Nov 77
NETRJS Protocol



Network Working Group                                          R. Braden
Request for Comments: 740                                       UCLA-CCN
NIC: 42423                                              22 November 1977
Obsoletes: 189, 599



                           NETRJS PROTOCOL




A.  Introduction

  NETRJS, a private protocol for remote job entry service, was defined
  and implemented by the UCLA Campus Computing Network (CCN) for batch
  job submission to an IBM 360 Model 91. CCN's NETRJS server allows a
  remote user, or a daemon process working in behalf of a user, to
  access CCN's RJS ("Remote Job Service") subsystem.  RJS provides
  remote job entry service to real remote batch (card reader/line
  printer) terminals over direct communications lines as well as to the
  ARPANET.

  A batch user at a remote host needs a NETRJS user process to
  communicate with the NETRJS server at the batch host. An active
  NETRJS user process simulates a "Virtual Remote Batch Terminal", or
  "VRBT".

  A VRBT may have virtual card readers, printers, and punches. In
  addition, every VRBT has a virtual remote operator console. Using a
  virtual card reader, a Network user can transmit a stream of card
  images comprising one or more batch jobs, complete with job control
  language ("JCL"), to the batch server host. The NETRJS server will
  cause these jobs to be spooled into the batch system to be executed
  according to their priority.  NETRJS will automatically return the
  print and/or punch output images which are created by these jobs to
  the virtual printer and/or card punch at the VRBT from which the job
  was submitted. The batch user can wait for his output, or he can
  signoff and signon again later to receive it.

  To initiate  a NETRJS session, the user process must execute a
  standard ICP to a fixed socket at the server.  The result is to
  establish a full-duplex Telnet connection for the virtual remote
  operator console, allowing the VRBT to signon to RJS.  The virtual
  remote operator console can then be used to issue commands to NETRJS
  and to receive status, confirmation, and error messages from the






Braden                                                          [page 1]

RFC 740                                              RTB 42423 22 Nov 77
NETRJS Protocol



  server.  The most important remote operator commands are summarized
  in Appendix D.

  Different VRBT's are distinguished by 8-character terminal id's,
  which are assigned by the server site to individual batch users or
  user groups.

B.  Connections and Protocols

  The protocol uses up to five connections between the user and server
  processes.  The operator console uses a a full-duplex Telnet
  connection. The data transfer streams for the virtual card reader,
  printer, and punch each use a separate simplex connection under a
  data transfer protocol defined in Appendix A. This document will use
  the term "channel" for one of these simplex data transfer connections
  and will designate a connection "input" or "output" with reference to
  the server.

  A particular data transfer channel needs to be open only while it is
  in use, and different channels may be used sequentially or
  simultaneously. CCN's NETRJS server will support simultaneous
  operation of a virtual card reader, a virtual printer, and a virtual
  punch (in addition to the operator console) on the same VRBT process.
  The NETRJS protocol could easily be extended to any number of
  simultaneously-operating virtual card readers, printers, and punches.

  The NETRJS server takes a passive role in opening the data channels:
  the server only "listens" for an RFC from the user process. NETRJS is
  defined with an 8-bit byte size on all data channels.

  Some implementations of NETRJS user processes are daemons, operating
  as background processes to submit jobs from a list of user requests;
  other implementations are interactive processes executed directly
  under terminal control by remote users. In the latter case, the VRBT
  process generally multiplexes the user terminal between NETRJS, i.e.,
  acting as the remote operator console, and entering local commands to
  control the VRBT. Local VRBT commands allow selection of the files
  containing job streams to be sent to the server as well as files to
  receive job output from the server.  Other local commands would cause
  the VRBT to open data transfer channels to the NETRJS server and to
  close these channels to free buffer space or abort transmission.

  The user process has a choice of three ICP sockets, to select the
  character set of the VRBT -- ASCII-68, ASCII-63, or EBCDIC. The
  server will make the corresponding translation of the data in the
  card reader and printer channels. (In the CCN implementation of
  NETRJS, an EBCDIC VRBT will transmit and receive, without





Braden                                                          [page 2]

RFC 740                                              RTB 42423 22 Nov 77
NETRJS Protocol



  translation, "transparent" streams of 8-bit bytes, since CCN is an
  EBCDIC installation). The punch stream will always be transparent,
  outputting "binary decks"  of 80-byte records untranslated. The
  operator console connections always use Network ASCII, as defined by
  the Telnet protocol.

  The NETRJS protocol provides data compression, replacing repeated
  blanks or other characters by repeat counts.  However, when the
  terminal id is assigned, a particular network VRBT may be specified
  to use no data compression.  In this case, NETRJS will simply
  truncate trailing blanks and send records in a simple "op
  code-length-data" form, called "truncated format" (see Appendix A).

C.  Starting and Terminating a Session

  The remote user establishes a connection to the NETRJS server by
  executing an ICP to the contact socket 71 (decimal) for EBCDIC,
  socket 73 (decimal) for ASCII-68, or to socket 75 (decimal) for
  ASCII-63. A successful ICP results in a pair of connections which are
  in fact the NETRJS operator console connections. NETRJS will send a
  READY message over the operator output connection.

  The user (process) must now enter a valid NETRJS signon command
  ("SIGNON terminal-id") through the virtual remote operator console.
  RJS will normally acknowledge signon with a console message; however,
  if there is no available NETRJS server port, NETRJS will indicate
  refusal by closing both operator connections.  If the user fails to
  enter a valid signon within 3 minutes, NETRJS will close the operator
  connections. If the VRBT attempts to open data transfer channels
  before the signon command is accepted, the data transfer channels
  will be refused  with an error message to the VRBT operator console.

  Suppose that S is the even number sent in the ICP; then the NETRJS
  connections have sockets at the server with fixed relation to S, as
  shown in the following table:

  Channel                          Server Socket     User Socket
  -------                          -------------     -----------
  Remote Operator Console Input         S            U + 3 Telnet
  Remote Operator Console Output        S + 1        U + 2 Telnet
  Data Transfer - Card Reader #1        S + 2        any odd number
  Data Transfer - Printer #1            S + 3        any even number
  Data Transfer - Punch #1              S + 5        any even number

  Once the VRBT has issued a valid signon, it can open data transfer
  channels and initiate input and output operations as explained in the
  following sections.  To terminate the session, the VRBT may close all





Braden                                                          [page 3]

RFC 740                                              RTB 42423 22 Nov 77
NETRJS Protocol



  connections.  Alternatively, it may enter a SIGNOFF command through
  the virtual remote operator console.  Receiving a SIGNOFF, NETRJS
  will wait until the current job output streams are complete and then
  itself terminate the session by closing all connections.

D.  Input Operations

  A job stream for submission to the NETRJS server is a series of
  logical records, each of which is a card image of at most 80
  characters. The user can submit a "stack" of successive jobs through
  the card reader channel with no end-of-job indication between jobs;
  NETRJS is able to parse the JCL sufficiently to recognize the
  beginning of each job.

  To submit a batch job or stack of jobs for execution, the user
  process must first open the card reader channel by issuing an Init
  for foreign socket S+2 and the appropriate local socket. NETRJS,
  which is listening on socket S+2, will return an RTS command to open
  the channel. When the channel is open, the user can begin sending his
  job stream using the protocol defined in Apendix A.  For each job
  successfully spooled, NETRJS will send a confirming message to the
  remote operator console.

  At the end of the job stack, the user process must send an
  End-of-Data transaction to initiate processing of the last job.
  NETRJS will then close the channel (to avoid holding buffer space
  unnecessarily).  At any time during the session, the user process can
  re-open the card reader channel and transmit another job stack.  It
  can also terminate the session and signon later to get the output.

  If the user process leaves the channel open for 5 minutes without
  sending any bits, the server will abort (close) the channel. The user
  process can abort the card reader channel at any time by closing the
  channel;  NETRJS will then discard the last partially spooled job.
  If NETRJS finds an error (e.g., transaction sequence number error or
  a dropped bit), it will abort the channel by closing the channel
  prematurely, and also inform the user process that the job was
  discarded (thus solving the race condition between End-of-Data and
  aborting).  The user process should retransmit only those jobs in the
  stack that have not been completely spooled.

  If the user's process, NCP, or host, or the Network itself fails
  during input, RJS will discard the job being transmitted.  A message
  informing the user that this job was discarded will be generated and
  sent to him the next time he signs on.  On the other hand, those jobs
  whose receipt have been acknowledged on the operator's console will
  not be affected by the failure, but will be executed by the server.





Braden                                                          [page 4]

RFC 740                                              RTB 42423 22 Nov 77
NETRJS Protocol



E.  Output Operations

  The VRBT may wait to set up a virtual printer or punch and open its
  channel until a STATUS message from NETRJS indicates output is ready;
  or it may leave the output channel(s) open during the entire session,
  ready to receive output whenever it becomes available.  The VRBT can
  also control which one of several available jobs is to be returned by
  entering appropriate operator commands.

  To be prepared to receive printer (or punch) output from its jobs,
  the VRBT issues an Init for foreign socket S+3 or S+5 for printer or
  punch output, respectively. NETRJS is listening on these sockets and
  should immediately return an STR.  However, it is possible that
  because of a buffer shortage, NETRJS will refuse the connection by
  returning a CLS; in this case, try again later.

  When NETRJS has job output for a particular virtual terminal and a
  corresponding open output channel, it will send the output as a
  series of logical records using the protocol in Appendix A.  The
  first record will consist of the job name (8 characters) followed by
  a comma and then the ID string from the JOB card, if any.  In the
  printer stream, the first column of each record after the first will
  be an ASA carriage control character (see Appendix C). A virtual
  printer in NETRJS has 254 columns, exclusive of carriage control;
  NETRJS will send up to 255 characters of a logical record it finds in
  a SYSOUT data set.  If the user wishes to reject or fold records
  longer than some smaller record size, he can do so in his VRBT
  process.

  NETRJS will send an End-of-Data transaction and then close an output
  channel at the end of the output for each complete batch job; the
  remote site must then send a new RFC to start output for another job.
  This gives the remote site a chance to allocate a new file for each
  job without breaking the output within a job.

  If the batch user wants to cancel (or backspace or defer) the output
  of a particular job, he can enter appropriate NETRJS commands on the
  operator input channel (see Appendix D).

  If NETRJS encounters a permanent I/O error in reading the disk data
  set, it will notify the user via his console, skip forward to the
  next set of system messages or SYSOUT data set in the same job, and
  continue. If the user process stops accepting bits for 5 minutes, the
  server will abort the channel. In any case, the user will receive
  notification of termination of output data transfer for each job via
  a remote console message.






Braden                                                          [page 5]

RFC 740                                              RTB 42423 22 Nov 77
NETRJS Protocol



  If the user detects an error in the stream, he can issue a Backspace
  (BSP) command from his console to repeat the last "page" of output,
  or a Restart (RST) command to repeat from the last SYSOUT data set or
  the beginning of the job, or he can abort the channel by closing his
  socket.  If he aborts the channel, NETRJS will simulate a Backspace
  command, and when the user re-opens the channel the job will begin
  transmission again from an earlier point in the same data set.  This
  is true even if the user terminates the current session first and
  reopens the channnel in a later session; RJS saves the state of every
  incomplete output stream.  However, before re-opening the channel he
  can defer this job for later output, restart it at the beginning, or
  cancel its output (see Appendix D).  Note that aborting the channel
  is only effective if NETRJS has not yet sent the End-of-Data
  transaction.

  If the user's process, NCP, or host or the Network itself fails
  during an output operation, NETRJS will act as if the channel had
  been aborted and the user signed off. NETRJS will discard the output
  of a job only after receiving the RFNM from the last data transfer
  message (containing an End-of-Data).  In no case should a NETRJS user
  lose output from a batch job.































Braden                                                          [page 6]

RFC 740                                              RTB 42423 22 Nov 77
NETRJS Protocol



                              APPENDIX A

                   Data Transfer Protocol in NETRJS

  1.  Introduction

     The records in the data transfer channels (for virtual card
     reader, printer, and punch) are generally grouped into
     transactions preceded by headers.  The transaction header includes
     a sequence number and the length of the transaction.  Network byte
     size must be 8 bits in these data streams.

     A transaction is the unit of buffering within the server software,
     and is limited to 880 8-bit bytes. Transactions can be as short as
     one record; however, those sites which are concerned with
     efficiency should send transactions as close as possible to the
     880 byte limit.

     There is no necessary connection between physical message
     boundaries and transactions ("logical messages"); the NCP can
     break a transaction arbitrarily into physical messages. The CCN
     server starts each transaction at the beginning of a new physical
     message, but this is not a requirement of the protocol.

     Each logical record within a transaction begins with an "op code"
     byte which contains the channel identification, so its value is
     unique to each channel but constant within a channel.  This choice
     provides the receiver with a convenient way to verify
     bit-synchronization, and it also allows an extension in the future
     to true "multi-leaving" (i.e., multiplexing all channels within
     one connection in each direction).

     The only provisions for transmission error detection in the
     current NETRJS protocol are (1) the "op code" byte to verify bit
     synchronization and (2) the transaction sequence number. Under the
     NETRJS protocol, a data transfer error must abort the entire
     transmission; there is no provision for restart.















Braden                                                          [page 7]

RFC 740                                              RTB 42423 22 Nov 77
NETRJS Protocol



  2.  Meta-Notation

     The following description of the NETRJS data transfer protocol
     uses a formal notation derived from that proposed in RFC 31 by
     Bobrow and Sutherland. The notation consists of a series of
     productions for bit string variables. Each variable name which
     represents a fixed length field is followed by the length in bits
     (e.g., SEQNUMB(16)).  Numbers enclosed in quotes are decimal,
     unless qualified by a leading X meaning hex.  Since each hex digit
     is 4 bits, the length is not shown explicitly in hex numbers.  For
     example, '255'(8) and X'FF' both represent a string of 8 one bits.

     The meta-syntactic operators are:

        |     :alternative string

        [ ]   :optional string

        ( )   :grouping

        +     :catenation of bit strings

     The numerical value of a bit string (interpreted as an integer) is
     symbolized by a lower case identifier preceding the string
     expression and separated by a colon.  For example, in
     "i:FIELD(8)", i symbolizes the numeric value of the 8 bit string
     FIELD.

     Finally, we use Bobrow and Sutherland's symbolism for iteration of
     a sub-string:  (STRING-EXPRESSION = n); denotes n occurrences of
     STRING-EXPRESSION, implicitly catenated together.  Here any n
     greater or equal to 0 is assumed unless n is explicitly
     restricted.

  3.  Protocol Definition

     STREAM ::= (TRANSACTION = n) + [END-OF-DATA]

        That is, STREAM, the entire sequence of data on a particular
        open channel, is a sequence of n TRANSACTIONS followed by an
        END-OF-DATA marker (omitted if the sender aborts the channel).

     TRANSACTION ::= THEAD(72) + (RECORD = r) + ('0'(1) = f)

        That is, a transaction consists of a 72 bit header, r records,
        and f filler bits; it may not exceed 880*8 bits.






Braden                                                          [page 8]

RFC 740                                              RTB 42423 22 Nov 77
NETRJS Protocol



     THEAD ::= X'FF'+f:FILLER(8)+SEQNUMB(16)+LENGTH(32)+X'00'

        Transactions are to be consecutively numbered in the SEQNUMB
        field, starting with 0 in the first transaction after the
        channel is (re-) opened.  The 32 bit LENGTH field gives the
        total length in bits of the r RECORD's which follow.  For
        convenience, the using site may add f additional filler bits at
        the end of the transaction to reach a convenient word boundary
        on his machine; the value f is transmitted in the FILLER field
        of THEAD.

     RECORD ::= COMPRESSED | TRUNCATED

        RJS will accept intermixed RECORD's which are COMPRESSED or
        TRUNCATED in an input stream.  RJS will send one or the other
        format in the printer and punch streams to a given VRBT; the
        choice is determined for each terminal id.

     COMPRESSED ::= '2'(2) + DEVID(6) + (STRING = p) + '0'(8)

     STRING     ::= ('6'(3) + i:DUPCOUNT(5))  |

        This form represents a string of i consecutive blanks

                    ('7'(3) + i:DUPCOUNT(5) + TEXTBYTE(8)) |

        This form represents string of i consecutive duplicates of
        TEXTBYTE.

                    ('2'(2) + j:LENGTH(6) + (TEXTBYTE(8) = j))

        This form represents a string of j characters.

     TRUNCATED  ::= '3'(2) + DEVID(6) + n:COUNT(8) + (TEXTBYTE(8)=n)

     DEVID(6)   ::= DEVNO(3) + t:DEVTYPE(3)

        DEVID identifies a particular virtual device, i.e., it
        identifies a channel.  DEVTYPE specifies the type of device, as
        follows:

           t = 1:  Output to remote operator console
               2:  Input from remote operator console
               3:  Input from card reader
               4:  Output to printer
               5:  Output to card punch
             6,7:  Unused





Braden                                                          [page 9]

RFC 740                                              RTB 42423 22 Nov 77
NETRJS Protocol



        DEVNO identifies the particular device of type t at this remote
        site; at present only DEVNO = 0 is possible.

     END-OF-DATA ::=X'FE'

        Signals end of job (output) or job stack (input).














































Braden                                                         [page 10]

RFC 740                                              RTB 42423 22 Nov 77
NETRJS Protocol



                              APPENDIX B

                   Telnet for VRBT Operator Console

  The remote operator console connections use the ASCII Telnet
  protocol. Specifically:

     1.  The following one-to-one character mappings are used for the
     three EBCDIC graphics not in ASCII:

        ASCII in Telnet     |  NETRJS
        ----------------------------------------------------
        broken vertical bar |  solid vertical bar
        tilde               |  not sign
        back slash          |  cent sign

     2.  Telnet controls are ignored.

     3.  An operator console input line which exceeds 133 characters
     (exclusive of CR LF) is truncated by NETRJS.

     4.  NETRJS accepts BS (Control-H) to delete a character and CAN
     (Control-X) to delete the current line.  The sequence CR LF
     terminates each input and output line.  HT (Control-I) is
     translated to a single space. An ETX (Control-C) terminates
     (aborts) the session.  All other ASCII control characters are
     ignored.

     5.  NETRJS translates the six ASCII graphics with no equivalent in
     EBCDIC into the character question mark ("?") on input.






















Braden                                                         [page 11]

RFC 740                                              RTB 42423 22 Nov 77
NETRJS Protocol



                              APPENDIX C

                           Carriage Control

  The carriage control characters sent in a printer channel by NETRJS
  conform to IBM's extended USASI code, defined by the following table:

     CODE       ACTION BEFORE WRITING RECORD
     ----       ----------------------------
     Blank      Space one line before printing
     0          Space two lines before printing
     -          Space three lines before printing
     +          Suppress space before printing
     1          Skip to channel 1
     2          Skip to channel 2
     3          Skip to channel 3
     4          Skip to channel 4
     5          Skip to channel 5
     6          Skip to channel 6
     7          Skip to channel 7
     8          Skip to channel 8
     9          Skip to channel 9
     A          Skip to channel 10
     B          Skip to channel 11
     C          Skip to channel 12



























Braden                                                         [page 12]

RFC 740                                              RTB 42423 22 Nov 77
NETRJS Protocol



                              APPENDIX D

                     Network/RJS Command Summary

  This section presents an overview of the RJS Operator Commands, for
  the complete form and parameter specifications please see references
  2 and 3.

  Terminal Control and Information Commands

     SIGNON       First command of a session; identifies VRBT by giving
                  its terminal id.

     SIGNOFF      Last command of a session; RJS waits for any data
                  transfer in progress to complete and then closes all
                  connections.

     STATUS       Outputs on the remote operator console a complete
                  list, or a summary, of all jobs in the system for
                  this VRBT, with an indication of their processing
                  status in the batch host.

     ALERT        Outputs on the remote operator console an "Alert"
                  message, if any, from the computer operator.  The
                  Alert message is also automatically sent when the
                  user does a SIGNON, or whenever the message changes.

     MSG          Sends a message to the computer operator or to any
                  other RJS terminal (real or virtual).  A message from
                  the computer operator or another RJS terminal will
                  automatically appear on the remote operator console.

  Job Control and Routing Commands

     Under CCN's job management system, the default destination for
     output is the input source.  Thus, a job submitted under a given
     VRBT will be returned to that VRBT (i.e., the same terminal id),
     unless the user's JCL overrides the default destination.

     RJS places print and punch output destined for a particular remote
     terminal into either an Active Queue or a Deferred Queue.  When
     the user opens his print or punch output channel, RJS immediately
     starts sending job output from the Active Queue, and continues
     until this queue is empty.  Job output in the Deferred Queue, on
     the other hand, must be called for by job name, (via a RESET
     command from the remote operator)  before RJS will send it.  The
     Active/Deferred choice for output from a job is determined by the





Braden                                                         [page 13]

RFC 740                                              RTB 42423 22 Nov 77
NETRJS Protocol



     deferral status of the VRBT when the job is entered; the deferral
     status, which is set to the Active option when the user signs on,
     may be changed by the SET command.

     SET           Allows the remote user to change certain properties
                   of his VRBT for the duration of the current session;

                   (a)  May change the default output destination to be
                   another (real or virtual) RJS terminal or the
                   central facility.

                   (b)  May change the deferral status of the VRBT.

     DEFER         Moves the print and punch output for a specified job
                   or set of jobs from the Active Queue to the Deferred
                   Queue. If the job's output is in the process of
                   being transmitted over a channel, RJS aborts the
                   channel and saves the current output location before
                   moving the job to the Deferred Queue.  A subsequent
                   RESET command will return it to the Active Queue
                   with an implied Backspace (BSP).

     RESET         Moves specified job(s) from Deferred to Active Queue
                   so they may be sent to user.  A specific list of job
                   names or all jobs can be moved with one RESET
                   command.

     ROUTE         Re-routes output of specified jobs (or all jobs)
                   waiting in the Active and Deferred Queues for the
                   VRBT.  The new destination may be any other RJS
                   terminal or the central facility.

     ABORT         Cancels a job which was successfully submitted and
                   awaiting execution or is currently executing.

  Output Stream Control Commands

     BSP (BACKSPACE)  "Backspaces" output stream within current sysout
                   data set.  Actual amount backspaced depends upon
                   sysout blocking but is roughly equivalent to a page
                   on the line printer.

     CAN (CANCEL)  (a)  On an output channel, CAN causes the rest of
                   the output in the sysout data set currently being
                   transmitted to be omitted. Alternatively, may omit
                   the rest of the sysout data sets for the job
                   currently being transmitted; however, the remaining





Braden                                                         [page 14]

RFC 740                                              RTB 42423 22 Nov 77
NETRJS Protocol



                   system and accounting messages will be sent.

                   (b)  On an input channel, CAN causes RJS to ignore
                   the job currently being read.  However, the channel
                   is not aborted as a result, and RJS will continue
                   reading in jobs on the channel.

                   (c)  CAN can delete all sysout data sets for
                   specified job(s) waiting in Active or Deferred
                   Queue.

     RST (RESTART) (a)  Restarts a specified output stream at the
                   beginning of the current sysout data set or,
                   optionally, at the beginning of the job.

                   (b)  Marks as restarted specified job(s) whose
                   transmission was earlier interrupted by system
                   failure or user action (e.g., DEFER command or
                   aborting the channel).  When RJS transmits these
                   jobs again it will start at the beginning of the
                   partially transmitted sysout data set or,
                   optionally, at the beginning of the job. This
                   function may be applied to jobs in either the Active
                   or the Deferred Queue; however, if the job was in
                   the Deferred Queue then RST also moves it to the
                   Active Queue.  If the job was never transmitted, RST
                   has no effect other than this queue movement.

     REPEAT        Sends additional copies of the output of specified
                   jobs.

     EAM           Echoes the card reader stream back in the printer
                   and/or punch stream.



















Braden                                                         [page 15]

RFC 740                                              RTB 42423 22 Nov 77
NETRJS Protocol



                              APPENDIX E

                       NETRJS TERMINAL OPTIONS

  When a new NETRJS virtual terminal is defined, certain options are
  available; these options are listed below.

     1. Truncated/Compressed Data Format

        A VRBT may use either the truncated data format (default) or
        the compressed format for printer and punch output.  See
        Reference 9 for discussion of the virtues of compression.

     2. Automatic Coldstart Job Resubmission

        If "R" (Restart) is specified in the accounting field on the
        JOB card and if this option is chosen, RJS will automatically
        resubmit the job from the beginning if the server operating
        system should be "coldstarted" before all output from the job
        is returned.  Otherwise, the job will be lost and must be
        resubmitted from the remote terminal in case of a coldstart.

     3. Automatic Output RESTART

        With this option, transmission of printer output which is
        interrupted by a broken connection always starts over at the
        beginning.  Without this option, the output is backspaced
        approximately one page when restarted, unless the user forces
        the output to start over from the beginning with a RESTART
        command when the printer channel is re-opened and before
        printing begins.

     4. Password Protection

        This option allows a password to be supplied when a terminal is
        signed on, preventing unauthorized use of the terminal ID.

     5. Suppression of Punch Separator and Large Letters.

        This option suppresses both separator cards which RJS normally
        puts in front of each punched output deck, and separator pages
        on printed output containing the job name in large block
        letters.  These separators are an operational aid when the
        ouptut is directed to a real printer or punch, but generally
        undesirable for an ARPA user who is saving the output in a file
        for on-line examination.






Braden                                                         [page 16]

RFC 740                                              RTB 42423 22 Nov 77
NETRJS Protocol



                              APPENDIX F

                 Character Translation by CCN Server

  A VRBT declares its character set for job input and output by the
  initial connection socket it chooses. A VRBT can have the ASCII-68,
  the ASCII-63, or the EBCDIC character set.  The ASCII-63 character
  mapping was added to NETRJS at the request of users whose terminals
  are equipped with keyboards like those found on the model 33
  Teletype.

  Since CCN operates an EBCDIC machine, its NETRJS server translates
  ASCII input to EBCDIC and translates printer output back to ASCII.
  The details of this translation are described in the following.

  For ASCII-68, the following rules are used:

     1.  There is one-to-one mapping between the three ASCII characters
         broken vertical bar, tilde, and back slash, which are not in
         EBCDIC, and the three EBCDIC characters vertical bar, not
         sign, and cent sign (respectively), which are not in ASCII.

     2.  The other six ASCII graphics not in EBCDIC are translated on
         input to unused EBCDIC codes, shown in the table below.

     3.  The ASCII control DC4 is mapped to and from the EBCDIC control
         TM.

     4.  The other EBCDIC characters not in ASCII are mapped in the
         printer stream into the ASCII question mark.

  For ASCII-63, the same rules are used except that the ASCII-63 codes
  X'60' and X'7B' - X'7E' are mapped as in the following table.

     EBCDIC              | ASCII-68 VRBT       | ASCII-63 VRBT
     ---------------------------------------------------------------
     vertical bar  X'4F' | vertical bar  X'7C' | open bracket  X'5B'
     not sign      X'5F' | tilde         X'7E' | close bracket X'5D'
     cent sign     X'4A' | back slash    X'5C' | back slash    X'5C'
     underscore    X'6D' | underscore    X'5F' | left arrow    X'5F'
     .             X'71' | up arrow      X'5E' | up arrow      X'5E'
     open bracket  X'AD' | open bracket  X'5B' | .             X'7C'
     close bracket X'BD' | close bracket X'5D' | .             X'7E'
     .             X'8B' | open brace    X'7B' | .             X'7B'
     .             X'9B' | close brace   X'7D' | .             X'7D'
     .             X'79' | accent        X'60' | .             X'60'






Braden                                                         [page 17]

RFC 740                                              RTB 42423 22 Nov 77
NETRJS Protocol



                              APPENDIX G

                              REFERENCES

  1. "Interim NETRJS Specifications", R. T. Braden.  RFC #189:  NIC
  #7133, July 15, 1971.

     This was the basic system programmer's definition document.  The
     proposed changes mentioned on the first page of RFC #189 were
     never implemented, since the DTP then in vogue became obsolete.

  2. "NETRJS Remote Operator Commands", R. T. Braden.  NIC #7182,
  August 9, 1971

     This document together with References 3 and 8 define the remote
     operator (i.e. user) command language for NETRJS, and form the
     basic user documentation for NETRJS at CCN.

  3. "Implementation of a Remote Job Service", V. Martin and T. W.
  Springer.  NIC #7183, July, 1971.

  4. "Remote Job Entry to CCN via UCLA Sigma 7; A scenario", UCLA/CCN.
  NIC #7748, November 15, 1971.

     This document described the first NETRJS user implementation
     available on a server host.  This program is no longer of general
     interest.

  5. "Using Network Remote Job Entry", E. F. Harslem.  RFC #307:  NIC
  #9258, February 24, 1972.

     This document is out of date, but describes generally the Tenex
     NETRJS user process "RJS".

  6. "EBCDIC/ASCII Mapping for Network RJS", R. T. Braden.  RFC #338:
  NIC #9931, May 17, 1972.

     The ASCII-63 mapping described here is no longer correct, but
     CCN's standard ASCII-68/EBCDIC mapping is described correctly.
     This information is accurately described in Appendix F of the
     current document.











Braden                                                         [page 18]

RFC 740                                              RTB 42423 22 Nov 77
NETRJS Protocol



  7. "NETRJT--Remote Job Service Protocol for TIP's", R. T. Braden. RFC
  #283: NIC 38165, December 20, 1971.

     This was an attempt to define an rje protocol to handle TIPs.
     Although NETRJT was never implemented, many of its features are
     incorporated in the current Network standard RJE protocol.

  8. "CCN NETRJS Server Messages to Remote User", R. T. Braden.  NIC
  #20268, November 26, 1973.

  9. "FTP Data Compression", R. T. Braden.  RFC #468:  NIC #14742,
  March 8, 1973.

  10. "Update on NETRJS", R. T. Braden.  RFC #599: NIC #20854, December
  13, 1973.

     This updated reference 1, the current document combines the two.

  11. "Network Remote Job Entry -- NETRJS", G. Hicks.  RFC #325: NIC
  9632, April 6, 1972.

  12. "CCNRJS: Remote Job Entry between Tenex and UCLA-CCN", D.
  Crocker.  NUTS Note 22, [ISI]<DOCUMENTATION>CCNRJS.DOC, March 5,
  1975.

  13. "Remote Job Service at UCSB", M. Krilanovich.  RFC #477: NIC
  #14992, May 23, 1973.

























Braden                                                         [page 19]