CCN NETRJS server messages to remote user
A reference for error messages from the CCN remote job entry service
Braden, R.T., "CCN NETRJS server messages to remote user", RFC 589, DOI 10.17487/RFC0589, November 1973, <https://www.rfc-editor.org/info/rfc589>.
@misc{rfc589,
series = {Request for Comments},
number = 589,
howpublished = {RFC 589},
publisher = {RFC Editor},
doi = {10.17487/RFC0589},
url = {https://www.rfc-editor.org/info/rfc589},
author = {R.T. Braden},
title = {{CCN NETRJS server messages to remote user}},
pagetotal = 5,
year = 1973,
month = nov,
} RFC text
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
§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.