			       K M S K I T
			   R E A D M E . 1 S T
				V 4 . 2B

***************************************************************************
**	Please note. Support for the KMS enhancements is dying even      **
**  faster than it was before.  (DEC would refer to this as Category Z-  **
**  support on an SPD for KMSKIT.)   However, the RSX modifications      **
**  still work, even though KMS has converted everything to M-Plus       **
**  and does not care about RSX-11M any more than for sentimental        **
**  reasons.  Tony Scandora of Argonne National Laboratory still uses    **
**  KMSKIT on some steam-powered 11s, and has updated KMSKIT for V4.2B.  **
**  A feeble attempt was made to install the whole thing as a package,   **
**  as you, the user, might want to do.  Jim tended to put changes in    **
**  piece meal as he had time.  The master command files are an attempt  **
**  to try and make the kit easily installable, and they actually have   **
**  been tried a few times.  That sadly, does not mean that they are     **
**  guaranteed to work.  Tony has built most of KMSKIT, but has only     **
**  tested what he uses.  He hopes all that you need to build KMSKIT     **
**  is here, and he will do his best to keep it current as long as he    **
**  supports the steam-powered 11s.
**                                                                       **
**  Please be careful.   The SLP files may not conform to the source     **
**  files you have (though they should). BEWARE-----BEWARE.  If the SLP  **
**  files don't work, if the command files don't work, or if you need    **
**  help, find a mirror (preferably larger than the pocket variety) and  **
**  gaze at it intently. Note the face looking back at you. It is the    **
**  kindly face of your Software Support Specialist.   Good Luck!!       **
***************************************************************************

     In going from V4.1 (field test version) to V4.1 Updata B version,
  all that Jim ever needed to change was the first ASCII locator string
  (which looks for that last audit trail record in the text preamble) to
  reflect the correct place for the SLP file audit trail to go.  We have
  attempted to make the process fullproof, which is a sure indication that
  it is bound to fail for some.  Three files (EXECSLP.CMD, MCRSLP.CMD, and
  ICPSLP.CMD) actually do all the SLPing.  They used to assume most files 
  are the unupdated distribution files with a NAME.EXT;1 file name, and a
  few (known internally to the command files) are known to be updated (via
  Update B).  Tony took all of that version number stuff out and let it all
  work with latest versions.

  Since users have not yet seriously proposed that KMS try generating a
  "product", our assumption is that users interested in KMSKIT are
  generally sophisticated and able to fix minor "bugs" that creep into the
  installation procedure. 

  In practice, Tony does the following:
	
	1. Apply DEC Autopatch/Update "xx" to produce .XYZ;2 files
	2. Read each and every .SLP file and what it patches
	   to insure reasonablness
	3. Use EXECSLP.CMD, ICPSLP.CMD, MCRSLP.CMD
	   If SLP complains, you missed something that needed to be fixed
	4. Read each and every SLPed source file to insure reasonablness

  I know of no way to set up a command procedure that can tell if the
  autopatch has been done and to set things up automatically.  Perhaps if
  I gave it enough thought... But someone else should worry about this.


	As a note of MINOR encouragement, I have all of KMSKIT working on
   V4.2B of RSX11M and the enclosed files are the ones I used.  This is
   is it intended to be a rerelease of the entire KMSKIT.  Send comments
   to Tony Scandora if it is not.

        The following UIC's are part of the KMSKIT RSX11M Enhancements
   Package Update for V4.2.
 
[344,1]		Documentation files.  Command file to create the document
		files.  You need RUNOFF to do this.  Hope you have it.
		The documentation has not been updated recently.

[344,40]	Terminal and disk accounting, privilege allocation,
   		modifications to HELLO, HELP and BYE, account utilities
   		and report programs. 
		Run privilege checking and searching 
		LIBUIC, NETUIC and SYSUIC on a RUN $ command. 
		SET /LIBUIC for RSX11M (just like M-Plus).
		Enhancements to ...AT. to implement the /-LI switch.
    
[344,43]	Utilities. Updated versions of GREP and LIST
 
[344,44]	Here is a version of the old RMDEMO which runs on VT100's
		which are in ANSI mode.  This version is almost half as
		small as the new version and supports reploting and
		easy exit. In addition, if KMS Accounting is present
		and active, it provides a dynamic display of the percent
		of total system utilization.  This version (less
		my mods) was distributed with the field test kit of 
		RSX11M V3.2 and is distributed here courtesy of the the
		RSX group.  It runs on a RSX11M V4.1 system.
    
[344,45]	PDQ -- Program Development Queues.   PDQ is a multi-
		queue command file despooler (using QMG...).  Submit
		a command file for execution.  When a program development
		queue becomes free, the command file executes at your TI:

[344,61]	CCL has been taken over by Paul Sorenson.  If it is not
		on this tape, it is on an earlier tape.
		Need I say more?  CCL is almost too useful to be free.

[344,65]	A complete SYSTEM ACCOUNTING package for RSX11M.
		While oriented towards providing performance measurement,
		it provides the basis for implementing a versitile and
		reasonable charge-back accounting system.  Some reports
		are provided which will do this.  Please read SYSLOG.DOC.
 
 
Please, create and read the documentation before leaping in and trying to use
the kit! 

     A discription of all the modifications and enhancements and most of
the  utilities is in KMSKIT.DOC.  The command file [344,40]KMSGEN.CMD will 
provide all required information (or most of it)for building the  KMS  
Enhancements and a number of the other programs. Read KMSKIT.DOC before 
trying to include the executive data base changes.  Please note that
it has not been updated since V4.0 and the file REQSB.SLP is no longer
needed.
 
     To use this kit, transfer the files to their respective UIC's. Read all
the documentation over twice. Set /UIC=[344,40] and type @KMSGEN/-MC and run
through a KMSGEN asking for a long dialog. Place the required DEC sources in
the correct places, KMSGEN will try and do all the SLP patches both to MCR
sources, the EXEC modules and the SYSGEN command files. If KMSGEN sucessfully
SLPs the MCR, EXEC and SYSGEN command files, stop, place the OLB's and sources
on your SYSGEN disks and do a SYSGEN if you are incorporating data structures
(accounting) requiring a SYSGEN. Once the SYSGEN is done use KMSGEN again to
create all needed files. 

     These programs have been extensively tested for the case where all KMS
options are selected and where most DEC sysgen options are selected.
KMSGEN and the command files to implement KMSKIT for the general user have
had almost no testing since I do all patches one at a time checking results
as I go.  The first user to try KMSKIT found a bunch of bugs in the command
files.  These I tried to fix.  But, as we all know, bugs are hard to 
completely stamp out.  Be warned, be careful, and be alert.  Since, I know
the SLP patches once incorporated work, I am sure they can be incorporated
with a bit of perseverence.  I apologize in advance for any potential
inconvenience, but current government regulations (let alone my family)
preclude me spending in excess of 24 hours daily at work.  I simply do not
have time to do all that I have to do as well as all that I would like to
do.

     We owe Jim Downward a large debt for this package.  Now that he has
converted to M-Plus, send comments, praise, and bug reports (preferably
with fixes) to Tony Scandora, who will forward any praise to Jim.

Thanks again, Jim, and good luck out there,

Tony Scandora
Argonne National Laboratory
CMT 205
Argonne, IL  60439
BitNet B35048 at ANLCMT
312-972-7541  FTS 972-7541
