!       Help filename:  SOFTQUOTA.HLP
!       Written by   :  Brad Schafer   1-Dec-81
!	Modified by  :  Marty Adkins  10-Jan-1983, 20-May-1983, 3-Aug-1983
!       Modified by  :  Shari Dishop  13-Jan-1988
!       Description of SOFTQUOTA disk management utility
!
1 SOFTQUOTA
SOFTQUOTA is designed to be a work-around for the "hard" quota
limit imposed by DEC's diskquota mechanism.  It allows a user to
have a large working space during a login session, while
keeping residual disk usage at a minimum.  SOFTQUOTA compares
current disk usage to a "soft" quota value assigned by the
system manager and displays an appropriate message.  If a user
has exceeded the soft quota, his hard quota is set to equal his
soft quota.  The original hard quota may be restored by cleaning
up and invoking SOFTQUOTA.
 
Format
     SOFTQUOTA [/MODIFY][/NOUNIQUE][/QUIET] [/START] volume1,volume2,...
!
!       This section lists the qualifiers
!
2 Qualifiers
/MODIFY
This switch will cause the hardquota for the current UIC to be
set to the soft quota value.  This switch should not be used
during a working session.  If /MODIFY is not specified, a message
is displayed and quota is not dropped.

/NOUNIQUE
By default, SOFTQUOTA will not perform the MODIFY step if another
process exists with the same UIC.  This minimizes interference
problems.  To override this default, specify /NOUNIQUE

/QUIET
Inhibits the display of informational messages, e.g.
	"quota file not active"

/START
 Only used by the system manager to start listeners on cluster nodes.
 Ignores all other qualifiers.
!
!       Tell SYSMGR how to use it!
!
2 Implementation
SOFTQUOTA uses QUOTA.SYS (created and updated by DISKQUOTA) to determine
how much space has been used.  Therefore, DISKQUOTAs must be implemented
on a volume for SOFTQUOTA to work.  If quotas are not active on a volume,
SOFTQUOTA displays an informational message.
 
A user's soft quota value is stored in an ISAM file ([000000]SOFTQUOTA.DAT),
indexed by UIC.  If the UIC is not found in the file, the program will
use the values store in the DEFAULT record (KEY = -3).  Entries may
be added/modified/removed with the SOFTDB utility.
!
!       Tell SYSMGR how to install it!
!
2 Installation
SOFTQUOTA should be defined in the system DCL tables
and run at login time with the /MODIFY option to allow the program
to drop an abuser's hardquota.  To avoid clobbering batch jobs
(when there is no human available to correct the problem) the
following check should be made for its invocation:

 $ IF F$MODE() .NES. "INTERACTIVE" THEN GOTO DONE
 $ SOFTQUOTA /MODIFY/QUIET ddcnn,...
 $ DONE:
 
SOFTQUOTA should also be INSTALLed as follows :
 
   INSTALL>SOFTQUOTA/PRIV=(SYSPRV,WORLD,CMKRNL,SYSLCK)[/OPEN][/HEADER]
 
This allows SYSMGR to set protection on  SOFTQUOTA.DAT  to disallow
tampering.
!
!       This section shows support responsibility
!
2 Support
SOFTQUOTA is supported on a time-available basis by Shari Dishop
Please forward specific problems, suggestions, etc. to:
 
       Shari Dishop
       VAX Support Group
       Westinghouse Electric Corp
       P.O. Box 746  MS 1615
       Baltimore, Md.  21203
