RFC377

NETWORK WORKING GROUP R.T. BRADEN REQUEST FOR COMMENTS #377 UCLA/CCN NIC 11119 AUGUST 10, 1972 CATEGORIES: OBSOLETES: UPDATES:

          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 ]