	PHILIP CANNON
	CHICAGO LUG

300,2	A NEW VERSION OF TPC THAT DOES NOT REQUIRE CONTIGUOUS FILES !!
	(THANKS TO JIM NEELAND, SCLUG)
300,43	A NEW VERSION OF THE CAMAC DRIVER
300,2	A NEW VERSION OF TPC THAT DOES NOT REQUIRE CONTIGUOUS FILES !!!!!300,46	CENHANCEMENTS TO RUNOFF
300,47	CODE TO INTERCEPT ILLEGAL INSTRUCTIONS
300,50	DYNAMIC COMMONS ON 11M !!!!!!!!!!!!!!
300,51	COMMAND FILES FOR AUTOMATED DOCUMENTATION
300,52	(FCS TUTORIAL) PROGRAMS THAT GIVE FORTRAN ACCESS
	TO THE FCS MACROS
300,53	A FIX TO ELIMINATE FORM FEEDS FROM THE 11M SPOOLER
300,54	FILES-11 ACTIVITY REPORTING TASK
300,55	PERFORMANCE EVALUATION TOOLS
300,200	INFORMATION ON IAS V3.0
300,201	UTS DISPLAY TIME SHARE FOR V3.0
300,202	DOCUMENTATION OF IAS INTERNALS
300,203	SKELETON HANDLER FOR IAS V3.0
300,300	(FCS TUTORIAL) FORTRAN UTILITIES
[301,010] MTBLOK - FORTRAN CALLABLE SUBROUTINE PACKAGE FOR FOREIGN MAGTAPES

Base level:	Version 04		Date:	01-MAY-76	
Patch level:	None			Date:

Submitted by:	John Barr (as received from Eric Pollack)
		Hughes Aircraft Co.

Description:	A set of FORTRAN callable subroutines to READ/WRITE
arbitrary blocks on magtape at 800/1600 bpi, as well as SPACE FWD/REV,
REWIND, & WRITE-EOF.

System reqts:	MT: (or MM:), minimal memory for the subroutines themselves,
as far as is known will run on all versions of RSX-11M, 11-D, & IAS.

Documentation:	A RUNOFF input file is included to document the subroutine
calls.

Status:		No known bugs.  However, as supplied the package is hardwired
(via an ALUN$ call) to use MT:.  If you wish to reference MM: instead you will
have to change that one line.

Desired enhancements:	The librarian feels that this routine would be
a bit more general if it did NOT do a rewind when calling the MTINIT routine.
Also, there doesn't seem to be any good reason to do IOT's to crash when the
wrong parameters are supplied.  Better might be to simply return BAD PARAMETER
status.

Support:	None????

[301,011] SELECT - FRTRN CALLABLE ROUTINE FOR KEYBD OPTION SELECT REV. 790402.

Base level:	Version CS1.17		Date:	04-02-79	
Patch level:	None			Date:

Submitted by:	Charles South
		Hughes Research Labs
		3011 Malibu Canyon Rd.
		Malibu, CA	90265
		phone:(213) 456-6411

Description:	A FORTRAN callable MACRO routine to provide keyboard option
selection from a specified list of options.  Defaults are provided for, as
is prompting, recognition & string completion via the ESCAPE key.  At any
point in keyboard input, a question-mark will elicit all remaining selections
which are still not unique.

System reqts:	Approx.  1.2K words for the subroutine.  Has been run only on
RSX-11M, but no known restrictions to other RSX systems.

Documentation:	A .DOC file, well-commented source code, and a FORTRAN test
program as an example.

Status:		No known bugs.  However, if the task using the subroutine is
checkpointed, then echoing of individual typed characters may be slow, or
characters may be lost if accidentally typing ahead.

Support:	A currently actively used subroutine.  The author welcomes
reports of any problems encountered in using the routine.

