Differences

This shows you the differences between two versions of the page.

--- tss-8_user_tutorial [2021/04/02 01:27] – Added markup for headings papa
+++ tss-8_user_tutorial [2023/07/01 06:01] (current) – [EDIT, the line editor] hc9
@@ Line 101: / Line 101: @@
 Detailed documentation for BASIC is available at [[http://bitsavers.org/pdf/dec/pdp8/tss8/DEC-T8-KJZA-D-TSS-8_BASIC_8_Programming_Manual_Mar1969.pdf]].
-ALGOL documentation can be found at [[http://svn.so-much-stuff.com/svn/trunk/pdp8/src/decus/8-213/decus-8-213.pdf ]] with [[http://www.bitsavers.org/pdf/dec/decus/pdp8/8-330_tss8_ALGOL.pdf ]] covering the TSS/8-specific changes.
+===== PUTR (Print/copy/delete/... files) =====
-LISP is documented at [[http://svn.so-much-stuff.com/svn/trunk/pdp8/src/decus/8-102a/decus-8-102A.pdf]]
+Files can be listed with the library program CAT, and other library programs (such as BASIC and EDIT) provide limited file manipulation functions. However, the library program ''PUTR'' ("**P**eripheral **U**tility **T**ransfer **R**outines") provides general file manipulation functions like printing file contents and copying and deleting files. (Similar functions are also provided by the older library programs COPY and PIP.)
-Logging in
+(In the following example, ''*'' is the PUTR command prompt, and text following the ''*'' is input by the user followed by the ''Enter'' key.)
-Login using the following command:
-LOGIN USERNAME PASSWORD
-The login command does not display or echo.
-We cover more on user management later on in the article, including how to create and modify users.
-To login as user 1, the system user enter this:
 <code>
-TSS/8.24  JOB 01  [01,10]  K00    12:12:36
+.R PUTR
-SYSTEM IS DOWN, INC.
+*DIR
-</code>
+BOTTLE.BAS   1  3/14/74
-Primitive ls, CAT (catalog)
+OCT .BAS   2  3/14/74
-TSS/8 Monitor maintains a library of disk files for each user. The System Library Program CAT is used to obtain a catalog of the contents of this library. For each file, CAT types the size of the File in units of disk segments. The size of a disk segment may vary among installations. Generally, it is 256 (decimal) words of disk storage. The protection code for the file is also given. (See the section on the PROTECT Monitor command (Chapter 9 of the manual) for a precise explanation of protection codes.) If the program was created by any of the System Library Programs, it has a protection code of l2, meaning that other users can read the File, but only the owner can change it.
+HOLA  .ASC   1  3/14/74
+.25,2.FCL   2  3/14/74
+COWGEN.FCL   2  3/14/74
+FIBCOW.BAS   1  3/14/74
+GUESS .BAS   1  3/15/74
+ADIEU .BAC   1  3/15/74
+TH    .BAS   1  3/15/74
+SCOUNT.ASC   2  3/18/74
+SXMPL .ASC   2  3/18/74
+SACTST.ASC   1  3/18/74
+COUNT .BIN   1  3/18/74
+EXAMPL.BIN   1  3/18/74
+SPOLY .ASC   3  3/18/74
+MISS  .BAS   1  3/18/74
+RPS   .BAS   4  3/18/74
+TMP   .ASC   1  3/18/74
+BAFFA2.      1  3/18/74
+BAFFA1.ASC   1  3/18/74
+ZMP   .ASC   1  3/18/74
+SPOLY2.ASC   3  3/18/74
+POLY2 .BIN   1  3/18/74
+SBLINK.ASC   1  3/18/74
+BAFFA3.ASC   1  3/19/74
+BAFFA4.ASC   1  3/19/74
+BAFFA5.ASC   2  3/19/74
+BBIN  .BIN   1  3/19/74
+BAFFA6.ASC   1  3/19/74
+RUL110.BAS   1  3/25/74
+ELCOTT.BAS   1  3/25/74
+HELLO .BAS   1  3/26/74
+EINTR .BAS   1  3/26/74
+ELCOT1.BAS   1  3/26/74
+AGE   .BAS   2  3/26/74
+PAPA  .ASC   1  3/26/74
-When the CAT program is used by the SYSTEM ADMINISTRATOR (user 1), it prints out accounting information. This report consists out of the accumulated time (in hours, minutes and seconds) for central processor usage and connect time as well as the number of disk segments currently being used.
+*COPY VERBUM.ASC=PAPA.ASC
+PAPA  .ASC
-To see the contents of a users library, run the .R CAT:L command. It will ask for an account number, after which it prints out the users directory. This way you can trace which user is using an abnormal amount of diskspace.
+*DEL PAPA.ASC
+PAPA  .ASC
-If you login as the user 2, you can execute the following command to see the contents of the disk:
+*TYPE VERBUM.ASC
-<code>
+VERBUM.ASC
-.R CAT
+IN PRINCIPIO ERAT VERBUM
-Output:
-DISK FILES FOR USER  0, 2 ON  1-JAN-75
-NAME      SIZE  PROT    DATE
+*E
-PALD  .SAV  16   12  31-MAR-76
+^BS
-LOADER.SAV   4   12  31-MAR-76
+.
-FORT  .SAV   6   12  31-MAR-76
-FOSL  .SAV   6   12  31-MAR-76
-PIP   .SAV  10   12  31-MAR-76
-TSTLPT.SAV   2   12  31-MAR-76
-LOGOUT.SAV   6   12  31-MAR-76
-SYSTAT.SAV   5   12  31-MAR-76
-EDIT  .SAV   8   12  31-MAR-76
-FOCAL .SAV  16   12  31-MAR-76
-BASIC .SAV  38   12  31-MAR-76
-COPY  .SAV  10   12  31-MAR-76
-CAT   .SAV   6   12  31-MAR-76
-GRIPE .SAV   5   12  31-MAR-76
-LOGID .SAV   4   12  31-MAR-76
-PUTR  .SAV  21   12   3-FEB-84
-ODTHI .SAV   2   12  29-FEB-84
-FLAP  .SAV   1   12   7-APR-84
-PTLOAD.SAV   1   12  29-APR-84
-BLANK .SAV   1   12   9-JUN-84
-DTTEST.SAV   2   12  26-JUN-84
-INIT  .SAV  17   12  29-JUL-84
-BAS000.TMP   1   17   1-JAN-84
-BAS100.TMP   1   17   1-JAN-84
-INTER .BAS   1   12   1-JAN-75
-REMY  .ASC   1   12   1-JAN-75
-TOTAL DISK SEGMENTS:  189    QUOTA: 1575
 </code>
-System Status
+**Notes**
-With the SYSTAT command you get a full printout of what the system is doing, who is logged in and more:
-<code>
+|DIRECTORY (DIR)|List files (similar to the library program CAT)|
-SYSTAT
+|COPY|Syntax is ''COPY <new name>=<source file>''|
+|DELETE (DEL)|Delete file (rename file by copying then deleting original file)|
-STATUS OF TSS/8.24 DEC PDP-8 #1 AT 12:19:14 ON  1 JAN 75
+|TYPE|Print file contents|
+|END (E)|End PUTR session and return to Monitor|
-UPTIME 00:07:14
-JOB      WHO     WHERE      WHAT       STATUS     RUNTIME
-      0, 2      K00      FOCAL      ^BS   ^Q    00:00:01
-      1,50      K01      SYSTAT     RUN   ^Q    00:00:00
-AVAILABLE CORE 16K   FREE CORE=312
-BUSY DEVICES    NONE
-FREE DISK SEGMENTS
-</code>
-There are two users logged in, user 2 on teletype 0, user 50 on teletype 1. User 2 is was FOCAL but is now on the prompt (STATUS ^BS means monitor mode, that is the prompt), user 50 is executing the SYSTAT command.
-The manual has more information on SYSTAT, listed here for convenience.
-It is frequently useful to know the status of the system as a whole; how many users are online, where they are, what they are doing, etc. The SYSTAT program provides this capability.
-SYSTAT responds by printing on the first line: the version of the TSS/8 Monitor being run, the time, and the date. SYSTAT reports the uptime which is the length of time in hours, minutes, and seconds since the system was last put online.
-SYSTAT lists all online users. Each user is identified by his account number. The job number assigned to him and the number of the console he is using are indicated, as is the particular System Program he is running. The exact running state of each user, whether he is actually running (RUN), typing in (KEY) or out (TTY), doing input/output on another system device (IO or FIP), or not running (iB), is indicated.
-The amount of computer time used by each user since he logged in is given.
-It more users are online than the system has core Fields to hold them, the Fact that the system is swapping is reported. The number of Free core blocks used internally by TSS/8 Monitor for Teletype buffering and various other purposes is typed out.
-Then SYSTAT reports any unavailable devices, i.e. , devices which are assigned to individual users. The job to which they are attached and their status (AS if they are assigned but not active, AS+INIT if they are assigned and active) is also indicated.
-Finally, the number of available segments of disk storage is reported.
-To see the time that you have been logged in:
-<code>
-.TIME
-:00:20
-</code>
-To see the system time:
-<code>
-.TIME 0
-:20:44
-</code>
 ===== FOCAL69 =====
@@ Line 376: / Line 328: @@
 Using the I command you can enter text, with a CTRL+L you exit insert mode. Save your file with E.