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: README.1ST CPA.ASM;2 1. 19-NOV-82 ICPMODS.ASM;6 2. 19-NOV-82 INSMODS.ASM;3 1. 18-NOV-82 MCRMODS.ASM;3 4. 18-NOV-82 MC2.ASM;4 1. 18-NOV-82 OPA.ASM;4 1. 19-NOV-82 WHO.ASM;4 1. 26-OCT-82 ICPMODBLD.CMD;14 2. 19-NOV-82 MC2MODBLD.CMD;20 3. 19-NOV-82 XFERMODS.CMD;2 2. 19-NOV-82 CPA.MAC;74 103. 26-OCT-82 MC2.MAC;15 88. 19-NOV-82 OPA.MAC;35 78. 22-OCT-82 WHO.MAC;5 22. 22-APR-81 DREIF.SLP;3 1. 19-NOV-82 INSBLDBLD.SLP;2 1. 19-NOV-82 MC2ICPMOD.SLP;10 8. 19-NOV-82 MC2INSMOD.SLP;2 6. 18-NOV-82 MC2MCRMOD.SLP;30 25. 19-NOV-82 CPA.TKB;13 1. 19-NOV-82 MC2.TKB;4 1. 18-NOV-82 OPA.TKB;12 1. 19-NOV-82 WHO.TKB;7 1. 26-OCT-82 HOW TO USE the files ==================== The file: XFERMODS.CMD will setup the required UFD's and copy these files to their respective UIC's for use with the two .CMD files. [11,41] DREIF.SLP [12,11] MC2.MAC, WHO.MAC, CPA.MAC, OPA.MAC [12,25] README.1ST ICPMODBLD.CMD, ICPMODS.ASM MC2MODBLD.CMD, MCRMODS.ASM, INSMODS.ASM MC2.ASM, MC2.TKB, WHO.ASM, WHO.TKB CPA.ASM, CPA.TKB, OPA.ASM, OPA.TKB [12,41] MC2ICPMOD.SLP, MC2MCRMOD.SLP MC2INSMOD.SLP, INSBLDBLD.SLP ============================ 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. **** ============================================================================== ICPMODBLD.CMD ------------- Modules: ICPPRE, ICPERR, ICPFDC, ICPFIL, ICPMCR, ICPROT, ICPIN2 Modifications: 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 '@' 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 [12,35] xxx.LST for Listings ============================================================================== MC2MODBLD.CMD ------------- 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] **** MCR.OLB: MCRDIS, FIXOV, MCROOT, ERROV, ERRMSG, ALTOV, ATLOV, CLIOV, LUNOV OPEOV, PR1OV, RAPOV, RPSOV, RUNOV, SPSOV, ST1OV, TASOV **** 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. ==============================================================================