USING TSO VIA ARPA NETWORK VIRTUAL TERMINAL

A. Connecting to TSO

-----------------

IBM's Time Sharing Option (TSO) is available at UCLA-CCN on Socket 1 using the standard Telnet protocol.

1. To access TSO, the remote user performs ICP to Socket 1 at CCN and executes the command:

TSO CR LF

                        -- --

2. Possible responses to the TSO command are:

a. "WELCOME TO UCLA/CCN TSO"

            followed by a herald ("!").  TSO is available.   A TSO LOGON
            command should be entered following the herald.

b. "TSO NOT AVAILABLE AT THIS TIME"

The user should check the TSO schedule and verify that it should be available. If so, he can call the CCN on-line help phone, 213-825-1652 for availability information, or send a message to the operator through NETRJS.

c. "ALL TSO PORTS BUSY"

The user should try again after a short time. If this condition recurs frequently, notify the Technical Liaison at CCN so that more Network ports can be added.

3. When first connected to CCN server Telnet, the user has a choice of several commands besides "TSO". The TSO-related commands are:

            HELP    -  A listing of commands at this level, and other
                       general information.
            
            BBOARD  -  List operational notices.

4. Local echoing (i.e., by the user site) is required.

5. Server-Telnet will time-out and disconnect the user if:

a. Output to the Network does not complete within 5 minutes, or

b. An INS, DATA MARK pair does not match within 2 minutes, or

c. TSO waits for the user to enter input for 20 minutes.

B. Conversing with TSO

-------------------

    1.  TSO is strictly a line-at-a-time system.  Input is not scanned
    
        until either an end-of-line or an INS (interrupt) is received at
        CCN.  TSO sends the user an exclamation mark ("!") as a herald
        when waiting for input.

2. The end-of-line indication for input and output lines is the standard CR LF sequence.

3. The remote user my interrupt TSO output by sending an INS and DATA MARK (Telnet X'80'). Note to TIP users: this may be accomplished with the TIP command "SEND SYNC". Each such interrupt is passed to TSO, which interprets it as an output break, i.e., as if the user pressed the ATTention key on his 2741 while the keyboard was _locked_.

On the Network, "attentions" are not used to delete lines being entered. The CCN Server-Telnet provides line editing functions for TSO users: the ASCII control CAN deletes the line being entered, while BS deletes the preceding character.

4. There is a third interrupt case to be considered: suppose a program has placed the user's terminal into input state, but the user wants to suspend its execution and take control up a level without satisfying the pending input request. This is supposed to be accomplished by sending an INS/DATA MARK pair. Unfortunately, due to a bug in our Network interface to TSO, the interrupt will be ignored in this case. To circumvent this problem, we recommend that you define a software break string, such as "!!!!". This may be accomplished with the command:

                    TERM INPUT (!!!!)

Note that there are no quotes around the string. You can enter this command when you first log on, and it will remain in effect for the session (or until you issue a new TERM command). Then any input line containing four successive exclamation points will be interpreted as if an interrupt (attention) had been sent. If that line contains other characters preceding the exclamation marks, the latter will be interpreted as line delete; otherwise, the result will be to take control up a level.

C. Character Sets

--------------

1. Both upper and lower case input are allowed, but the server Telnet will translate all lower case to upper. Output is normally upper case.

2. Line-editing is provided by the Server-Telnet program before passing the input line to TSO.

                INPUT                    ACTION
                -----                    ------
                
                CAN (control X)          delete current line.
                
                BS (control H)           delete previous character on
                                         same line

(NOTE: Telnet control char- acters are not deleted; they are bypassed in the backspace operation.)

                 HT (control I)          insert one space in input.

All other ASCII controls are deleted from the input before line-editing is performed.

3. Input lines are translated to EBCDIC by the rules used for a NETRJS remote operator console (see Appendix B in RFC189). Specifically:

a. ASCII controls are ignored except for BS, CAN, HT, and CR

LF.

b. The following correspondence is used for the EBCDIC graphics

not in ASCII:

[In the original, the ASCII and EBCDIC graphics were handwritten; in  ]
[this version the ASCII graphics are typed and the EBCDIC graphics are]
[omitted.]

ASCII TSO

----- ---

! (Vertical bar)

                      ~                    (EBCDIC "not")

\ (Cent)

c. The six ASCII graphics not in EBCDIC are translated into

EBCDIC question marks.

4. All Telnet controls except DATA MARK are ignored.

RTB/gjm

8/10/72

       [ This RFC was put into machine readable form for entry ]
       [ into the online RFC archives by Alex McKenzie with    ]
       [ support from GTE, formerly BBN Corp.             9/99 ]