This directory contains a number of utilities and subroutines
which are likely to be of interest to a substantial proportion
of the RSX/IAS community.  The submission is oriented towards
IAS, but much of the software will run on RSX-11M or RSX-11D
with minimal to no changes.  Where possible, software restricted
to IAS is noted as such in the below list.  The major submissions
in the directory are:
 
Complete programs
 
ADDBAD	- Adds bad blocks to the bad block file (BADBLK.SYS) without
	  requiring volume re-initialization.
AFT	- Prints all of the file names on a volume modified after
	  a specified date.  This was originally written when we
	  had a disk hardware problem and wanted to recover as
	  many files as we could from a rather corrupted disk.
ASG	- This task will reassign the logical unit numbers of a
	  task image without requiring the user to re-taskbuild
	  with different ASG directives in the command file.
ASN	- This IAS-only task implements assignable logical devices
	  for IAS similar to the VAX/VMS ASSIGN command or the
	  RSX-11M ASN command.
BLK	- Locates the file which has a specific physical block
	  allocated.  Useful when there is a block showing up as
	  bad in the error log which can be removed from circulation
	  by moving the file and running 'ADDBAD' on the block.
CANALL	- This IAS/RSX-11D only task will cancel all of the copies
	  of a multi-user task on all terminals in the system.
COMP	- Compares two files on a block-by-block basis rather than
	  the line-by-line basis used by CMP.
COR	- This is an IAS/RSX-11D package to take postmortem task
	  dumps in a manner similar to the postmortem system dump
	  provided by CDA.  It also uses a patch to .TKTN. with a
	  subroutine named DMPCOR.  This is the same program which
	  was submitted to an earlier DECUS tape, updated to run
	  under IAS V3.1 to use the new Executive data structures
	  properly.
CPY	- Copies files 63 blocks at a time for a faster transfer
	  than PIP provides.
DAC	- Sums up the disk space used by each UIC on the disk.
DELFID	- Removes a file by file ID even if the file has a bad file
	  header.  This allows such files to be deleted without
	  having to ZAP the INDEXF.SYS file manually or running DSC.
DUMPCORE - An IAS/RSX-11D task which will dump the memory of a
	  running task.  This was originally written by Ray French,
	  and the current version is modified to be able to run with
	  the "COR" package noted above.
DVL	- An IAS/RSX-11D only task to display device information.
EXEMCR	- An RSX-11D only task to execute an MCR command line.
FIL	- A utility which tries to reconstruct locked files.
FRG	- Prints out disk space fragmentation information.
	  This is a corrected and enhanced version of the FRG
	  which was on the DECUS tape some time ago.
GREP	- A utility for locating search patterns within a group
	  of files.  This is a much enhanced version of the GREP
	  which appeared in an earlier DECUS tape.
IRF	- This IAS/RSX-11D task will attempt to gracefully exit
	  a task which has an I/O rundown failure.
MCM	- This IAS-only task sets the terminal into real MCR mode
	  (not the MCR mode in PDS).
MCX	- This IAS-only task is a companion task to MCM to return
	  the terminal to DCL.
MUNG	- This IAS-only task is a companion task to the ASN task
	  mentioned above.
PRECIS	- This is an enhanced DMP-like utility which produces a
	  more useable listing.
READTAPE - This allows fast reading of magnetic tape by using
	  large buffers and multi-buffering the drive.  The full
	  benefit of this is probably not felt under RSX-11M, but
	  would be under systems supporting multi-buffering (IAS,
	  RSX-11D, and RSX-11M/PLUS (?))
SPW	- This IAS-only task will monitor the progress of the
	  despooler in printing your file.
STAT	- This IAS-only task uses the CRT to produce a bar graph
	  detailing system usage.
STF	- This IAS/RSX-11D task is an MCR command line stuffer task.
SUPERWHO - This IAS-only task displays system users on the CRT.
TAPEIMAGE - This task allows disk images to be moved between
	  non-ANSI magtapes, files, and Foreign disk volumes.
TAPUTL	- Installed with various names, this task will allow the
	  user to manipulate a non-ANSI magtape by rewinding it,
	  spacing forward, backward, etc.
TMR	- This IAS-only task will time the execution of a target
	  task and print out a summary of where it is spending
	  its time for performance improvement or monitoring.
TPC	- A task to copy magnetic tapes, EOF marks and all.
	  This is a corrected and enhanced version of the TPC
	  which has appeared in the DECUS library before.
TRANSLATE - RT-11 supports ANSI magtape but it produces a format
	  which isn't palatable to RSX/IAS systems.  This program
	  will convert a file transferred from an RT-11 magtape
	  into something useful on a Files-11 system.
UNDELETE - This task will undelete a file under certain restrictions.
USP	- This IAS-only task will unspool a line printer without
	  requiring that the SP0: device be dismounted.
UTX	- This IAS-only task is a modification of the same task
	  which appeared on an earlier DECUS tape to use the screen
	  formatting package.
VOL	- This allows modification of disk volume names and other
	  characteristics.
WHO	- This IAS-only task is an enhanced version of a program
	  submitted to an earlier DECUS tape to display terminal
	  usage.
 
Subroutine library
 
BIOMAC	- This is a set of structured programming macros.
CTLIMP	- This subroutine sets a file to carriage control implied
	  for the FOR compiler.
DELETE	- This subroutine will delete a file from a Fortran program
	  compiled with the FOR compiler.
DIRDL	- This executes a directive with retries on nonexistant pool
	  space.  It is used by many of the above tasks.
MTYPE	- This subroutine returns the machine type.  It is currently
	  written for IAS but modifying it to run on RSX-11M should
	  be trivial.  It is used by some of the above tasks.
NOLOCK	- This subroutine will notify FCS not to lock a file on
	  abnormal termination of a program compiled with the FOR
	  compiler.
PRFCS	- This subroutine prints the FCS or DSW error code for an
	  error.  It is used by many of the above tasks.
PRTIME	- This subroutine returns a character string giving the
	  current date and time.  It is used by many of the above
	  tasks.
RFILN	- This subroutine will read the characteristics of a file and
	  obtain its name, which it returns as a string.  It is used
	  by many of the above tasks.
SCRPKG	- This is a screen formatting package which allows terminal-
	  independent screen addressing.  It is patterned after the
	  package on the VAX and on a package on the PDP-11 which
	  requires that the calling program be written in PL/I.  This
	  will work with almost any language, and is used by some of
	  the above tasks.
SPOOL	- This is a subroutine to spool a file to the printer from a
	  program compiled with the FOR compiler.
PRINT	- This is a subroutine which makes printing readable output
	  from an assembler subroutine or program less painful.  It
	  takes care of all conversion problems and calling the
	  appropriate QI/O system services.
YMPRINT	- This is the macro which sets up the call to the PRINT
	  subroutine.