Current Release Change Summary (since last DECUS distribution):
	CS1.17	4/2/79	  bug fix on change of default LUN for TI:
	CS1.16	2/14/79	  enhancement to add backspace char. deletion (CRT's)
	CS1.15	1/22/79	  bug fix on correct "find" of option, given noise words
	CS1.14	1/2/79	  bug fix on correct "find" of option for subset strings
	CS1.13	12/6/78	  bug fix on default string when task larger than 16kw

[301,012] WHO - 11M TASK - LIST LOGGED-IN TT:'S W/ NAMES, TASKS - REV. 790416.

Base level:	Version JKN3.0		Date:	23-AUG-78	
Patch level:	None			Date:

Submitted by:	Jim Neeland
		Hughes Research Labs
		3011 Malibu Canyon Rd.
		Malibu, CA	90265
		phone: (213) 456-6411

Description:	Privileged task for RSX-11M to allow ALL users to determine
which terminals are currently logged in, what their login uic/name is, and what
active tasks currently have which TT: number as the task TI:.  Thus for example
you can quickly see what tasks belong to whom and who is currently using
the print spooler.  Also displays selected task states, shows active (not
stopped) tasks associated w/ CO:.  Has built-in /HElp switch.
Output format (example):
>WHO /HE<cr>
Lists active tasks associated with CO: ([DETACHED]),
 logged-in terminal #s, including any virtual terminals (VTnn:),
 their login [UIC]/<NAME>, and tasks with that terminal as TI:
Task states are indicated with symbols in the following order:
	/ = Checkpointed
	? = Terminal input wait
	* = I/O outstanding
	# = Wait for event flag
	sp= no special state flagged

CO0:  [DETACHED],*NT....,*F11ACP
TT00:  [377,377]
TT12:<$NEELAND> , ...WHO
TT13:<WSMITH>   ,*...F4P,/...AT.
TT14:<EVELYN>   ,?...MAC
TT17:<GUEST>    , ...BAS
VT00:<VIRTUAL.TERM>     ,*...PIP,#AT.V01
>


System reqts:	Approx. 0.9K words in GEN partition when running.  This
version requires the existence of the TERCOM database partition, and is
only useful with the programs which support TERCOM, namely slightly modified
versions of HELLO and BYE, and a small TLOGGR task which maintains the
database itself.  Please see [301,25] for further information.  The prior
version of WHO does not need TERCOM, but does not provide name information.

Documentation:  Extensive source comments, WHO.DOC file, '/HElp switch.

Status:		No known bugs.  The following known limitations exist:
Designed for an 80-char line terminal.  A maximum of 8 tasks will be listed
for any given TT:.  The active tasks NOT associated with a LOGGED-IN TT:
will NOT be listed.

Desired enhancements:  An additional switch to printout the login time
also contained in the TERCOM database.

Support:	The author welcomes comments, suggestions, & complaints,
as this is an actively used utility, but doesn't guarantee to fix anything.

[301,013] ENABLE - RSX-11M TASK TO ALLOW NON-PRIVILEGED USER TO SET TO PRIV

Base level:	Version JKN01		Date:	27-JUL-77	
Patch level:	None			Date:

Submitted by:	Jim Neeland
		Hughes Research Labs
		3011 Malibu Canyon Rd.
		Malibu, CA	90265
		phone: (213) 456-6411

Description:	A privileged task to allow someone knowing the password to
set a non-privileged terminal to privileged.  This is very useful when having
to issue a privileged command for some non-privileged user without having to
log him out or find another terminal somewhere.  The non-privileged status
can be restored with the command SET /NOPRIV=TI:.
Usage:
>ENA<cr>
ENA password:	(Enter the password defined in YOUR source file)
>		(or:   !!!Illegal password
		if you typed it incorrectly)

System reqts:	Approx. .25K of memory in GEN when running.

Documentation:	None other than souce comments and command files.

Status:	No known bugs, except perhaps will not work correctly if
the requesting terminal is a redirected one.

Desired enhancements:	None.

Support:	Author welcomes comments, complaints & suggestions, as this
is a currently active program, but does not guarantee to fix anything.

[301,014] TERMINAL LOGGING MCR ROUTINES FOR RSX-11D

Base level:	Version JRBARR.01	Date:	17-NOV-77	
Patch level:	None			Date:

Submitted by:	John R. Barr
		Hughes Aircraft Co.
		377/C209  Box 92919
		Los Angeles, CA 90009
		Phone:  (213) 648-8295
      
Description:	Set of MCR routines which replace standard RSX-11D routines
of HELLO, BYE, and SET /UIC which allow terminal logon times to be accounted.

System reqts:	Not much more than the standard MCR routines.  With modifica-
tions might run on RSX-11M or IAS.
  
Documentation:	A short note explains what the routines do.  Contained in
file TERMLOG.RNO
  
Status:		Programs are completely debugged and in use for the last six
months.
  
Desired enhancements:	Would be nice to update dial-access password for V6.02

Support:	Unkown.

[301,015] PASREF - PASCAL CROSS-REFERENCE PROGRAM

Base level:	Version 2A		Date:	15-APR-78	
Patch level:	None			Date:

Submitted by:	Bill Heidebrecht
		TRW DSSG
		Bldg. 90/2178
		One Space Park
		Redondo Beach, CA	90278
		(213) 535-0313

Description:	PASREF is a Pascal cross-reference program based on a
similar program by Niklaus Wirth in "Algorithms + Data Structures =
Programs" (pp. 206-210).
	There are two versions of this program:  PASREF & PASRF2.
PASREF is the source program for the Swedish Pascal.
PASRF2 is the source program for the NBS Pascal.

System reqts:	Task size is 22.5K words under RSX-11M.

Documentation:	RUNOFF input file called PASREF.RNO

Status:		No known bugs.

Support:	Unknown.

[301,016] SSPLIB - MODIFIED IBM SCIENTIFIC SUBROUTINE PACKAGE FOR PDP-11

Base level:	Version 01		Date:	26-NOV-77	
Patch level:	None			Date:

Submitted by:	Charles South (as received from Dr. Kaplan)
		Hughes Research Labs
		3011 Malibu Canyon Rd.
		Malibu, CA	90265
		(213) 456-6411

Description:	This is approximately the IBM/360 Scientific Subroutine
Package (SSP), modified to run using F4P.  It should be independent of
operating system (i.e. RSX-11M, D, or IAS).  There is no guarantee that
the routines will compile as supplied using FOR, but they might.  The
supplied OLB file is the result of compilation w/ F4P, version 2.50,
with the default switches of optimization and TR:BLOCKS.

System reqts:	As compiled, requires FPP hardware (11/34,45,55,60,70).
Speed and space obviously vary greatly from one routine to another.

Documentation:	None internally (including NO comments in source).  For
description of subroutines see:
IBM System/360 Scientific Subroutine Package Programmer's Manual
Document # GH20-0205-4  (or more recent version, if one exists)

Status:		No compilation errors.  It is well known that for some
situations this library does not use the latest or best algorithms for
solving a given problem.  However, it is widely used.

Desired enhancements:	Further information on run characteristics on
PDP-11s, and/or further documentation on peculiarities of various subroutines.

Support:	The librarian will endeavor to keep a file of reported
problems, fixes, etc., but this is a use-at-your-own-risk package.

[301,017] MAG TAPE VOLUME I.D. LISTING FOR RSX-11M

Base level:	Version 3APR78		Date:	20-APR-78	
Patch level:	None			Date:

Submitted by:	Sandra L. Lyddon
		Chevron Oil Field Research Co.
		P.O. Box 446
			or
		3282 Beach Blvd.
		La Habra, CA   90631
		Phone:  (213) 691-2241
      
Description:	MTM writes the volume-labels of all mounted tapes to TI:

System reqts:	Minimal.  Unknown by author whether possible for RSX-11D
or IAS.

  
Documentation:	None.
  
Status:		Debugged.
  
Desired enhancements:	Would be nice to include similar information for
mounted disk volumes, for use in an environment with many user disks.
 
Support:	Unkown.

[301,020] WHO PROGRAM FOR RSX-11D BASED ON [300,26] DEC.'77 SIG LIBRARY TAPE

Base level:	Version AEF002		Date:	20-APR-78	
Patch level:	None			Date:

Submitted by:	Alan Frisbie
		Interactive Graphic Systems
		5806 Laramie Ave.
		Woodland Hills, CA  91367
		Phone:  (213) 346-0549
      
Description:	A modified version of the WHO from the SIG tape of Dec. 77.
Differences from the stock WHO are:
1)	Tasks actvie on each terminal (up to 8) except handlers are listed.
Tasks on the MRL have the first 3 characters of their name replaced with "MRL".
Differences from version in [300,26]:
1)	Terminals that are not logged-on or slaved are not listed.
2)	Priviledged terminals are indicated by an asterisk in front of the
UIC instead of saying "PRIVILEDGED".  These changes result in a neater listing
and much less printing time on slow terminals.

System reqts:	Approx. 580 words.

  
Documentation:	Source comments.
  
Status:		Debugged.
  
Desired enhancements:	Indicate MRL tasks with a flag instead of "MRL"
in the taskname.
 
Support:	Author will probably fix bugs, but don't count on it
being done fast.

[301,021] FORTRAN PGM TO LIST UICS & THEIR PASSWORDS ON STD. RSX-11D SYSTEM

Base level:	Version AEF001		Date:	20-APR-78	
Patch level:	None			Date:

Submitted by:	Alan Frisbie
		Interactive Graphic Systems
		5806 Laramie Ave.
		Woodland Hills, CA  91367
		Phone:  (213) 346-0549
			OR
		Alan E. Frisbie
		3786 E. Mountain View Ave.
		Pasadena, CA  91107
		Phone:	(213) 796-7872
      
Description:	A mostly FORTRAN program to list UIC's and their associated
passwords on a 'stock' RSX-11D system.  The program will work properly with
both F4P and FOR.

System reqts:	A minimal size FORTRAN program.

  
Documentation:	Source comments.
  
Status:		Debugged.
  
Desired enhancements:	Unknown.
 
Support:	Unknown.

[301,022] UNIX TP TAPE EXTRACTOR FOR ASCII FILES

Base level:	Version JRBARR.01	Date:	17-NOV-77	
Patch level:	None			Date:

Submitted by:	John R. Barr
		Hughes Aircraft Co.
		377/C209  Box 92919
		Los Angeles, CA 90009
		Phone:  (213) 648-8295
      
Description:	Reads ASCII file from UNIX TP formatted tape.
MCR>UTP OUTFILE.EXT=pathname

System reqts:	PASCAL source code, runnable on RSX-11M & RSX-11D, maybe on
IAS.
  
Documentation:	None.
  
Status:		Mostly debugged.
  
Desired enhancements:	Writing a UNIX tape.

Support:	Unkown.

[301,023] VTDRV - LOGGED-IN, PRIVILEDGED VIRTUAL TERMINAL FOR RSX-11M

Base level:	Version JKN01		Date:	24-APR-78	
Patch level:	None			Date:

Submitted by:	Jim Neeland
		Hughes Research Labs
		3011 Malibu Canyon Rd.
		Malibu, CA	90265
		phone: (213) 456-6411

Description:	Provides a virtual terminal (NOT a pseudo device) which is
logged in and priviledged, against which to run such things as DECNET command
files and scheduled tasks without having to have a physical terminal left idle
and priviledged sitting around.

System reqts:	Almost nothing except the pool space necessary to store
the DCB, UCB, & SCB databases.  As supplied, assumes support for loadable
drivers (and consequently their associated databases).


Documentation:	None other than source comments.

Status:		No known bugs.

Desired enhancements:	An associated output device so that output to this
virtual terminal can be logged.

Support:	The author welcomes comments, suggestions, & complaints,
as this is an actively used device, but doesn't guarantee to fix anything.

[301,024] TYPE - 11M TASK TO TYPE A FILE ON YOUR TI: - FEATURES OVER PIP

Base level:	Version JKN2.1		Date:	21-NOV-78	
Patch level:	None			Date:

Submitted by:	Jim Neeland
		Hughes Research Labs
		3011 Malibu Canyon Rd.
		Malibu, CA	90265
		phone: (213) 456-6411

