README.md
Sandia National Laboratories BAYLUG
Division 8411, SNLL
Livermore, CA, 94550
D.C.Pulsipher (415)422-3141
C.H.Stockley (415)422-2482
22-NOV-82
This UIC contains several things we have found useful.
Most of them were originally written by others and have been included
in previous DECUS tapes. These versions have been updated for RSX-11M V4.0
and changed in various ways from the original submissions.
They include:
MC2 -- A CATCH-ALL task which takes advantage of INSTALL,
MCR, and EXEC modifications to do "flying installs"
which accept command lines. The most significant
system changes required are:
1) Allow multiple copies of a task
to be run from a single terminal.
2) Modify INSTALL to allow tasks to
be installed marked for removal
after running, but not run at that
time.
SLP files to modify MCR, and INSTALL as required for above changes.
These files also make other changes. (See below for details.)
SLP files to modify ICP. (This is independent of all above changes.
-- These changes are required if /QU switch support for
MC2 is expected.
WHO -- A task to display logged-in users.
CPA/OPA -- Tasks to display EXEC data structures found in POOL
for Crashed/Online systems.
These programs and changes are described individually in greater detail
below.
---------------------------------------------------------------------------------
MC2
These modifications have been made to upgrade support for the catch-all
task MC2 for RSX11M V4.0
The original version of MC2 for RSX11M V3.2 was written by
Greg Thompson (DEC SWS) NASA/Ames 7/21/80
and was included in NASA/Ames BAYLUG DECUS tape.
Changes to MC2 include:
Using the new RPOI spawn directive
Addition of a new ICP /QUiet switch (in-place-of /-LI switch)
If an indirect command file with a .CDF extension is specified
it is passed to MCR as @filename.CDF/QU (Quiet mode)
**** A NOTE OF WARNING ****
MC2 is definitely meant for use in a friendly environment.
The changes made to INSTALL open a small loophole through
which unprivileged may pass to run privileged programs
if they study the code carefully.
**** You may want to modify the UIC search path. ****
(Ours is rather lengthy.)
**** DO make sure that the characteristics of each ****
entry in the path are set the way YOU want them.
**** Please read the comments in the source file. ****
The ICP mods are independent of MC2 mods but are needed if the
if MC2 mods are selected.
============================================================================
DESCRIPTION of the files found on this UIC
============================
Files included:
A new SYSGEN is not required if ZAP is used to modify the
EXEC module DREIF. (See DREIF.SLP for the one change.)
All other modifications can be made and task-built after SYSGEN2
============================
The MC2 modifications have been divided into two groups:
1. ICPMODBLD.CMD | These two .CMD files accept a
| P1 parameter of "NO" which says
2. MC2MODBLD.CMD | "Do not update .OLB libraries now."
| **** Please read these .CMD files. ****
SNLL01 Make .ENABLE/.DISABLE defaults easier to modify.
Change initial .ENABLE / .DISABLE defaults:
.ENABLE GLOBAL
.ENABLE SUBSTITUTION
SNLL02 Add '/QU' Quiet switch. (/-QU is invalid.)
(The previous DECUS mod '/-LI' switch to V3.2 is not supported.)
SNLL03 Don't display '@<EOF>' in QUIET mode.
SNLL04 Display ';*' comments in QUIET mode.
The following UIC's are used:
[12,25] ICPMODBLD.CMD command file to do the modifications
ICPMODS.ASM MAC assembly command file
xxx.OBJ objects (temporary)
ICPMODOBJ.OBM concatenated object module to update ICP11M.OLB
[12,41] MC2ICPMOD.SLP modifications
[12,11] xxx.MAC;2 for source files that have been SLP'd
Modules:
DREIF (Exec module) Note: This modification can be put in using
ZAP, and therefore not require a new SYSGEN.
(It's just a 1 bit change.)
**** DREIF.MAC;2 is still in [11,10] ****
**** Note: SPSOV normally gets ASM'd in SYSGEN: MCR (subset) assembly
and /RP in MCR.OLB during SYSGEN2
SYSROT ([1,24]SYSROT.OBJ) Not included in MCR.OLB
INS.OLB:
INSHD, INSLB, INSPS
**** MCR & INS will need to be re-TKB'd.
Modifications:
SNLL05 Add MC2 support.
SNLL06 Don't change U.LUIC on SET /UIC so "WHO" task will always
indicate the correct User-ID.
SNLL07 Change syntax on SET command to: SET [/]KEYWORD
SNLL08 Provide more info for some Error Msg's
The following UIC's are used:
[12,25] MC2MODBLD.CMD command file to do the modifications
MCRMODS.ASM MAC assembly command file for INS mods
INSMODS.ASM MAC assembly command file for MCR mods
xxx.OBJ objects (temporary)
MC2MODMCR.OBM concatenated object module to update MCR.OLB
MC2MODINS.OBM concatenated object module to update INS.OLB
[12,41] MC2MCRMOD.SLP MCR modifications
MC2INSMOD.SLP INS modifications
INSBLDBLD.SLP INSBLD.BLD Modification
[12,11] xxx.MAC;2 for source files that have been SLP'd
MC2.MAC source file
[12,35] xxx.LST for Listings
NOTES:
------
** WARNING ** INS module INSCM (Install Common Block) contains a
** section of code that temporiarly re-maps APR6 of
** its virtual address space to load the Common Block.
** This section of code MUST fall before virtual address
** 140000 or INS will terminate when attempting to
** install a common block. Inserting the MC2 mods
** caused this problem so the position of INSCM in the
** TKB command file was changed to load this module at
** an earlier virtual address. (INSBLDBLD.SLP)
==============================================================================
WHO WHO is logged-on (WHO.ASM & WHO.TKB) (Privileged)
The task WHO was originally written by Greg Thompson.
This version has been modified to show login UIC & current UIC
and needs the MC2 set of mods to show privileged users'
login UIC properly.
============================
The tasks OPA & CPA were originally written by J. Neeland.
These versions have been modified and updated for RSX11M V4.0
CPA CrashDump Pool Analyzer (CPA.ASM & CPA.TKB) (needs RSX11M.STB)
Contains several switch options to disable processing
of certain data structures if Pool has been corrupted,
also handy for debugging new additions to CPA.
OPA OnLine Pool Analyzer (OPA.ASM & OPA.TKB) (Privileged)
**** WARNING **** OPA can crash your system so test it out
at a time that you can afford to crash.
==============================================================================