
Submitted by:

	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.

		See TTIO.RNO for details.