Description:	Task for RSX-11M to provide the equivalent of 
PIP TI:=FILENAME.EXT with: TYPe FILENAME.EXT
In addition, it uses the ATTACH with AST terminal driver function to
terminate output immediately at the end of any record after receiving either
a CNTRL-Z or CNTRL-C, instead of having to type: CNTRL-C + ABO PIP<cr>
It also provides a banner line giving the complete file specification and
date and time of last write.  The banner is optionally suppressable.
It also will optionally truncate each line to nn characters, where nn is by
default 1 less than the terminal buffer size, thus avoiding wraparound on
long lines, and making terminal examination of assembler and compiler output
much less painful.  It has a built-in /HE function to remind the user what
the format is for the optional switches.
In addition, it is smaller than PIP, even though not overlaid.

System reqts:	Approx. 3.0K words in GEN partition when used with a resident
FCS library.  Without a resident library, uses 6.5 K words.

Documentation:  Extensive source comments, TYPE.DOC file, '/HElp switch.

Status:		No known bugs.  The following known limitations exist:
Will handle all standard listing files, FORTRAN carriage control, implied
carriage control, and imbedded carriage control.  Will handle multiple files
on a command line, e.g. TYP FILE1.TXT,FILE2.TXT.  However, will not default
either name or extension from one file to the next. (Note: the author hasn't
yet figured out a straightforward way to get CSI to support that).  TYPe also
doesn't support an indirect command file or an output device other than TI:

Desired enhancements:	Defaulting of name and extension, mentioned above.
Support for paging on the output terminal, with pauses between pages, the
way RUNOFF is supposed to work.

Support:	The author welcomes comments, suggestions, & complaints,
as this is an actively used utility, but doesn't guarantee to fix anything.

[301,025] TERCOM - LOGIN DATABASE COMMON & SUPPORT PGMS FOR 11M

Base level:	Version 1.11		Date:	13-APR-79	
Patch level:	None			Date:

Submitted by:	Jim Neeland
		Hughes Research Labs
		3011 Malibu Canyon Rd.
		Malibu, CA	90265
		phone: (213) 456-6411

