Rick Webster
Caterpillar Tractor Co.
Mail stop: AD235
600 West Washington St.
East Peoria, Il. 61630
This UFD contains the 1983 Spring DECUS Symposium Tape submission from
Caterpillar Tractor Co. It contains mostly fixes or re-writes of software
submitted by others on previous RSX SIG tapes as well as some original
stuff.
The following software is provided on an "as is" basis only.
Caterpillar Tractor Co., disclaims all warranties on the programs, including
without limitation, all implied warranties of merchantablity and fitness.
Note: FILES.DOC lists the files in this distribution and identifies which
of the following catagories they fall in.
Documentation - RNO and HELP files created at Caterpillar have been included
and HELP for all the utilities in this distribution. In addition,
files there is a RNO help file and VT100 and LA120 help files
(operator's reference cards). Also included is RNO.TSK
in case your version of RUNOFF isn't the same as ours.
Build command - Individual build command files are supplied for each utility.
files Also included is a master command file, BUILDALL.CMD which
will allow you to selectively build all utilities. Before
building any utilities, you will have to copy several files
to this UFD from an RSX11M V4.0 distribution kit.
For WHO we need a patched or unpatched MLTUSR.OLB
and MCR.OLB
For COR we need an unpatched SHUFL.MAC which has been
renamed to SHUFL.VGN
For CONFIG we need an unpatched SGNPER.CMD
CONFIG.CMD - This command file is used in conjunction with the command files
CONFIG1.CMD and CONFIG2.CMD. It is used to give a sysgen-like
listing of a saved answer file. The output looks similar to the
SYSGEN printout when the saved answer file was originally
created.
The command files must be on the current default device and UIC
to function properly but the input saved answer file can be
anywhere. To use CONFIG, do the following:
>@CONFIG saved-answer-file output-file
where: saved-answer-file is the name of your save answer file
output-file is the name of the file to contain the
sysgen listing (Default is TI:)
If either are un-specified on the command line, you will be
prompted for them. If output is directed to a file, it will
also be printed on TI:
The output will contain the appropriate SYSGEN question with
the response that is in the saved answer file along with the
appropriate symbol name used in the saved answer file.
Note: You will need a copy of SGNPER.CMD from an unpatched
RSX11M V4.0 distribution kit. CONFIG2.CMD must be
created prior to running CONFIG. This is done with
a SLP correction file to SGNPER.CMD as follows:
SLP @CONFIG2.COR
MERGE.CMD - Command file to create concatenated RSX11M V4.0 listings
with a cross-reference. This was inspired by the command
files submitted by Ralph Stamerjohn on the Fall '80 tape
for RSX11M V3.2 but this one uses EDT instead of TECO.
In addition, it will also give concatenated listings of
EXCOM1, EXCOM2 and LDR if your system uses them.
To use it:
1) Enter @MERGE
2) You will be prompted for the device that contains the
Executive and Driver sources and the device that contains
you system.
3) MERGE will ASN to you system disk and set the UIC to
[1,34]
4) Note that an EDTINI.EDT file is created there and later
deleted, so if you have any EDTINI.EDT files in [1,34]
they will also be deleted.
5) MERGE will read your RSXBLD.CMD to determine how to merge
the sources and whether you have executive commons or not.
Then PIP will be used to merge the sources, EDT will then
run to massage the initial merged sources and finally MAC
and CRF will run to create the listings.
EDTINICLS.CMD - This is a Computer Managed Instruction course (CMI) on the
advanced usage of EDT initializer files. It uses the EDTINI
file described by David Spencer of Infinity Software Corp.,
in the Nov. 1982 issue of the DEC Professional Magazine, as
an example of an initializer file and goes through a detailed
description of how that file works. Part of the tutorial is
driven by indirect and part is driven by EDT itself so that
the new commands can be tried as they are described. In
addition, this command file provides an excellent example
of how the new features in V4.0 Indirect have really made
Indirect an interpretive programming language that allows
you to edit and test code with no intervening assembly,
compilation or task build.
This command file can be executed from anywhere as long
as there is a UFD there to create temporary files. We put
it on a training disk and have a CCL command (EDTINI) which
translates to "@VD1:[200,206]EDTINICLS"
Note: This will only run on a VT100 or VT100 look alike.
Also the command file EDTINISAM.CMD must be run
prior to running the tutorial, to create the sample
initializer file EDTINICLS.SAM. This was necessary
since the initializer has imbedded carriage control
and FLX screws up the file. By creating the file
with Indirect, I could hide the carriage control
from FLX.
TCF - Utility to send any octal string to any terminal. This is a
re-write of a program that was submitted on a previous SIG
tape. It still works the same as the original version but
has a number of additional capabilities. These include the
following: Indirect command file input, directing sequences
to another device, passing ASCII strings in command line,
upper and lower case support on command line, large letter
output similar to the print spooler's flag pages. See TCF.RNO
for details.
Virtual Disk - This software was obtained from Ralph Stamerjohn's submission
on the New Orleans, Spring '79 DECUS symposium tape,
UIC [346,100]. The virtual disk package has been extensivly
modified and enhanced. AVD and DVD have been modified to
provide new functionality and two new utilities were added,
VDA and VDC.
In addition, enhancements were provided to allow the virtual
disk driver to keep track of the number of qio's occurring on
each unit since the last system boot. Three utilities are
provided to allow a user to display this information.
These are: VDQIO, VDQ and VDRPT.
Virtual disks are in wide use here at Caterpillar and have
been a real life saver. Thank you very much, Ralph.
See VD.RNO for details.
WHO - Task to display logged on users. This software was originally
obtained from the New Orleans, Spring '79 DECUS symposium tape,
UIC [301,25]. It has been modified to use the user subroutine
option of HELLO and BYE rather than SLP corrections, to make
it easier to implement on new releases of RSX11M.
To build it, you will have to put a copy of MLTUSR.OLB and
MCR.OLB in this UFD. The new versions of HEL and BYE will
have file names of HELLOTCM.TSK and BYETCM.TSK.
To use WHO, install the TERCOM common, install TLOGGR and WHO,
remove ...HEL and ...BYE and install HELLOTCM and BYETCM.
See WHO.RNO for details.
COR and SPC - allow creation of partitions on the fly from the GEN.
SPC is a modified DEC shuffler SHF... which is used by COR to
unconditionally shuffle the GEN partition. You will need
a copy of SHUFL.MAC from an unpatched RSX11M V4.0 distribution
kit, in this UFD with a file name of SHUFL.VGN in order to
build SPC.
See COR.RNO for details.
OPA - Online system POOL Analyzer. Obtained from the San Diego,
Fall '80 DECUS symposium tape, UIC [301,31]. It contains
a number of fixes over the original. See the release notes
in OPA.RNO for details. This has been a very useful program
to us at Caterpillar and I would like to thank Jim Neeland
for the original submission.
UND - Utility to un-delete all deleted files in a particular UIC.
Obtained from the Atlanta, Spring '82 DECUS Symposium tape.
UFD [312,14]. This version has some minor bug fixes and
the error messages have been enhanced.
See UND.RNO for description
REI - Reincarnate specific deleted or undeleted files who have
corrupted file headers. Obtained from the Los Angeles,
Fall '81 DECUS symposium tape, UFD [307,22]. This version
has minor bug fixes and enhanced error messages.
See REI.RNO for description
HOL - Utility to display a map of the free areas on a FILES-11 disk.
Originally obtained from the Miami, Spring '81 DECUS symposium
tape, UIC [373,20]. It has been modified to display logical
block numbers in decimal (instead of octal) but with the
option to display in octal. We use this program a lot when
trying to place Virtual disks on our large disks that have
bad blocks. The Virtual disk package in this UFD allows
placement control through the /PL switch, allowing us to
put VD:'s on a disk in the most efficient manner.
See HOL.RNO for details.
TTIO - Routines and macros to do terminal I/O. Used by VDA routine in
the Virtual Disk package.