NETWORK WORKING GROUP                                     R.T. BRADEN
REQUEST FOR COMMENTS #379                                 UCLA/CCN
NIC 11121                                                 AUGUST 11, 1972
CATEGORIES :
OBSOLETES:
UPDATES:


                            USING TSO AT CCN
	
    IBM's Time Sharing Option ("TSO") is now available at CCN for use via
the Network with Telnet Protocol.  TSO is not yet considered "production"
by CCN, since there are a number of restrictions and glitches to be removed
or documented.  However, TSO is now quite stable and is up on a regularly
scheduled basis; the system will allow an experienced programmer to work
productively at CCN.  To use TSO, you will need a valid CCN charge (billing)
number, and a user-id.  To obtain a charge number (if you do not already
have one), or to obtain a TSO user-id, contact Barbara Noble at (213)
825-7438 or (213) 825-7452.  At present we are not charging for TSO use
(although any batch jobs submitted from TSO will be charged to your account).
Barbara can assign on overhead charge number for experimental use of TSO if
you do not have a paid account.

Modes of TSO Use
----------------

    (1)  Conversational Remote Job Entry
         -------------------------------

         Using TSO you can prepare an OS job stream using the TSO EDIT command,
         SUBMIT the job to batch execution, monitor its STATUS, and ship the
         OUTPUT back to EDIT for examination.  This allows those of you with
         TIP'S to process jobs at CCN without using NETRJS via a friendly
         TENEX machine.  Any batch job can be submitted this way.


    (2)  Foreground Execution
         --------------------

         Many OS/360 programs can be run, with varying degrees of inconvenience,
         directly from the terminal.  There are TSO commands providing the
         facilities of EXEC and DD cards; the output stream can be directed to
         the user's terminal.  There are some important limitations to fore-
         ground operation, however:

              (1)  The foreground region size is limited; at present, it is
                   128K, though this will be expanded.

              (2)  All datasets referenced must be on resident disk packs;
                   no disks or tapes can be mounted.

              (3)  Since you are time-sliced and swapped, it can be very
                   slow.

    There are two important cases of foreground execution:

         (A)  The TEST command provides DDT-like debugging capability
              for foreground programs.

         (B)  The user's own program can interact with his terminal.

NOTE:  It is not yet possible for a program, either in batch or foreground,
       to open direct Network connections.

Hours of Operation
------------------

     Monday through Friday, 6 A.M. - Noon PDT (or 9 A.M. - 3 P.M. EDT).
     These hours will be extended before September 1, 1972.

Telnet Protocol
---------------

     The document "USING TSO VIA ARPA NETWORK VIRTUAL TERMINAL", RFC #377
     describes the use of a Telnet NVT to access TSO.  There are some signi-
     ficant differences from using a real 2741 locally.  RFC #377 describes
     the current server Telnet, complete with an annoying bug.  A later
     version will include the following capabilities not presently available:

          (a)  "FULL DUPLEX", i.e., CCN echoing.

          (b)  Lower case input.

          (c)  The special character translation included in NETRJS
               users with Model 33 Teletypes. (see RFC #338).

          (d)  Optional specification of single CR or single LF as end-of-line
               indication

          (e)  Hopefully, the input attention bug described in RFC #377 will
               be fixed.

Disk Space
----------

     TSO will automatically place datasets created in the foreground (e.g., by
     EDIT or ALLOC) on the proper resident disk pack.  All TSO datasets are
     cataloged, and can be referenced by name alone (no volume or unit specifi-
     cation is necessary).  For most purposes, you can pretend we have one big
     disk.                                                             --- ---
     ----

Dataset Names
-------------

     The standard IBM version of TSO uses the TSO user-id as the highest
     index of each dataset name.  At CCN, the _two_ highest levels are the
     charge number and the user-id of the person who created the dataset.
     TSO has been modified accordingly.

Dataset Access Control
----------------------

     In general, under TSO a user can access for reading, writing, or
     execution any dataset named with the charge number with which he is
     logged on.  In addition, he can rename or scratch any dataset with the
     logon charge number.  There is no provision for public or read-only
     datasets a present.

Logging On
----------

     Most Network users will need only the simple form of LOGON:

                   logon     <user-id>

     EXAMPLE:                         NOTES:
     -------                          -----

          user:  logon uid            (Use your user-id)

          TSO:   LOGON UID            (TSO repeats line for reasons of its own)

          TSO:  ENTER PASSWORD        (TSO asks for password)

          user:  xyz

          TSO:  UID LOGON IN PROGRESS AT 11:37:43 ON AUGUST 9, 1984

          TSO:  LOGON PROCEEDING      (It may take a while.  This message will
                                      come every 30 seconds.)

          TSO:  WELCOME TO TSO.  GOOD LUCK

          TSO:  READY

     User-id's are created in TSO with a blank password.  To add or change your
     password, use the CHANGE command.  If you have TSO access under more than
     one charge number, LOGON will prompt you for the charge number to be used
     for the session.

Where to Get Help
-----------------

    1.  To obtain a list of TSO commands enter:  "help commands"

    2.  To get detailed information on syntax and function of a particular
        command, enter: "help <command name> <qualifiers>"
        Type "help help" for details.

    3.  The SEND command may be useful for on-line help from PCN (Pete Nielsen)
        or WDD (Bill Drain), when they are signed on.  You can find out if PCN
        or WDD is on by sending them a trial message.

        EXAMPLE:
        -------

               User:  send 'hello' user(wdd)

               TSO:   USER WDD NOT LOGGED ON

               TSO:   READY

               user:  send 'hello' user(pcn)

               TSO:   READY

               user:  send 'edit is acting funny' user(pcn)

               TSO:   READY

        Here "PCN" was logged on and got your message.  You can, therefore,
        converse with him through SEND.  The text in one SEND is limited to
        115 characters.

    4.  You can also leave a message for wdd to receive when he logs on by
        typing:  send '<message>' user(wdd) logon.

    5.  To send a message to the CCN operator, enter simply:  send '<message>'

    6.  You can call the CCN Telephone Consultant at (213) 825-7452, Monday
        through Friday during the hours 10-12 A.M. PDT and 1-4 P.M. (except
        3-4 P.M. on Thursday).  If the consultant does not know the answer,
        he/she will investigate and call you back.

    7.  You can call the general contact for Network user problems, Barbara
        Noble, at (213) 825-7438.  Barbara is also one of the Telephone
        consultants.

    8.  If all else fails, call Bill Drain, the CCN Systems Programmer in
        charge of TSO installation.  His telephone is (213) 825-7474 (if no
        answer, call my secretary at (213) 825-7518 and leave a message for
        Bill).

    9.  You can also send a message to someone at CCN by submitting the
        following pseudo-job through RJS at TSO:

                   //<charge number>  JOB 'BIN=9906',MSGLASS=C
                   //*  <message>
                   //*
                   //*
                   //*
                   //*
                   etc.



       [ This RFC was put into machine readable form for entry ]
       [ into the online RFC archives by BBN Corp. under the   ]
       [ direction of Alex McKenzie.                      1/97 ]