RFC 589 UNKNOWN APPLICATIONS · REFERENCE

CCN NETRJS server messages to remote user

A reference for error messages from the CCN remote job entry service

On rfc-editor.org ↗
PUBLISHED
November 1973
AUTHORS
R.T. Braden
STREAM
Legacy
SERVER
CCN (UCLA Computer Communications Node)
PROTOCOL
NETRJS (remote job entry over ARPANET)
SIGNON TIMEOUT
3 minutes of inactivity
DATA TRANSFER TIMEOUT
5 minutes of inactivity
DOI
10.17487/RFC0589

RFC text

Original text · RFC Editor View on rfc-editor.org ↗
Received at NIC 14-DEC-73                               Robert T. Braden
RFC589                                                          UCLA/CCN
NIC #20268                                             November 26, 1973





                           CCN NETRJS SERVER
                        MESSAGES TO REMOTE USER





A.  _I_N_I_T_I_A_L _C_O_N_N_E_C_T_I_O_N, _S_I_G_N_O_N, _A_N_D _S_I_G_N_O_F_F

     1.   If CCN refuses an ICP to a NETRJS socket, it means either that
          there is no free core within the NCP region, or that CCN's
          software is crashing.

     2.   Once ICP is completed, CCN might send the user one of the fol-
          lowing messages and close the Telnet connections:

          NRJ110I NETRJS PORTS BUSY.  TRY LATER

               This may be expected occasionally; frequent occurrance
               should be reported to CCN User Relations (825-7548), or
               to BELL@CCN.

          NRJ111I RJS NOT UP, TRY LATER

     3.   Normally, however, the user will receive a READY message:

               NRJ876R CCN NETRJS READY.  ENTER SIGNON

          If the user sends no operator input for 3 minutes, CCN will
          send:

               NRJ308R SIGNON TIMEOUT EXCEEDED

               NRJ205R NETRJS SESSION TERMINATED

          and close the Telnet connection.  If he sends an invalid SIG-
          NON command, he will receive the message:

               NRJ307R INVALID SIGNON, RE-ENTER

NIC #20268
                                                                     P.2


7          Finally, a valid signon will be acknowledged by RJS with the
          message:

               RJS750I TERMINAL -termid- HAS SIGNED ONTO RJS

     4.   If the user terminates the session by entering a SIGNOFF com-
          mand, NETRJS will wait until all data transfer has completed
          before sending the message:

               NRJ205R NETRJS SESSION TERMINATED

          and closing the Telnet connection.


B.  _R_E_M_O_T_E _S_I_T_E _O_R _N_E_T_W_O_R_K _F_A_I_L_U_R_E_S


     1.   During data transfer, the user must be reasonably responsive.
          If not, CCN will close the data transfer connection and send
          the remote operator message:

               NRJ504I DATA TRANSFER TIMEOUT FOR THE -device-, -termid-


                    a)   if -device- is PRINTER or PUNCH, user site
                         stopped accepting bits (sending "allocates")
                         for over 5 minutes.

                    b)   if -device- is READER, user site left reader
                         connection open without sending any bits for 5
                         minutes.

     2.   During data transfer on the CR connection, CCN may detect an
          incorrect header or record, presumably due to user site
          software or Network transmission error.  The following mes-
          sages beginning with the word "BAD" will follow an NRJ512I
          message containing the faulty header in hex:

               NRJ505I BAD HEADER SEQUENCE FOR NETRJS READER

                    Sequence number in transaction header does not match
                    internal counter of records passed.

               NRJ506I BAD HEADER LENGTH FOR NETRJS READER

                    Length given in header exceeds 880 bytes.

NIC #20268
                                                                     P.3


7               NRJ507I BAD HEADER TYPE FOR NETRJS READER

                    Type code in header is not X'FF' (data) or X'FE'
                    (end-of-data)

               NRJ511I BAD FILL BIT COUNT FOR NETRJS READER

                    The filler bit count in header is not a multiple of
                    8.

     3.   If the header is correct but a data record is faulty, the fol-
          lowing message will be sent to a remote user:

               NRJ602I line STREAM ERROR - READER, -code-

                    A protocol error was detected in the READER stream.
                    CCN will close the stream and ready it to be reo-
                    pened so the remote user may retry the data transfer
                    operation.  The valid -code- values are:

     _C_O_D_E            _E_R_R_O_R

       1             Device id byte has high bit off.

       2             End of transaction in the middle of a data line.

       3             Truncated input line longer than 255 bytes.

       4             In compressed text, string control byte has high
                     bit off.

       5             In compressed text, duplicate blank string extends
                     line longer than 255 bytes.

       6             In compressed text, duplicate character string
                     extends line longer than 255 bytes.

       7             In compressed text, character string extends line
                     longer than 255 bytes.


     4.   Finally, if the user aborts his data transfer, he receives the
          message:

               NRJ502I NETRJS -device- DATA TRANSFER ABORTED BY USER
               -termid-.

NIC #20268
                                                                     P.4


