Using TSO at CCN
Instructions for accessing UCLA CCN's IBM Time Sharing Option over the network.
Braden, R., "Using TSO at CCN", RFC 379, DOI 10.17487/RFC0379, August 1972, <https://www.rfc-editor.org/info/rfc379>.
@misc{rfc379,
series = {Request for Comments},
number = 379,
howpublished = {RFC 379},
publisher = {RFC Editor},
doi = {10.17487/RFC0379},
url = {https://www.rfc-editor.org/info/rfc379},
author = {R. Braden},
title = {{Using TSO at CCN}},
pagetotal = 5,
year = 1972,
month = aug,
} RFC text
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 ]
ISO Plain Language
On this page
§1TSO Access at CCN
UCLA's IBM Time Sharing Option (TSO) is available at CCN over the network using TELNET. The RFC says it is stable and regularly scheduled, but not yet considered production because restrictions and problems remain.
Users need a valid CCN charge number and a TSO user ID. At the time of the notice, TSO use itself was not charged, though batch jobs submitted from TSO were charged to the user's account.
Users can reach TSO at UCLA through TELNET. The system was usable but still had restrictions and glitches to resolve.
§2Two Ways to Use TSO
Conversational Remote Job Entry lets a user prepare an OS job stream with EDIT, submit it to batch, check its status and examine output in EDIT. The RFC says TIP users can submit batch jobs this way without using NETRJS through a TENEX machine.
Foreground execution runs some OS/360 programs from the terminal. Its foreground region is limited to 128K, referenced data sets must be on resident disk packs, and execution may be slow because the system time-slices and swaps. The TEST command provides DDT-like debugging, and a user's own program can interact with the terminal.
Users can submit a batch job and return for its output, or run some programs from the terminal. Foreground programs have memory, storage and speed limits.
§3Files, Login and TELNET Limits
TSO places foreground-created data sets on resident disk packs and catalogs them so users can refer to them by name. At CCN, names use the charge number and user ID as their highest levels. Users can read, write or execute data sets under their charge number, and can rename or remove them.
The RFC says programs could not yet open direct network connections. It refers users to RFC 377 for TELNET access and lists features not then available, including full duplex, lowercase input, special-character translation and optional line-ending choices.
TSO organizes files by charge number and user ID. The TELNET connection still lacked several features described as planned for a later version.