File Name
README.md
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.