7C.  _C_C_N _F_A_I_L_U_R_E_S


     1.   The CCN operator can cancel a NETRJS session, aborting any
          open data transfer streams and sending the message:

               NRJ204I NETRJS SESSION ABORTED BY CENTRAL OPERATOR, TERM=
               -termid-

     2.   Any of the following messages indicate a serious CCN Network
          software problem, and will cause the session to be aborted:

               NRJ106A NETRJS DEAD - EXCHANGE INOPERATIVE

               NRJ201A NETRJS DT SOCKET ERROR - BAD LISTEN

               NRJ208A NETRJS PROGRAM CHECK IN -device-, code=ccc

               NRJ209A NETRJS LOAD FAILED FOR -device-, code=xx

               NRJ304I RJS LINE HANDLER DEAD

               NRJ401I RJS LINE HANDLER DEAD

               NRJ402I RJS LINE HANDLER DEAD

          Any of these should be reported to CCN.

     3.   Besides global catastrophes like these above, the user might
          encounter a failure of a particular data transfer process.
          These do not terminate the session, only cause the data con-
          nection to be refused or terminated; the user can try again to
          open the data connection.  Repeated failure should be reported
          to CCN.

               NRJ501I NO CORE FOR DATA TRANSFER BUFFER -device-

               NRJ503I NO CORE FOR DATA TRANSFER WORKAREA -device-

               NRJ207I NO CORE FOR-device-DATA TRANSFER MODULE

                    Due to core memory limitations in CCN's NCP,
                    -device- cannot be started now.  The data transfer
                    connection indicated by -device- will be refused.
                    This may happen occasionally during active periods,
                    but repeated occurrences should be reported to CCN.

NIC #20268
                                                                     P.5


7               NRJ509I -device- DATA TRANSFER DEAD

               NRJ510I -device- DATA TRANSFER DEAD

               NRJ602I line STREAM ERROR - PRINTER, -code-

               NRJ602I line STREAM ERROR - PUNCH, -code-

                    CCN data transfer failed, but recovery may be possi-
                    ble.  User may try again.


            [ This RFC was put into machine readable form for entry ]
            [ into the online RFC archives by Tony Hansen 10/98     ]

AI ELI5

On this page
PROBLEMWhen users submitted jobs remotely to the CCN (UCLA's Computer Communications Node) via the NETRJS protocol, they received error and status messages but had no reference for what the message codes meant.
MECHANISMRFC 589 documents every message the CCN NETRJS server sends to remote users, organised by category: initial connection and sign-on, remote site or network failures, and CCN software failures. Each message is shown with its code and a plain-language explanation.
THE REFERENCEUsers and system administrators had a complete reference for interpreting NETRJS messages and diagnosing connection, data transfer and software problems.

§1NETRJS Server Messages

NETRJS is the protocol for submitting batch jobs to a remote computer over ARPANET. When a user connects to the CCN (UCLA's Computer Communications Node) and submits a job for remote execution, the server sends back messages about the outcome. This RFC catalogs all the messages the CCN NETRJS server sends to remote users.

The messages are organized into three categories: those during initial connection, sign-on and sign-off; those indicating remote site or network failures during data transfer; and those indicating problems with the CCN software itself.

NETRJS is a way to send jobs to a distant computer. This RFC lists all the reply messages it can send and what they mean.

§2Connection and Session Messages

When a user initiates the ICP (Initial Connection Protocol) to a NETRJS socket, the CCN might refuse the connection if there is no free core memory in the NCP region or if CCN's software is crashing. If the connection succeeds, the server sends a READY message (NRJ876R CCN NETRJS READY. ENTER SIGNON). If the user sends no input for 3 minutes, the session times out with messages NRJ308R SIGNON TIMEOUT EXCEEDED and NRJ205R NETRJS SESSION TERMINATED. An invalid signon receives NRJ307R INVALID SIGNON, RE-ENTER. A successful signon is acknowledged by RJS750I TERMINAL -termid- HAS SIGNED ONTO RJS. When the user ends the session with a SIGNOFF command, the server waits for data transfer to complete and sends NRJ205R NETRJS SESSION TERMINATED before closing the connection.

When you log in, the server says 'ready'. If you don't respond in 3 minutes, it gives up. Once you log in successfully, you get a welcome message.

§3Data Transfer and Network Failures

During file transfer, if the remote user is too slow to respond, CCN closes the connection after 5 minutes with code NRJ504I DATA TRANSFER TIMEOUT. The code indicates whether the timeout was on a READER (incoming data), PRINTER or PUNCH (outgoing data) stream. If data is corrupted due to transmission errors or local software bugs, messages like NRJ505I BAD HEADER SEQUENCE FOR NETRJS READER, NRJ506I BAD HEADER LENGTH, or NRJ507I BAD HEADER TYPE are sent. For individual corrupted data records (header correct but data bad), the server sends NRJ602I line STREAM ERROR - READER, -code- with codes 1-7 indicating specific problems such as truncated input or string overflow. If the user intentionally aborts, the message is NRJ502I NETRJS -device- DATA TRANSFER ABORTED BY USER -termid-.

If the file transfer is too slow, the server waits 5 minutes then gives up. If the data gets scrambled, you get an error code saying what's wrong.

§4CCN Software Failures

Several classes of messages indicate serious problems with CCN's network software. The CCN operator can cancel a session entirely with NRJ204I NETRJS SESSION ABORTED BY CENTRAL OPERATOR, TERM=-termid-. Catastrophic software failures include NRJ106A NETRJS DEAD - EXCHANGE INOPERATIVE, NRJ201A NETRJS DT SOCKET ERROR - BAD LISTEN, NRJ208A NETRJS PROGRAM CHECK IN -device-, code=ccc, and several others. These messages all cause the session to abort immediately and should be reported to CCN. Additionally, a user might encounter a data transfer process failure that does not terminate the entire session, only the current data connection—messages like NRJ501I NO CORE FOR DATA TRANSFER BUFFER -device- or NRJ509I -device- DATA TRANSFER DEAD. These problems may be transient and can be retried, but repeated failures should be reported.

Sometimes the CCN computer itself has serious problems. An operator can shut down your session. Or the file transfer process can crash but the connection survives.