!       Help filename:  SOFTQUOTA.HLP
!       Written by   :  Brad Schafer   1-Dec-81
!	Modified by  :  Marty Adkins  10-Jan-1983, 20-May-1983
!       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 working 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 his soft quota, working space may be restored by
cleaning up and invoking SOFTQUOTA.
 
 
Format
     SOFTQUOTA [/MODIFY][/QUIET] 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.

/QUIET
Inhibits the display of informational messages, e.g.
	"quota file not active"
!
!       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 = 88888888).  Entries may
be added/modified/removed with the SOFTDB utility.
!
!       Tell SYSMGR how to install it!
!
2 Installation
SOFTQUOTA should be defined in the SYS$SYLOGIN procedure as :
 
   SOFT*QUOTA :== $WUTIL$:SOFTQUOTA
 
and run at login time with the /MODIFY option to allow the program
to drop an abuser's hardquota.  To avoid interference problems with
other processes of the same UIC, additional checks should be made:

 $ SOFT*QUOTA :== $WUTIL$:SOFTQUOTA  !Define as foreign command
 $ MODIFY = ""
 $ IF F$MODE() .NES. "INTERACTIVE" THEN GOTO RUN_SOFT
 $ USERNAME := 'F$GETJPI("","USERNAME")
 $ PROCNAME := 'F$GETJPI("","PRCNAM")
 $ IF USERNAME .NES. PROCNAME THEN GOTO RUN_SOFT !Already logged in
 $ RUN WUTIL$:BATCHECK   !Check for current batch job with this UIC
 $ IF $STATUS THEN MODIFY = "/MODIFY"
 $RUN_SOFT:
 $ SOFTQUOTA 'MODIFY'/QUIET ddcnn,...
 
A starter file for SOFTQUOTA is included as WUTIL$:SOFTQUOTA.ISM
You may/should copy this to [000000]SOFTQUOTA.DAT to get started.
 
SOFTQUOTA should also be INSTALLed as follows :
 
   INSTALL>WUTIL$:SOFTQUOTA/PRIV=SYSPRV[/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 Marty Adkins
Please forward specific problems, suggestions, etc. to:
 
       Marty Adkins
       VAX Support Group
       Westinghouse Electric Corp
       P.O. Box 746  MS 1615
       Baltimore, Md.  21203