Description:	A small COMMON partition in which is maintained information
about each logged-in terminal, in particular the login account name, login
uic and login device, and login time.  To maintain this database requires
minor modifications to HELLO and BYE, and a small task (TLOGGR) to receive
sends from HELLO and BYE to do the actual database updating.  TLOGGR does
the logging of Hello's and BYE's on TT0:, but this may be redirected to
another more suitable terminal.  It also optionally sends a duplicate copy
to another terminal (default NL:).  With slight modifications it could append
the logout information to an accounting file for connect-time billing.  It
also responds to requests for information, such as would be needed for a
user-oriented MAIL system (currently under development).  Included is a
FORTRAN-callable WHODIS routine to get the login name, UIC, and SY:
This database is also used directly by the latest version of WHO (see
[301,12].

System reqts:	32. words for each terminal configured on the system, plus
96. words for overhead (includes record for a virtual terminal, VT0:).  In
addition the current version of TLOGGR requires approx. .7K words in whatever
partition is convenient.

Documentation:  Extensive source comments, TERCOM.RNO file for implementation.

Status:		No known bugs.

Desired enhancements:  Appending of the LOGOUT record to an accounting
file for connect-time billing.

Support:	The author welcomes comments, suggestions, & complaints,
as this is an actively used utility, but doesn't guarantee to fix anything.







       SEATTLE LUG CONTRIBUTION TO NEW ORLEANS COLLECTION

[302,206
] - DEMO
     UIC contains Digital's DEMO task with numerous enhance-
     men
ts.  This version will work only on IAS 3.0.

[302,300] - MULTI-TREK
[302,301
]
     MULTI-TREK  is  a  multiple  terminal  version  of  the
     Star-trek 
 game.   It  consists  of  a real-time driver
     task, MTREK, and a multi-use
r, time-sharing task,  PLA-
     YER,  for  each terminal, which play against e
ach other
     (no Klingons or Romulans, but watch out for  the  black
     ho
les).   [302,300]  contains a less sophisticated ver-
     sion than [302,301].
  The [302,301] version  makes  use
     of  programmable  cursor  addressing, 
 unsolicited read
     AST's, etc., to provide a dynamic display  (ala  DEMO).

     Detailed  instructions  are  contained in the MTREK.TXT
     files for ea
ch UIC.  Both UIC's are complete,  although
     there  is  no  difference betw
een the two copies of the
     driver task, MTREK, and the shared global common
,  LED-
     FORD.

[302,302] - GREP
     GREP was originally submitted to t
he San Francisco col-
     lection  under  a  UIC of [315,100].  This version c
on-
     tains some modifications to that version.  The  changes
     are to a
llow the output to go to a file instead of just
     to the terminal.  Also inc
luded  are  minor  formatting
     changes to improve readability of the output
.


		COPEUS.DOC
		----------
	
THE CENTRAL OKLAHOMA PDP-ELEVEN USERS SOCIETY SUPPLIES THE FOLLOWING
AS ITS CONTRIBUTION TO THE RSX-11/IAS SIG NEW ORLEANS TAPE:

[305,201]	SUBTASK -- FORTRAN INTERFACE TO IAS (V3.0) SUBTASKING
		FACILITY.
		SUBTASK.RNO DESCRIBES THE INTERFACE.
		EXAMPLES OF USAGE (CORRESPONDING TO THE MACRO BATCH
		STREAM IN THE V3.0 RELEASE NOTES) ARE ALSO PROVIDED.

[305,202]	FLECS -- A VERSION OF FLECS (MODIFIED TO RETURN EXIT
		WITH STATUS) PLUS A COMMAND PROCESSOR THAT PERMITS
		A PDS-LIKE FLECS COMMAND WITH AUTOMATIC COMPILATION,
		LINKING AND RUNNING. THESE LATTER PROCESSES ARE
		DEFEATABLE.

[305,301]	RUNOFF -- CONTAINS CORRECTION AND REVISED COMMAND
		FILES FOR THE RUNOFF SUPPORTED BY THE RUNOFF WORKING
		GROUP.  THESE FILES WILL WORK WITH THE RUNOFF NOW
		IN THE DECUS LIBRARY, WHICH IS IDENTICAL TO THAT
		SUPPLIED ON THE CHICAGO SIG TAPE.

	
THIS IS THE DIRECTORY FOR THE BAYLUG (BAY AREA LOCAL USERS GROUP)
TAPE SUBMISSIONS TO THE NEW ORLEANS DECUS CONVENTION

[307,1]	THIS DIRECTORY
[307,2] LOG COMMAND -- REPLACES SET /UIC WITH EASIER SYNTAX
[307,3]	IMPROVED DDT -- ODT WITH SYMBOLIC DISASSEMBLER
[307,4] NASA/AMES RSX11M V3.1 INHANCEMENTS
[307,5] CETUS -- LIBRARY OF USEFULL FORTRAN CALLABLE SUBROUTINES
[307,6] TREK -- A SLIGHTLY MORE DEBUGGED VERSION OF CHICAGO TAPE STARTREK
[307,7] ADVENTURE -- TASK IMAGE AND OBJECT MODULES FOR NON FPP ADVENTURE
[307,10] BADGER METER SUBMISSIONS -- MORE DETAILED VERSION OF FRAG OUTPUT
[307,11] DIGITAL TELEPHONE SYSTEMS SUBMISSIONS -- VT52 BLACKJACK
[307,12] RECOVER - THE FABULOUS FAMOUS FILE FIX PROGRAM
[307,13] SRI STUFF
[307,14] RUNARROUND RUNOFF PATCHES
[307,15] DUNGEON! THE NEW SUPER ADVENTURE (DUNGEONS AND DRAGONS) GAME.
[307,16] ALARM -- SUBMITS MCR LINES AFTER DELAY TIMES OR AT SPECIFIC HOURS

ALSO ON THIS TAPE:

[300,21] PATCH FILES FOR CORRECTIONS AND CHANGES IN THE FALL 1978 SFTAPE BASIC






 















                              WIRAP


                 Wire-Wrap Documentation Program



     This program is used to simplify and speed up hand wiring  of
circuit cards using Wire-Wrap technology.  Features of the program
include electrical checking of wire connections, automatic genera-
tion of the power and ground connection chains, wire length minim-
ization, and cross-reference listing generation.

     The program is written  completely  in  FORTRAN  IV-PLUS  and
should  run  on any system supporting that compiler.  The indirect
command file which generates the  program  uses  features  of  the
RSX11-M V3.1 indirect command file processor.


                                                            PAGE 2



                        Installation Notes

     A complete build (assembly with  listings,  task  build  with
map,  and  users  manual generation) requires about 4150 blocks of
disk storage.

     The task runs overlayed in 26KW.

     The build procedure is

                MCR>set /uic=[317,300]
                MCR>@wirgen

The WIRGEN.CMD file will perform all needed procedures,  including
generation  of  the task build command file and overlay descriptor
file on the fly.

     During the task build,  diagnostic  messages  concerning  the
PSECT "WORK" will be generated.  These messages may be ignored.

     After building the task, it may be tested by using  the  test
file EXAMPLE.WIR.  The command dialog is

        MCR>ins wirap
        MCR>wir

                *** WIRAP  V4.3

        WIR>ENTER LISTING FILE SPEC: example
        WIR>ENTER INPUT FILE SPEC: example

                *** WIRAP  V4.3

        WIR>ENTER LISTING FILE SPEC: ^Z
        MCR>

No errors should occur.  The output file will be EXAMPLE.LST.


THE SOFTWARE IN [321,*] ARE CONTRIBUTIONS FROM:
 
	BRIDGEPORT CONTROLS
	200 PRECISION ROAD
	HORSHAM, PA. 19044
        CONTACT: RICHARD MICHAUD (215) 674-2700
 
 
EACH UIC IN THIS SET CONTAINS A TEXT FILE (INFO.TXT) WHICH DETAILS
THE SOFTWARE IN THE UIC.
 
[321,2]
	RATFOR (...RAT) - RATIONAL FORTRAN PREPROCESSOR (JULY 1978)
	THIS VERSION OF RATFOR HAS AN ENHANCED LIBRARY WITH ADDED
	FUNCTIONS FOR STRING PROCESSING. THE RUNOFF DOCUMENTATION
	HAS BEEN ALTERED TO BE COMPATIBLE WITH THE SIG SUPPORTED
	VERSION OF RUNOFF AND WILL ALSO WORK WITH THE VERSION
	OF RUNOFF DISTRIBUTED WITH RSX11M.
 
			REQUIREMENTS
 
	HARDWARE:	PDP-11 WITH FLOATING POINT PROCESSOR (FPP,FPU)
	SOFTWARE:	RSX11M V3.1, RSX11D 6.2
			F4P
			SIG RUNOFF FOR DOCUMENTATION
			CORE RESIDENT LIBRARY FCSRES (NOT REQUIRED IF BUILD
			COMMAND FILE IS EDITED)
 
	DOCUMENTATION:	INFO.TXT, RATFOR.RNO, RATLIB.RNO, SOURCES
 
	SOURCE:		D. S. ARGUE, ATOMIC ENERGY OF CANADA, FROM [345,5]
 
[321,3]
	FRAG (...FRG) - DISK FRAGMENTATION STATISTICS UTILITY.
	THIS VERSION OF FRAG HAS BEEN MODIFIED BY THE AUTHOR TO
	ALLOW THE TASK TO WORK WITH LARGE DISKS SUCH AS THE RP.
 
			REQUIREMENTS
 
	HARDWARE:	PDP11
	SOFTWARE:	RSX11M VERSION 3.0 OR LATER - SHOULD BE EASILY
			MODIFIED TO RUN UNDER ANY OPERATING SYSTEM
			WITH A FILES-11 FILE STRUCTURE.
 
	DOCUMENTATION:	INFO.TXT, SOURCES
 
	SOURCE:		RICHARD L. MICHAUD 
			  REVISED SEP-78
 
[321,4]
	SPQ (...SPQ) - SPOOLER QUEUE LISTING UTILITY.
	THIS VERSION OF SPQ LISTS FILES WAITING TO BE PRINTED
	ON THE LINEPRINTER AS WELL AS EXPECTED NUMBER OF PAGES
	FOR EACH FILE.

 
			REQUIREMENTS
 
	HARDWARE:	PDP11
	SOFTWARE:	RSX11M VERSION 3.1
			PRT... PRINT SPOOLER TASK
 
	DOCUMENTATION:	INFO.TXT, SOURCES
 
	SOURCE:		RICHARD L. MICHAUD FROM GREG BASSET.
				REVISED SEP-78
 
[321,5]
	SCREEN.OBJ - SCREEN FORMATTING AND CURSOR TRACKING FORTRAN
	CALLABLE SUBROUTINE.
 
			REQUIREMENTS
 
	HARDWARE:	VT52, VT100 IN VT52 MODE
	SOFTWARE:	RSX11M, RSX11D
			SUPMAC.MLB IF ASSEMBLY OF SCREEN.MAC DESIRED.
			SIG RUNOFF FOR DOCUMENTATION.
 
	DOCUMENTATION:	INFO.TXT, SCREEN.RNO, SOURCES (IN SUPMAC)
 
	SOURCE:		RICHARD L. MICHAUD
 
[321,6]
	RMSFTN - FORTRAN CALLABLE RUN-TIME INTERFACE TO THE
	RMS-11K INDEXED-SEQUENTIAL FILE/RECORD MANAGEMENT
	SYSTEM.
 
			REQUIREMENTS
 
	HARDWARE:	PDP11
	SOFTWARE:	RSX11M V 3.0 OR LATER
			RMS-11K
			FORTRAN-IV OR FORTRAN-IV PLUS
			OR ANY LANGUAGE THAT USES THE FORTRAN
			REGISTER CONVENTIONS FOR SUBROUTINE CALLS.
			(SUPERMAC V46 OR LATER REQUIRED FOR ASSEMBLY
			OF RMSFTN ROUTINES.  DISTRIBUTED IN BOTH
			SOURCE AND OBJECT LIBRARY FORMS.)
 
	DOCUMENTATION:	SOURCES, INFO.TXT, RMSFTN.TXT
 
	SOURCE:		ARTHUR P. GAUGHAN, BRIDGEPORT CONTROLS.
 
[321,7]
	SUPERMAC V47 - MACRO-11 LIBRARY FOR STRUCTURED ASSEMBLY LANGUAGE
	PROGRAMMING.
 
			REQUIREMENTS
 
	HARDWARE:	PDP-11
	SOFTWARE:	RSX11M V 3.0 OR LATER (RSX-11D?)
 
	DOCUMENTATION:	INFO.TXT, SUPMAC.RNO, SUPMAC.MAC
 
	SOURCE:		ARTHUR P. GAUGHAN, BRIDGEPORT CONTROLS
			(FROM THE PUBLIC DOMAIN)
 
 


[321,10]
	SCCS.CMD - SOURCE CODE CONTROL SYSTEM.  AN INDIRECT MCR (AT.)
	TECHNIQUE FOR MAINTAINING CORRECTIONS, ENHANCEMENTS, AND
	MODIFICATIONS TO SOURCE (ASCII TEXT) CODE.
 
			REQUIREMENTS
 
	HARDWARE:	PDP11
	SOFTWARE:	RSX11M V 3.1
			INDIRECT MCR (...AT.)
			SLIPR
			COMPARE UTILITY ...CMP
			EDI OR EDT
 
	DOCUMENTATION:	INFO.TXT, SCCS.TXT, SOURCE (SCCS.CMD)
 
	SOURCE:		ARTHUR P. GAUGHAN, BRIDGEPORT CONTROLS
 
[321,11]
	DECNET DOWNLINE LOAD BY FILENAME
	A DISCUSSION OF DECNET MODIFICATIONS TO SUPPORT RSX11S SYSTEM 
	DOWN-LINE LOAD BY FILENAME INITIATED BY A TARGET PDP-11,LSI-11.
	SINCE AFFECTING THE NECESSARY CHANGES REQUIRES ACCESS TO CERTAIN
	DECNET MODULES AT SOURCE LEVEL, ONLY A DISCUSSION OF THIS
	ENHANCEMENT IS PROVIDED.  INTERESTED USERS MAY CONTACT THE
	AUTHORS FOR MORE DETAILED INFORMATION AND ASSISTANCE IN IMPLEMENTING
	THE MODIFICATION (SEE INFO.TXT).
 
 
	DOCUMENTATION:	INFO.TXT


CHANGES TO INDIRECT MCR TO IMPLEMENT
1. A /LI SWITCH
2. SECONDARY SEARCH FOR COMMAND FILES
3. POSITIONAL AND KEYWORD PARAMETERS ON THE COMMAND LINE

FILE DIRECTORY

*.COR SLPR CORRECTION FILES TO APPLY CHANGES TO DEC FILES
	THESE FILES ARE CORRECT FOR IAS V3.0 SUPPORTED INDIRECT MCR
	THEY SHOULD BE CLOSE FOR RSX-11M V3.2
	THEY PROBABLY WON'T BE CLOSE FOR THE UNSUPPORTED VERSIONS

	THE FILES CONTAIN THE SLPR COMMAND LINE WHICH WILL 
	PROBABLY HAVE TO BE EDITED FOR YOUR DISK CONFIGURATION.

INDPRM.MAC SOURCE FOR THE COMMAND LINE PARSER ROUTINE

*.CMD	VARIOUS COMMAND FILES USED DURING GENERATION OF THE
	DISTRIBUTION TAPE AND FOR USE IN GENERATING MCR

	OF PARTICULAR INTEREST

	SLPR.CMD	APPLIES CORRECTION FILES TO DEC SOURCE
			WILL NEED EDITING FOR DEVICE NAMES
	INDASM.CMD	ASSEMBLE ALL FILES INCLUDING INDPRM
	INDBLD.CMD	BUILD INDMCR INCLUDING INDPRM
	INDDBG.CMD	BUILD INDMCR WITH ODT
	RENAME.CMD	MAKE A COPY OF ALL SOURCE FILES TO BE CHANGED

*.NRO	SOURCE DOCUMENTATION FILES
	INDMCR.NRO IS A SHORT MEMO GIVING INTRODUCTORY INFORMATION
	APPA.NRO   IS AN UPDATE TO THE USERS GUIDE
	APPB.NRO   IS A SHORT DICRIPTION OF THE INTERNALS OF THE CHANGES

	THE FILES ARE IN A FORMAT FOR INPUT TO NROFF OR TROFF ON UNIX
	 (UNIX IS A TRADEMARK OF BELL LABORATORIES)
	FOR THOSE OF YOU WHO DO NOT HAVE ACCESS TO UNIX, TOO BAD!

PROCEDURES

1.	MAKE A COPY OF ALL .MAC FILES TO BE CHANGED.  THE COPY SHOULD
	BE TYPE .001.  SLPR FILES WILL APPLY EDITS TO THIS BASE
	LEVEL 001 FILE.  RENAME.CMD SHOULD DO IT.

2.	ASSEMBLE SOURCE MODULES CHANGED.  ALL SOURCE MODULES
	CAN BE ASSEMBLED WITH INDASM.CMD

3.	BUILD NEW INDMCR USING INDBLD.CMD. THIS MAY NOT BE CORRECT
	FOR M USERS.  THE ONLY CHANGE TO THE STANDARD BUILD FILE
	WAS TO INCLUDE INDPRM.OBJ

4.	REMOVE THE OLD INDMCR AND INSTALL THE NEW ONE.

TESTING
	THE FILE FORTRY.CMD CAN PROVIDE A LIMITED QUICK TEST TO
	SEE IF THE CHANGES ARE WORKING. IT CAN BE CALLED WITH THE
	/LI AND /-MC SWITHCES TO GET A LISTING OF THE COMMANDS PRODUCED
	WITHOUT EXECUTING THEM.  IT HAS TWO POSITIONAL PARAMETERS
	AND ONE KEYWORD PARAMETER. THE 1ST PARAMETER IS ONE OR
	MORE SOURCE FILES TO BE COMPILED.  THE 2ND PARAMETER IS
	1ST 6 CHARS OF THE NAME OF A TKB COMMAND FILE.  IF NOT
	SPECIFIED THE 1ST SOURCE FILE NAME IS USED.  THE KEYWORD
	PARAMETER IS COPT AND CAN BE ANY LIST OF SWITCHES TO BE
	APPENDED TO THE SOURCE FILE NAMES WHEN COMPILING.
	FOR EXAMPLE
	@FORTRY/LI/-MC (PROGA,PROGB,PROGC) MYTASK COPT=/DA
	SHOULD RESULT IN
	FOR DC:PROGA,LP:=DC:PROGA/DA
	FOR DC:PROGB,LP:=DC:PROGB/DA
	FOR DC:PROGC,LP:=DC:PROGC/DA
	TKB @DC:MYTASKTKB

	@FORTRY X
	SHOULD RESULT IN
	FOR DC:X,LP:=DC:X
	TKB @DC:XTKB

ONE CHANGE NOT IN THE DOCUMENTS
	THE @ IS NOT NEEDED ON NESTED COMMAND FILE CALLS
	IF THE COMMAND IS NOT INSTALLED INDMCR AUTOMATICALLY TRIES
	TO FIND A COMMAND FILE NAMED COMMAND.CMD.
	THIS PL/I PROGRAM IS AN IMITATION OF THE ORIGINAL ELIZA
	PROGRAM WRITTEN IN LISP BY JOESPH WEIZENBAUM (MIT).
	THIS PARTICULAR PROGRAM WAS INSPIRED BY STEVE NORTH'S
	ARTICLE IN CREATIVE COMPUTING.
 
	THIS DISTRIBUTION CONTAINS THE FOLLOWING FILES:
 
	ELIZA.PLI    - PL/I SOURCE FILE OF ELIZA
	ELIZA.OBJ    - OBJECT MODULE OF ELIZA.PLI
 
	THE FOLLOWING 4 TEXT FILES ARE USED BY ELIZA. THEY WERE
	OBTAINED OF THE FALL DECUS '78 TAPES:
	1) DOCTOR.KEY - THIS FILE CONATINS A LIST OF ALL THE
	   KEYWORDS WHICH ELIZA CAN RECOGNIZE.
	2) DOCTOR.RPL - THIS FILE CONTAINS A LIST OF ALL THE
	   REPLIES WHICH ELIZA KNOWS.
	3) DOCTOR.NUM - FOR EACH KEYWORD, THE CORRESPONDING
	   DOCTOR.NUM RECORD CONTAINS THE RECORD OF THE FIRST
	   REPLY FOR THIS KEYWORD, AND THE NUMBER OF REPLIES
	   AVAILABLE.
	4) DOCTOR.CON - THIS FILE CONTAINS CONJUGATES, AND THE
	   CONJUGATE'S PAIR IN THE NEXT RECORD.
