WRITE2.UP, PAGE 1 OF 1.		(6/16/72 - C.M.MOORE, RICE U., HOUSTON)

		PDP-12 PS/8 UTILITY PROGRAMS.

THIS FILE SUMMARIZES THE CONTENTS OF THIS TAPE, WHICH CAN BE CONSIDERED
A SUPPLEMENT TO A PREVIOUS FORTRAN LIBRARY TAPE (DECUS 12-48).
THE MAIN PURPOSE OF THIS TAPE IS TO PROVIDE THE FOLLOWING PDP-12 PS/8
PROGRAMS, WHICH CAN BE USED WITHOUT ANY FAMILIARITY WITH DECUS 12-48:

1) MAGSPY.SV  DISPLAYS THE CONTENTS OF ANY BLOCK ON ANY PS/8 DEVICE
	(DISK, LINCTAPE, DECTAPE), USING ANY OF SEVERAL MODES (POINTS,
	NUMBERS,CHARACTERS) SELECTED WITH THE SENSE SWITCHES.  INCLUDED
	IS A MODE WHICH DISPLAYS PS/8 SOURCE FILES AS TEXT LISTINGS.

2) INDEX.SV  DISPLAYS THE FILE INDEX OF ANY FILE-ORIENTED DEVICE, USING
	A FORMAT SIMILAR TO THAT OF THE PIP /E OPTION.  FILES MAY BE
	DELETED FROM THE INDEX BY TYPING RUBOUTS.  GROUPS OF FILES MAY
	BE COPIED (IN IMAGE MODE) FROM ONE DEVICE TO ANOTHER.

3) COPY.SV  DUPLICATES ALL OF PS/8 LINCTAPE 0 ONTO LINCTAPE 1, INCLUDING
	PS/8 SYSTEM BLOCKS (WHICH ARE NOT COPIED BY THE PIP /S OPTION).

4) MARK12.SV  IS USED TO MARK LINCTAPES.  THIS PROGRAM IS DIAL MARK12
	ADAPTED TO RUN UNDER PS/8.

5) DIALPS.FT IS A FORTRAN PROGRAM WHICH WILL COPY FILES FROM DIAL
	LINCTAPE 1 ONTO PS/8 DEVICE SYS.  CORE IMAGE FILES ARE CONVERTED
	FROM DIAL INTO PS/8 FORMAT, AND SHOULD BE SELF-STARTING
	IN 8-MODE SO THAT THEY CAN BE STARTED UNDER PS/8.
	THIS PROGRAM WAS USED TO COPY MARK12.SV FROM DIAL TO PS/8.

6) PSDIAL.FT COPIES FILES FROM PS/8 DEVICE SYS TO DIAL LINCTAPE 1.
	NO CONVERSION OF CORE IMAGE FILES IS PROVIDED.

MAGSPY.SV, INDEX.SV, AND COPY.SV CONTAIN EXPLANATION DISPLAYS WHICH
APPEAR WHEN THE PROGRAMS ARE RUN.  SOURCE FILE HELP.SB CONTAINS THE
EXPLANATION DISPLAY SUBROUTINE, ALONG WITH INFORMATION ON HOW ANY
FORTRAN OR SABR PROGRAM CAN USE IT.

SOURCE FILES ARE PROVIDED FOR ALL THE ABOVE PROGRAMS EXCEPT MARK12.
THESE SOURCE FILES REQUIRE SEVERAL OF THE SUBROUTINES IN LIBRARY FILES
LIB8.RL AND LIB12.RL.  BOTH LIBRARIES ARE SEARCHED AUTOMATICALLY BY
THE LOADER.SV ON THIS TAPE.   LIB8 IS THE STANDARD PS/8 LIBRARY FILE.
LIB12 IS THE PDP12 LIBRARY FILE PROVIDED ON THE DECUS 12-48 TAPE,
EXPANDED TO INCLUDE 2 ADDITIONAL BINARY FILES, WHOSE SOURCE FILES ARE
PLOT6.SB AND PLOT7.SB.  DECUS 12-48 SOURCE FILE XPLAIN.PL, EXPANDED TO
INCLUDE EXPLANATIONS OF PLOT6 AND PLOT7, IS ALSO INCLUDED ON THIS TAPE.
THE DECUS 12-48 WRITE-UP DESCRIBES THE OTHER ROUTINES IN LIB12.RL.

THE REMAINING CORE IMAGE AND BINARY FILES ON THIS TAPE ARE IDENTICAL
TO THOSE ON DECUS 12-48, AND ARE INCLUDED TO COMPLETE THE PS/8 OPERATING
SYSTEM, CONSISTING OF FILES PIP.SV TO IOSYS.RL AT THE BEGINNING OF THIS
TAPE.  ALL OTHER FILES ON THIS OR THE DECUS 12-48 TAPE ARE EXPLANATIONS
OR SOURCES.

THE FOLLOWING SEQUENCE OF PROGRAMS MAY BE RUN TO CREATE A PS/8 SYSTEM
ON AN UNMARKED LINCTAPE:
1)START PS/8 WITH NEW TAPE ON UNIT 1, THIS TAPE WRITE-LOCKED ON UNIT 0.
2)R MARK12 TO MARK NEW TAPE WITH 128-WORD BLOCKS (TAKES 2.5 MINUTES)
3)R COPY TO DUPLICATE THIS TAPE ONTO NEW TAPE (TAKES 3 MINUTES)
4)R INDEX TO DELETE ANY FILES NOT NEEDED ON NEW TAPE, OR TO COPY
  ANY ADDITIONAL FILES FROM OTHER TAPES OR PS/8 DEVICES.