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.