***************************************************************************
***                                                                     ***
***                          WARNING				        ***
***                                      				***
*** SOME OF THE ENHANCEMENTS INCLUDED HERE WILL PROBABLY NOT RUN ON THE	***
*** RELEASE VERSION OF RSX11M V3.2 WITHOUT MODIFICATIONS.  AS THIS TAPE	***
*** IS RELEASED V3.2 IS STILL IN FIELD TEST AND UNDERGOING MODIFICATION.***
*** SINCE MOST ENHANCEMENTS ARE SUPPLIED AS SLP FILES, CHANGES TO THE	***
*** DISTRIBUTION MUST BE ACCOMPANIED WITH CHANGES IN THE SLP FILES.  	***
*** USERS ARE URGED TO CONTACT ME TO DISCOVER WHAT CHANGES IF ANY 	***
*** SHOULD BE APPLIED TO THE SLP FILES BEFORE USING.			***
***									***
***			JAMES G. DOWNWARD				***
***			KMS FUSION					***
***			3941 RESEARCH PARK DR.				***
***			ANN ARBOR, MICH. 48104				***
***			(313) 769-8500					***
***************************************************************************





        The following UIC's are part of the KMSF RSX11M  V3.2  Enhancements
   Package.
 
	[344,1]		README.1ST. Some documentation(most is in relevant
			UIC).  An FCS resident library suitable for use
			on RSX11M V3.2 system and for use with the provided
			command files for building utilities and EXEC tasks.

	[344,2]		A complete package of HELP files in the new V3.2
			HELP file format.
 
	[344,7]		Command files which will enable the user to keep
			documented backups of his/her system's disks using
			DSC, TSR, or BRU.  For each backup(either incremental
			or whole), a file on [1,7] is updated to show which
			disk, onto which tape was updated at a given time.
			Uses the V3.2 indirect file processor <TIME>  and
			<DATE> variables.
 
	[344,20]	A collection of ODL files suitable for building most
			of the RSX utilities with an FCS resident library.
 
	[344,24]	A collection of command files and ODL files suitable
			for building many of the EXECUTIVE privleged tasks
			with an FCS resident LIBRARY.  A FCS resident
			library suitable for V3.2. A collection of command 
			files suitable for building almost all the utilities
			with an FCS resident library. For those of us who
			build everything each SYSGEN, a prototype BATCH
			sysgen part 2 command file is provided.  SYSGENZ
			goes off and builds everyting, placing it on the
			target disk, then builds all the drivers.  If you
			know what you want it is faster and easier to
			understand than DEC's command file.
 
   	[344,40]	Terminal and disk accounting, privlege allocation,
   			modifications to HELLO and BYE, account utilities
   			and report programs. A task to monitor total system
			utilizaton(CPULOG) in the USER, EXEC, and NULL task 
			states.  An update to Greg Basset's ACCLOG (called 
			TSKLOG) suitable for V3.2 BL25). Mark Johnson's
			new, improved MAIL Utility. Run privlege checking
			and parameter passing for INSTALL.
 
	[344,42]	Courtesy of Art Perlo(YALE University) the SPY
			Accounting System is presented.  SPY uses a periodic
			sampling technique to gather its statistics.
			This is the same program package as offered by
			DECUS  _#11-372.  It is said to be suitable
			for an RSX11M V3.1 system although I have not as
			yet tried it.
    
   	[344,43]	Utilities. An enhanced version of Coleman's
   			CVL allowing the user to change most of the 
   			disk volume INI parameters. A Truncate utility,
   			a disk fragmentation utility, and a spool
   			queue display utility. As a bonus for all user's
			who have ever had a POOL run out, courtesy
			of the RSX11M group is POOL, the pool monitor
			which won't let you run out of pool if it can
			help it.  Also included is Fortran task which
			will force MCR command lines onto other terminals
			using the SPAWN directive, and a macro task(TCF)
			to decode a command line of ASCII octal numbers
			and send them to TI: as terminal control commands.
			(ie TCF 7 is ^G or BELL).
    
   	[344,45]	RSX11M V3.2 BATCH including Virtual Terminal support,
   			BATCH, and SUBMIT utilities, Batch Queue display,
   			documentation, and a Fortran callable subroutine
   			to interface  with VTDRV.
 
   	[344,60]	The KMS implementation of CCL, and Indirect
   			File Processor enhancements.
    
    

        A discription of all the modifications and enhancements and most of
   the  utilities is in ACNTNG.DOC.  The command file ACNTGEN.CMD will pro-
   vide all required information for building the  Accounting  Enhancements
   and a number of the other programs.

        After building the Accounting Enhancements, virtual  terminal  sup-
   port,  Batch,  and  the utilities, and the user is satisfied that all is
   working, the user may then procede  to  update  the  system  to  include
   CCL(console  command  language).  This will require a SYSGEN if the user
   elects to implement CCL via a PUTMCR executive directive.  CCL can  also
   be  implemented using an MCR driver(EDDRV) which does not require a SYS-
   GEN.  NOTE:  CCL requires F4POTS.OLB  for  getcommand  line  processing.
   Those  without F4P should have no problem bypassing this restriction and
   doing macro calls to GMCL.  The command file CCLGEN.CMD is  a  prototype
   to help the user build CCL into his system.  However, it is not as smart
   as ACNTGEN.CMD and will have to be tailored to fit the circumstances.

        The files ACCOUNT.TXT and BATCH.TXT are HELP format files for even-
   tual   use   with  the  HELP  processing  enhancements.   CCLAT.TXT  and
   EXAMPLES.TXT are Richard  Kirkman's  origional  documentation  for  CCL.
   CCL.DOC  and  CCLKMS.DOC provide information and a user's manual for the
   present implementation.

	RALPH STAMERJOHN
	MONSANTO
	800 N. LINDBERGH
	ST. LOUIS, MO, 63166

