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