Author:

        Darrell Blair
        Johnson Controls Inc.
        PO Box 591
        Milwaukee, WI.  53201
        (414) 228-2206



Description:

	DORMANT is a utility that reports UAF account inactivity to you
	so you can locate the NON-USERS of your system.  This can aid the
	VAX System Manager with everyday account and security management.

	You specify the criteria for determining which accounts are to be
	reported as dormant or near dormant.  The qualifiers /WARNING and
	/WATCH are used to do this.  If you do not supply the qualifiers,
	DORMANT uses defaults of 60 days for WARNING and 30 days for WATCH.
	DORMANT will also report any accounts that have never been used.

	The command $ DORMANT/WATCH=100/WARNING=200 will cause DORMANT to
	report all accounts inactive 200 days or more as WARNING accounts
	and all accounts between 100 and 200 days inactive as WATCH
	accounts.

	The report is written to the file DORMANT.RPT.  This file can then be
	printed on a printer.  Version 2.0 and later versions of DORMANT use
	DEC special graphics so you'll need a printer that supports this.




Installation:

	To install DORMANT you MUST have the following files:
		o DORMANT.INS	- This is the automatic DORMANT installation
				  procedure.  The installation is not system-
				  wide.  Only the user installing DORMANT with
				  the automatic installation procedure will be
				  setup to use DORMANT.
		o DORMANT.OBJ	- The DORMANT installation procedure will
				  use this file to create the executable
				  image.

	Optionally, (if your VAX hosts a VAX C compiler and DORMANT.OBJ is
	not present) the following file can be used 
	for DORMANT installation:
		o DORMANT.C	- If DORMANT.OBJ is missing and your system
				  has a VAX C compiler, the DORMANT 
				  installation procedure will use this file
				  to create the executable image.

	It is also nice to have this file.
		o DORMANT.HLB	- This is the VMS HELP file for DORMANT.

	The following files are created by the DORMANT automatic installation
	procedure:
		o DORMANT.CLD	- This is the DORMANT command definition file.
		o DORMANT.EXE	- This is the DORMANT executable image.


	Steps for installing DORMANT:

	-  Create a directory.
	-  Copy DORMANT files from DECUS directories to the new directory.
	-  Set your default to the directory.
	-  Invoke the DORMANT automatic installation procedure.
	-  You are now ready to use the DORMANT utility.

	Example:
		$ CREATE/DIRECTORY [.DORMANT]
		$ COPY [DECUS.VAX90.BLAIR]DORMANT.*;* [.DORMANT]*.*;*
		$ SET DEFAULT [.DORMANT]
		$ @DORMANT.INS

	Now you can use the DORMANT utility.  Also, you can get help on the
	DORMANT utility by entering DORMANT_HELP at the $ prompt.

		$ DORMANT_HELP
			:
			:
		$ DORMANT/WATCH=180/WARNING=365

	Your report will be in the file DORMANT.RPT.  This file can be saved
	for reference or printed to a printer.  NOTE: The report uses DEC 
	special graphics characters.  Make sure your printer supports this.

Note:	DORMANT creates a listing file in SYS$SYSTEM.  The process executing
	DORMANT must have write permission into this area.  The privileges
	BYPASS or SYSPRV, or a UIC group less than or equal to the SYSGEN 
	parameter MAXSYSGROUP will allow you this access.

Disclaimer:

	This program is made available to the public with no warranties,
        guarantees, or liabilities of Darrell Blair or Johnson Controls.

	I am consistantly enhancing all of the application software that I
	write, so if you like DORMANT and want a copy of the latest version,
	just give me a call.

	Also if you have thoughts on how to improve DORMANT you can call me.

	If you don't like DORMANT.  Sorry!!!!!