This UIC contains four packages: BCP, ERR VDX, and VTY. Each package
is described breifly below. The files belong to each package are listed
at the bottom of this file, along with a breif description of each.

	BCP - Binary Compare Program

The program was orignally developed to aid analysis of crash dumps. It
compares two files word-for-word and reports differences. The program
is written in Fortran-IV Plus. No documentation is available except for
the program source itself.

	ERR - Error Message Package

This package of macros and subroutines aids the processing of directive,
QIO, FCS, and program detected errors. The package uses the QIOSYM.MSG
file to provide meaningful messages to most error conditions. The package
is documented by ERRPKG.DOC.

	VDX - Virtual Disk Package

This is semi-weird, so bear with me. This package enables you to create
a disk on a part of another disk. The virtual disk is a contiguious file
of any size on the real disk. The virtual disk driver adds the starting
logical block of the file to any IO.WLB and IO.RLB requests issued to
it and passes the I/O packet on to the real disk driver. The virtual disk
(file) is INIed, MOUnted, and used like any other disk.

The program AVD assigns a file to a virtual disk unit and optionally can
create a file. The format of its commands are:

	>AVD VDn:=file[/sw]

		/CR:n	Create file of "n" blocks
		/RK	Create file of 4800 blocks
		/RO	Access file in readonly mode

The program DVD deassigns the file. Its command form is simply >DVD VDn:

The package is very useful for separating projects from each other and
avioding UIC and filename conflicts. We use it to easily setup and distribute
RK05 images from a system with only an RP06 and a magtape.

	VTY - Virtual Terminal Package

This package allows RSX-11M and DECsystem-10 systems to access other
RSX-11M systems using DECNET and enjoy all the privileges of a local
terminal user. The package implements psuedo-terminals for RSX-11M and
DECNET task to use the PTY's has virtual terminals. The PTY's could also
be used for other purposes. The package is documented by RSXVT3.DOC.

	DIRECTORY LISTING

