!=============================================================================!
!  DIVISION   I	:				     HELP MODULE DECLARATION  !
!=============================================================================!
!									      !
!      -----------------------------------------------------------------      !
!      SECTION 01 :					 INITIAL VERSION      !
!      -----------------------------------------------------------------      !
!									      !
!      Help Library	 : ACC_HELP:STAFFHELP.HLB			      !
!      File Specification: ACCSRC_ACC:[HELP.SYSTEM.STAFF]QUOTA.HLP	      !
!      Author		 : Marlys A. Nelson				      !
!      Initial version	 : 01.00.00 22-MAY-1985	VMS 4.1			      !
!									      !
!      -----------------------------------------------------------------      !
!      SECTION 02 :				    MODIFICATION HISTORY      !
!      -----------------------------------------------------------------      !
!									      !
!									      !
!=============================================================================!
!  DIVISION  II	:				  HELP MODULE SPECIFICATIONS  !
!=============================================================================!
!									      !
!      Key 1 (Command name)............	QUOTA				      !
!	 Key 2 ........................	Parameters			      !
!	 Key 2 ........................	Qualifiers			      !
!	 /qualifier ...................   /DEVICE			      !
!	 /qualifier ...................	  /FORMAT			      !
!	 /qualifier ...................   /SORT				      !
!									      !
!=============================================================================!
!  DIVISION III	:					       SPECIAL NOTES  !
!=============================================================================!
!									      !
!									      !
!=============================================================================!
!
!
!=============================================================================!
! Key 1									QUOTA !
!=============================================================================!
!
1 QUOTA
Quota reports disk quota information in  one  of  several  specialized
formats  not  available  with Digital's DISKQUOTA program.

Format:

      QUOTA[/qualifiers] device

QUOTA will format the quota information for use in the following ways:

    1. accounting reports;
    2. general security monitoring;
    3. creation of a command procedure to rebuild a quota file  should
       it become inadvertently destroyed;
    4. general SORTED listing;

In addition, QUOTA can sort the  information  by  uic,  identifier  or
current disk usage.

QUOTA  must  be set up as a DCL command.  This can be done by entering
the following command:

    $ SET COMMAND ACC_SYSTEMCLD:QUOTA.CLD

This command can be entered interactively prior to entering the  QUOTA
command.   You  can also include the command as part of your LOGIN.COM
file, thereby making the QUOTA command available always.
!
!=============================================================================!
! Key 2								   Parameters !
!=============================================================================!
!
2 Parameters
device

  Specifies the disk device for which to report the quota information.
  This parameter is required.  It may be specified as a  logical  name
  (USERDISC1  or  USERDISC2)  or  as  a physical device name (DRA0: or
  DUA0:).
!
!=============================================================================!
! Key 2								   Qualifiers !
!=============================================================================!
!
2 Qualifiers
!
! qualifier
!
/FORMAT

  /FORMAT={ ACCOUNTING }
          { CREATE     }
          { LIST       }
          { SECURITY   }

  Specifies the desired format of the  results  of  QUOTA.   Depending
  upon the format, some information may not be reported.  For example,
  the SECURITY format does not show current usage.  Each format  is
  described below.

  ACCOUNTING

    This output report is designed for use  with  the  monthing  usage
    accounting  software.   This  software  uses  the  numeric  uic to
    associate usernames and disk usage.  Prior to VMS 4.x, the  output
    of  DISKQUOTA  could  be used.  In 4.0 VMS 4.0, DISKQUOTA displays
    only the alphanumeric form of the uic (and may truncate  it  under
    certain  conditions).   The  accounting essentially duplicates the
    pre-VMS 4.0 behavior of DISKQUOTA PLUS it sorts by uic.

  CREATE

    This output format is designed as backup for the active disk quota
    file.  It is a command procedure which can be  used  to  re-create
    the  quota  file  from scratch, should this ever become necessary.
    Typically, this format is reported once each week prior to  weekly
    backups.

  LIST

    The  list  format  is  a  general  report  showing  the disk quota
    information.  Essentially, this performs the DISKQUOTA SHOW  [*,*]
    command but with two additional features:

	1. The information can be sorted;		      
	2. Both numeric and alpha-numeric uics are shown;

  SECURITY

    The  security format is designed for passive monitoring of changes
    to the disk quotas by daily batch  job  SNAPSHOT.   Current  usage
    values are not present on the report.

!
! qualifier
!
/OUTPUT

  /OUTPUT[=filespec]

  Specifies the name of the file into which the results of  QUOTA  are
  to  be  written.   If  not specified, the results are written to the
  file QUOTA.LIS.

!
! qualifier
!
/SORT

  /SORT={ IDENTIFIER }
        { UIC        }
        { USAGE      }

  Specifies how the results are to be sorted.  If not  specified,  the
  results are sorted by UIC (numeric group and member).
!
!=============================================================================!
!							   END OF HELP MODULE !
!=============================================================================!