AVDBLD   .CMD   (VDX)	AVD TASK BUILD COMMAND FILE
BCPBLD   .CMD   (BCP)	BINCMP TASK BUILD COMMAND FILE
BCPF4P   .CMD   (BCP)	BINCMP FORTRAN-IV PLUS COMMAND FILE
BCPGEN   .CMD   (BCP)	BINCMP GENERATION COMMAND FILE
DVDBLD   .CMD   (VDX)	DVD TASK BUILD COMMAND FILE
ERRASM   .CMD   (ERR)	ERROR PACKAGE ASSEMBLY COMMAND FILE
ERRGEN   .CMD   (ERR)	ERROR PACKAGE GENERATION COMMAND FILE
LTYBLD   .CMD   (VTY)	LTY TASK BUILD COMMAND FILE
VDDRVBLD .CMD   (VDX)	VDDRV TASK BUILD COMMAND FILE
VDXASM   .CMD   (VDX)	VDX ASSEMBLY COMMAND FILE
VDXGEN   .CMD   (VDX)	VDX GENERATION COMMAND FILE
VTIBLD   .CMD   (VTY)	VTI3 TASK BUILD COMMAND FILE
VTYASM   .CMD   (VTY)	VTY ASSEMBLY COMMAND FILE
VTYBLD   .CMD   (VTY)	VTY3 TASK BUILD COMMAND FILE
VTYGEN   .CMD   (VTY)	VTY GENERATION COMMAND FILE
DRDSP    .COR   (VTY)	RSX-11M V3.1 DRDSP PATCHES (SLP)
ERRPKG   .DOC   (ERR)	ERROR PACKAGE DOCUMENTATION
RSXVT3   .DOC   (VTY)	VTY PACKAGE DOCUMENTATION
BINCMP   .FTN   (BCP)	BINCMP FORTRAN-IV PLUS SOURCE
AVD      .MAC   (VDX)	AVD SOURCE
DIRERR   .MAC   (ERR)	DIRECTIVE ERROR PROCESSOR SOURCE
DRPTY    .MAC   (VTY)	VTY DIRECTIVE PROCESSING SOURCE
DVD      .MAC   (VDX)	DVD SOURCE
ERRLUN   .MAC   (ERR)	ERROR LUN SOURCE
ERRMAC   .MAC   (ERR)	ERROR MACRO DEFINITIONS
ERRORS   .MAC   (ERR)	MASTER ERROR PROCESSOR SOURCE
FCSERR   .MAC   (ERR)	FCS ERROR PROCESSOR SOURCE
GETMSG   .MAC   (ERR)	ERROR MESSAGE PROCESSOR SOURCE
LTY      .MAC   (VTY)	LTY SOURCE
PRGERR   .MAC   (ERR)	PROGRAM ERROR PROCESSOR SOURCE
PTYMAC   .MAC   (VTY)	PTY DIRECTIVE MACRO DEFINITIONS
PTYTB    .MAC   (VTY)	PTY DEVICE TABLE SOURCE
QIOERR   .MAC   (ERR)	QIO ERROR PROCESSOR SOURCE
VDDRV    .MAC   (VDX)	VDDRV SOURCE
VDPRE    .MAC   (VDX)	VDDRV PREFIX MODULE
VDTBL    .MAC   (VDX)	VDX DEVICE TABLE SOURCE
VTI3     .MAC   (VTY)	VTI3 PREFIX FILE
VTY3     .MAC   (VTY)	VTY3 SOURCE
RSXVT3   .M10   (VTY)	RSXVT3 MACRO-10 SOURCE
ERRPKG   .RNO   (ERR)	RUNOFF FORM OF ERRPKG.DOC
RSXVT3   .RNO   (VTY)	RUNOFF FORM OF RSXVT3.DOC
THE FOLLOWING UIC'S ARE USED:
 
[355,101]	RSX11M PRINT SPOOL QUEUES LISTER
		IMPROVED TO LIST UIC'S
[355,301]	BNR UTILITY PACKAGE. IN DECUS LIBRARY.
 
NOTES ON UTILITY PACKAGE.
 
1)	VERSION HAS A FEW CORRECTIONS OVER THE DECUS LIBRARY VERSION.
	SLP .COR FILES SHOULD BE APPLIED FIRST.
2)	.LST FILES ARE DOCUMENTATION. THEY MUST BE TAKEN OFF A TAPE WITH
	THE FLX /FC SWITCH AS THEY HAVER ANSI CARRIAGE CONTROL.
3)	AFTER READING IN INSTALLATION PROCEDURE IS:
	11M)  @11MUTIL
 
	IAS)  EDIT JOB CARD IN IASUTIL.BIS
	      SUBMIT FILE TO BATCH
 
	11D)  EDIT JOB CARD IN 11DUTIL.BIS
	      SUBMIT FILE TO BATCH.
 
 	IAS BATCH WAS LAST USED UNDER VERSION 2
	11D BATCH WAS LAST USED UNDER VERSION 6B






        The following is a description of files contributed by:

  
           AERONAUTICAL RESEARCH ASSOCIATES of PRINCETON (A.R.A.P.)
           
  Box 2229, 50 Washington Road
             Princeton, N.J.  08540
           
  (609) 452-2950

        Any inquiries should be directed to John D. (Len) Le
onard.

        A.R.A.P.  configuration
             11/70, 320kw, TU16, 3 RP
06's
             FORTRAN IV-PLUS is the default compiler (FOR) and all  .FTN
             files are F4P code and should be compiled as such.
             Cu
rrently running IAS VS 3.0

             All of the following  files  are  on 
 [360,*].   Note  that
             ARAP.OLB  is  needed  for  most  all task b
uilds.  Also, on
             [360,205] RENAME.CMD must be executed to rename s
ome of the
             files from 6 letters to 6+ letters.


        [360,2
00]ARAP  - Contains ARAP.OLB  and  associated  source  for
                    
    routines  contained in ARAP.OLB.  These routines
                        ar
e of general interest.  ARAP.FTN is  a  conca-
                        tenated 
source file of all .FTN modules.


        [360,205] Indirect MCR procedures 
and PDS command procedures.

        BACKUP.CMD    - Automation of PRESERVE an
d DSC disk-disk  weekly
                        backup procedures, uses VOLID.


        INITIAL.CMD   - Initialize disk, uses LBN.

        NEWUSER.CMD   -
 Create new PDS user, see also NEWUSER.MCR.

        TARGETGEN.CMD    - Genera
te system on  user  packs  from  master
                        system pack.


        and for fun listings -

        TUIT.LST      - Now there is no excus
e.

        PSU.LST       - Keep your Computer room on the lighter side.


 
       Program Abstracts                      -2-



        [360,210]FDUMP 
- File dump, produce  OCTAL-ASCII-RAD50  listings
                        a'la 
  IBM  360.   See  FDUMP.FTN  for  doc  and
                        FDUMP.CMD t
o build.

        [360,210]LBN   - Logical Block Number.  Assists in pack init
ial-
                        ization  and  tracking  of  bad block data.  See
                        LBN.RNO  and  LBN.CMD  for  build.    See   also
      
                  INITIAL.CMD.

        [360,210]RESET - Reset 'blocks used' c
haracteristic  for  locked
                        and  aborted  files, e.g., 0
/106 used/allocated.
                        See RESET.FTN for doc and RESET.CM
D to build.

        [360,210]VOLID - Change volume ID, used at A.R.A.P.  to  
correct
                        volume ID's destroyed by DSC.  See VOLID.FTN fo
r
                        doc and VOLID.CMD for build.

        [360,210]WHOM
M - Who's on the tape drive!!?   Will  need  slight
                        mod
ification  for  devices other than MM0:.  See
                        WHOMM.MAC
 for doc and WHOMM.CMD to build.   Note
                        that  IASWHO.MA
C  on  object distribution of IAS
                        3.0 also reports moun
ted volumes.

        [360,210]F4PRES- Files needed to build 4k F4P  resident 
 library
                        used  at  A.R.A.P.   See  F4PRES.CMD for doc a
nd
                        build.  See also MEMO2.RNO for a  discussion  of
  
                      resident   libraries  in  light  of  SYSRES  and
        
                F4PRES.


        Program Abstracts                      -3-



        [360,220]BAN   - Create user  banner.  Allows  user  to  specify
                        banner  headings.     Used  mostly  for deferred
      
                  printing.  See BAN.RNO and BANBLD.CMD to compile
            
            and  link.  See also BANTST.CMD, the banner test
                  
      program.  SAMPLE.BAN is an example of  BAN  out-
                        
put.


        [360,230]SFS   - Search   Fortran   Source.  Fortran    variab
le
                        cross-reference  provides  list  of variable and
  
                      routine  reference,  total  variables  and  text
        
                listing  of statements where referenced.  Global
              
          cross references for up to  100  routines.   See
                    
    SFS.RNO  and SFSBLD.CMD to build.  SAMPLE.SFS is
                        an
  example   SFS   listing.    TEST01.SFS   and
                        TEST02.S
FS are sample SFS runs.  


        [360,240]SSD   - SSD consists of the  pro
gram  SSD  and  FORTRAN
                        callable  AST routines.  SSD al
lows pseudo-sense
                        switches and data to be sent to a FOR
TRAN  task,
                        permitting   run-time  control  of  time-sh
aring
                        tasks.   See  SSD.DOC  for   more   detail   and

                        SSDBLD.CMD to build.


	THESE PROGRAMS IMPLEMENT A CORE DUMP FACILITY FOR
RSX-11D AND IAS, FOR USER TASKS (RATHER THAN CDA WHICH ONLY
ANALYSES SYSTEM CRASHES). IT IS USEFUL FOR FINDING BUGS IN
PROGRAMS WHICH ARE "ALREADY" DEBUGGED BUT ABORTED UNEXPECTEDLY
(AND UNDER POSSIBLY UNKNOWN CONDITIONS), FOR PROGRAMS WHICH
CANNOT RUN UNDER ODT FOR VARIOUS REASONS, OR FOR FINDING
HARDWARE MEMORY ERRORS NOT OCCURRING AS PARITY ERRORS. IT
IS NOT INDENDED AS A REPLACEMENT FOR ODT OR DDT WHICH ARE
INTERACTIVE DEBUGGING TOOLS AND WHICH IN MOST CASES ALLOW
MUCH FASTER DEBUGGING THAN IS POSSIBLE WITH SUCH A DUMP FACILITY,
WHICH IS MORE LIKE A BATCH STREAM DEBUGGING TOOL THAN MOST
RSX SOFTWARE.
 
	THE CORE DUMP SYSTEM CONSISTS OF TWO PARTS, A SUBROUTINE
TO .TKTN. WHICH DUMPS APPROPRIATE ABORTING TASKS' IMAGES INTO
BINARY FILES, AND AN ANALYSIS PROGRAM WHICH WILL FORMAT THE OUTPUT
INTO A MORE READABLE FORM.
 
	LOG IN TO A SYSTEM OR PRIVILEGED ACCOUNT, REFERRED TO AS
[?,?]. TO INSTALL THE SYSTEM, IT IS FIRST NECESSARY TO
ASSEMBLE THE FIXES TO .TKTN.. EDIT THE FILE 'DMPCOR.MAC'.
ON THE THIRD PAGE ARE A NUMBER OF ASSEMBLY PARAMETERS
REGARDING THE PRECISE TYPES OF TASKS WHICH WILL BE DUMPED,
THE TYPE OF INFORMATION TO DUMP, AND WHERE TO PLACE THE
DUMP FILE. THERE IS ALSO A SELECTION FOR A SOURCE LEVEL OR AN
OBJECT LEVEL CHANGE TO .TKTN.;  IF YOU DO NOT HAVE SOURCES OR
DO NOT WISH TO MAKE A SOURCE LEVEL CHANGE THE SYMBOL 'PATCH'
MUST BE DEFINED.
 
	AFTER THESE CHANGES HAVE BEEN MADE, ASSEMBLE THE FILE:
		MCR>MAC DMPCOR,LP:/LI:TTM=DMPCOR
NEXT:	1) IF YOU ARE MAKING A SOURCE LEVEL CHANGE, EDIT THE
	   FILE [311,13]TKTN.MAC. LOCATE THE LINE BEGINNING
	   WITH 'START:'. AFTER THAT SYMBOL, BEFORE THE
	   LINE 'ATLSCN:  MOV    PSEXP,-(SP)', PLACE AN INSTRUCTION
	   'CALL   DMPINI'. NEXT FIND THE LINE 'MOV   #"SP,TMPL2+2'.
	   FIND THE NEXT CALL TO 'TYPREG' AFTER THAT LINE AND PLACE
	   AN INSTRUCTION 'CALL   DMPCOR' AFTER THE CALL TO TYPREG.
	   EXIT THE EDITOR AND ASSEMBLE .TKTN.:
		MCR>MAC TKTN,LP:/LI:TTM=[311,13]TKTN
	2) IF YOU ARE MAKING AN OBJECT LEVEL PATCH, ASSEMBLE THE
	   MODULE 'TKTNPAT.MAC':
		MCR>MAC TKTNPAT,LP:/LI:TTM=TKTNPAT
	   NOW APPLY THE PATCH FILE TO [11,13]TKTN.OBJ (IT MIGHT BE
	   A GOOD IDEA TO KEEP A COPY IN CASE OF MISHAP).
		MCR>INS [11,1]PAT
		MCR>PAT TKTN=[11,13]TKTN,[?,?]TKTNPAT
 
	NOW BUILD .TKTN., REMOVE .TKTN. AND RE-INSTALL:
		MCR>TKB @TKTN
		MCR>REM .TKTN.
		MCR>INS TKTN

	NOW IT IS TIME TO BUILD THE CORE DUMP ANALYSIS
TASK. THE DEFAULT PAGE SIZE CAN BE MODIFIED BY CHANGING
THE SYMBOL 'PAGSIZ' ON THE SECOND PAGE;  THE CURRENT
DEFAULT IS 59. THERE ARE NO OTHER CONDITIONAL ASSEMBLIES, SO:
		MCR>MAC COREANL,LP:/LI:TTM=COREANL
		MCR>MAC PRFCS,LP:/LI:TTM=PRFCS
		MCR>TKB @COREANL
		MCR>INS COREANL
 
	THE CORE DUMP ANALYSIS TASK IS NAMED ...COR. IT
HAS TWELVE SWITCHES EXPLAINED IN MORE DETAIL ON PAGE 1 IN
THE ASSEMBLER SOURCE FILE:
 
	/R5	DUMP RADIX 50 ON TASK CORE
	/BY	DUMP IN BYTE MODE BINARY;  /-BY DUMPS WORD MODE
	/AS	PRINT ASCII AS WELL AS BINARY
	/N5	NO RADIX 50 EVEN ON SYSTEM TABLES
	/RO	DUMP TASK READ-ONLY SECTION (ONLY IF THERE)
	/CM	DUMP COMMON AREAS (LIBRARIES ONLY IF /RO ALSO)
	/RW	DUMP TASK READ/WRITE SECTION
	/SY	DUMP SYSTEM TABLES
	/HD	DUMP TASK HEADER
	/SP	SPOOL LISTING FILE AND DELETE WHEN DONE.
	/MD:X:Y	DUMP TASK CORE FROM ADDRESS X TO Y.
	/PS:X	PAGE SIZE IS TO BE X.
 
DEFAULTS: /-R5/-BY/AS/-N5/-RO/-CM/RW/SY/HD/SP/MD:0:177777/PS:59
 
	THE PROGRAM WILL NOT ATTEMPT A CORE DUMP IF
A FAULT OCCURRS WHICH DOES NOT PRINT THE REGISTERS
(I. E., DISK READ ERR, DISK WRITE ERR, VIA 'EXIT' WITH PENDING
I/O, MEMORY PARITY ERROR)
 
	ONE WORD OF CAUTION: THE EXEC AND .TKTN. USE THE
A.FM+0 WORD IN THE ATL NODE OF AN ABORTING TASK TO HOLD
THE TERMINATION CODE, AND THE TASK'S STATUS IS ALWAYS
'SUSPENDED FOR TERMINATION MESSAGE', SO THERE IS NO GETTING
THE TASK'S EVENT FLAG MASKS 1-16 OR THE CURRENT OR AST
STATUS OUT AFTER A DUMP !!!

	THESE PROGRAMS HAVE A FEW KNOWN DEFICIECNIES, BUT
NO GREAT DIFFICULTIES SHOULD BE ENCOUNTERED BECAUSE OF THEM:
 
	1) THE PROGRAMS DO NOT HANDLE I/D SPACE. IF IT IS
	   EVER IMPLEMENTED, THE .TKTN. SUBROUTINE PROBABLY
	   WOULD NOT NEED TO BE MODIFIED, BUT THE COREANL
	   PROGRAM (PARTICULARLY THE "GETPDR" SUBROUTINE)
	   WOULD. THIS DOES NOT SEEM SERIOUS AT THE PRESENT
	   TIME.
	2) MORE IMPORTENTLY, NEITHER PROGRAM IMPLEMENTS
	   THE PLAS FEATURE. I AM NOT SURE HOW THAT FEATURE
	   WILL LOOK, AND I HAVE NOT HAD A CHANCE TO GET AN
	   IDEA. PROBABLY THE .TKTN. SUBROUTINE COULD BE
	   LEFT UNMODIFIED, AND THE COREANL PROGRAM CHANGED
	   (POSSIBLY IN "GETPDR") TO FIND THAT PART OF THE
	   PROGRAM WHICH WAS MAPPED INTO THE ADDRESS SPACE AND
	   DUMP THAT AT THE APPROPRIATE ADDRESS. ALSO, A METHOD
	   FOR GETTING OUT THE PART OF THE PLAS NOT MAPPED INTO
	   THE TASK SPACE WOULD BE OF INTEREST.
