1 GQM
 GQM is the Group Quota Manager program, which permits
 authorised users to dynamically allocate disk space to
 persons within their group.

 Each account is granted a total allocation by the System
 Manager, and the account owner is responsible for
 apportioning the space among the users under the account,
 or authorising others to do so.

 GQM differs from the DISKQUOTA facility in that disk quotas
 are managed by username, rather than by UIC.
2 ADD
 The ADD command permits a suitably privileged user to add
 an account, a user or a uic, to the list of those authorised
 to access the current disk.
3 ACCOUNT
 The ADD ACCOUNT command is used by the System Manager to
 create an entry in the account quota file. An initial 
 allocation must be specified at this time. 

 Format:
       ADD ACCOUNT accountname initial_all

 The accountname is 1 to 8 alphanumeric characters,
 including the '$' and '_' characters. The initial value is
 a decimal number between 0 and approximately 4 billion.

 SYSTEM access (see HELP PRIVILEGES) is required to perform
 this command.
3 USER
 The ADD USER command permits the System Manager or the
 account owner to add a new user to the account. The
 allocation given to the new user is subtracted from the
 remaining allocation for the account. An initial 
 allocation must be specified at this time. 

 Format:
         ADD [ USER ]  username initial_all

 ACCOUNT (see HELP PRIVILEGES) access is required to add
 a user in the same account as the current user. SYSTEM
 access is required in all other cases.

3 IDENTIFIER
 The ADD IDENTIFIER command permits the System Manager 
 to add a new identifier to the quota file. An initial 
 allocation must be specified at this time. 

 Format:
         ADD IDENTIFIER idname initial_all

 SYSTEM access is required in all cases.

2 DISK
 The DISK command permits the user to examine the current
 allocation of disk space for an account on all mounted cluster 
 volumes. 

 Format:
        DISK [parameter] accountname

 Without a parameter, the command details the apportionment 
 of space within a particular group for each disk, and gives
 the total group allocation for all disks.

 The accountname may be 1 to 8 characters in length, and may
 NOT be abbreviated. 

3 BRIEF
 The DISK BRIEF command details the apportionment of space
 for a particular group for each disk, without listing the
 allocation for each user.

 Format:
        DISK BRIEF accountname

3 TOTAL
 The DISK TOTAL command lists the total allocation of space
 for a particular group for all disks.

 Format:
        DISK TOTAL accountname
2 EXIT
The EXIT command simply terminates the GQM session. It is
 exactly equivalent to typing ^Z (control-Z).
 
 Format:
         EXIT
2 LIST
 The LIST command prints a list of all accounts, users,
 vagrants or identifiers which have a quota entry on 
 the current device.
3 ACCOUNTS
 The LIST ACCOUNTS command prints a list of all accounts
 which have a quota entry on the current disk. It details
 the usage and allocation for each account. The accounts
 are listed in alphabetical order.

 Format:
        LIST ACCOUNTS
3 USERS
 The LIST USERS command prints out a list of all users who
 have a quota entry on the current disk, and reports which
 account each belongs to. It also shows the allocation and
 usage for each user.

 Format:
        LIST USERS
3 VAGRANTS
 The LIST VAGRANTS command shows what UIC's have disk space
 allotted to them, but which are not associated with a username.
 This may happen if a user was removed from the authorisation
 file, but not from the quota file.

 Format:
        LIST VAGRANTS
3 IDENTIFIERS
 The LIST IDENTIFIER command shows what identifiers have
 disk space alloted to them.

 Format:
        LIST IDENTIFIERS

2 MAXIMIZE
 The MAXIMIZE command permits a suitably privileged user
 to update newly added account records, and set users'
 allocation (if overdrawn) to their current usage. This
 is very useful when GQM has just been brought up on a
 disk, and all accounts have usage but no allocation.

 When bringing up GQM first do a MAXIMIZE USERS, then
 a MAXIMIZE ACCOUNTS

 Format:
        MAXIMIZE type
3 ACCOUNTS
 The MAXIMIZE ACCOUNTS command sets the allocation of all
 accounts (or a specified account) on the current disk 
 to the larger of the two values obtained from: the account's 
 current usage, and its current allocation. This is very useful 
 for updating the account file on a disk that GQM has just been 
 on.

 Format:
        MAXIMIZE ACCOUNTS [account_name]

 SYSTEM access is required to perform this command.
3 USERS
 The MAXIMIZE USERS command sets the allocation of all UIC's
 on the current disk to the larger of: its current usage, and
 its current allocation. All OVERDRAWN users will no longer be
 overdrawn after this command has been executed.

 Format:
        MAXIMIZE USERS

 SYSTEM access is required to perform this command.

2 MODIFY
 The MODIFY command permits a suitably privileged user to
 change the allocation granted to a particular user or
 account. This command is used to change the allocation for
 an already existing entry.
3 ACCOUNT
 The MODIFY ACCOUNT permits the System Manager to control
 the amount of space available for distribution within each
 account on a device.

 Format:
        MODIFY ACCOUNT accountname value

 The allocation may be of the form xnnn, where 'x' is either
 '+' or '-', and 'nnn' is a decimal number. In this case, the
 allocation is changed by the specified amount, rather than
 being replaced by it.

 SYSTEM access (see HELP PRIVILEGES) is required to perform
 this command.
3 USER
 The MODIFY USER command permits the account owner or the
 System Manager to alter the amount of space granted to a
 particular user. If the allocation is DECREASED, the
 surplus is added back into the account pool. If it is
 INCREASED, space is subtracted from the pool. More space
 cannot be allocated than remains in the account pool.

 Format:
       MODIFY [ USER ]  username value

 The allocation may be of the form xnnn, where 'x' is either
 '+' or '-', and 'nnn' is a decimal number. In this case, the
 allocation is changed by the specified amount, rather than
 being replaced by it.

 ACCOUNT access (see HELP PRIVILEGES) is required to perform
 this command if the user being changed is in the same account
 as the current user. SYSTEM access is required in all other
 cases.
3 UIC
 The MODIFY UIC command allows a suitably privileged user to
 change the allocation granted to any user or vagrant. The
 latter function is not particularly useful, since a vagrant's
 usage is not charged against any account.

 Format:
        MODIFY [ UIC ]  uic value

 The allocation may be of the form xnnn, where 'x' is either
 '+' or '-', and 'nnn' is a decimal number. In this case, the
 allocation is changed by the specified amount, rather than
 being replaced by it.

 ACCOUNT access is required to change the allocation of a UIC
 belonging to someone in the same account as the current user.
 SYSTEM access is required in all other case.
3 IDENTIFIER
 The MODIFY IDENTIFIER command permits the System 
 Manager to alter the amount of space granted to a
 particular identifier. 

 Format:
       MODIFY IDENTIFIER idname value

 The allocation may be of the form xnnn, where 'x' is either
 '+' or '-', and 'nnn' is a decimal number. In this case, the
 allocation is changed by the specified amount, rather than
 being replaced by it.

 SYSTEM access is required in all other cases.

2 PRIVILEGES
 The commands a user is permitted to issue to GQM are
 determined from the identifiers granted to the user and the UIC.
 There are three levels of access used by GQM for this
 purpose; they are referred to as USER, ACCOUNT, and SYSTEM.

 SYSTEM access is granted to any user who has the SYSMGR identifier.

 ACCOUNT access is granted to any user who has the GRPMGR identifier,
         but does not have SYSTEM access.

 USER access is granted to all users who do not fall into one
      of the above categories.
3 ACCOUNT
 ACCOUNT access is required to modify the distribution of space
 among the users in an account. The following commands are those
 usable by the holder of ACCOUNT access, in addition to those
 available to all users:

        MODIFY USER
        MODIFY UIC       (only if the user is in the same account)
        REMOVE USER
3 SYSTEM
 SYSTEM access is required to add either accounts or users. It
 is also required to change the amount of space allotted any
 single account. It permits the user to issue the following
 commands, in addition to those available to an account manager:

        ADD ACCOUNT
        ADD USER
        MAXIMIZE ACCOUNTS
        MAXIMIZE USERS
        MODIFY ACCOUNT
        MODIFY DEFAULT
        MODIFY UIC         (at all times)
        REBUILD
        REMOVE ACCOUNT
        REMOVE NULLS
3 USER
 USER access does not permit the user to make any modifications
 to the GQM database whatsoever. The USE, SHOW, and LIST commands
 are all that are available to the holder of USER access.
2 REBUILD
 The REBUILD command permits a suitably privileged user to
 reconstruct the account quota file. This is useful when an
 entry has been made to system quota file using DISKQUOTA
 instead of GQM. This is also the method used to initialise
 the account quota file for the first time on a device.

 Format:
       REBUILD [account_name]

 SYSTEM access (see HELP PRIVILEGES) is required to perform
 this command.
2 REMOVE
 The REMOVE command permits a suitably privileged user to
 delete entries from either the account or user quota files.
3 ACCOUNT
 The REMOVE ACCOUNT command removes an entry from the account
 quota file for the current disk.

 Format:
        REMOVE ACCOUNT accountname

 SYSTEM access (see HELP PRIVILEGES) is required to perform
 this command.
3 USER
 The REMOVE USER command removes an entry from the standard quota
 file, which contains an entry for each user authorised to use the
 disk.

 Format:
        REMOVE [ USER ]  username

 ACCOUNT or SYSTEM access (see HELP PRIVILEGES) is required to
 perform this command.
3 UIC
 The REMOVE UIC command is used to remove an entry for a
 UIC which is not associated with any usernames.

 Format:
        REMOVE [ UIC ]  uic

 SYSTEM access (see HELP PRIVILEGES) is required to perform
 this command.
2 RENAME 
 RENAME renames a group.

 Format:
	RENAME ACCOUNT old_account_name new_account_name

2 SET
 The SET command permits the user to control the environment
 of the GQM session.

 Format:
        SET option [arg]
3 OUTPUT
 The SET OUTPUT command redirects all subsequent output from
 GQM  to the  specified file.  A new  version of the file is
 created. This output  includes all messages and the command
 input (if the DCL VERIFY flag is on).

 Format:
        SET OUTPUT file

3 NOOUTPUT
 The SET NOOUTPUT command  closes any  log file opened with
 the SET OUTPUT command, and restores output to the default
 SYS$OUTPUT device.

 Format:
        SET NOOUTPUT

2 SHOW
 The SHOW command permits the user to examine the current
 allocation of disk space on a particular volume. This may
 be done for an individual user, for a particular account,
 or for the entire volume.

 Format:
        SHOW parameter
3 ACCOUNT
 The SHOW ACCOUNT command details the apportionment of space
 within a particular group.

 Format:
        SHOW ACCOUNT accountname

 The accountname may be 1 to 8 characters in length, and may
 NOT be abbreviated. Use the LIST command to determine what
 accounts are enabled for a particular device.
3 IDENTIFIER
 The SHOW IDENTIFIER command details the amount of space allocated
 to and used by a particular identifier.

 Format:
        SHOW IDENTIFIER  idname

 The idname may NOT be abbreviated.
3 USER
 The SHOW USER command details the amount of space allocated
 to and used by a particular user.

 Format:
        SHOW [ USER ]  username

 The username may NOT be abbreviated.
3 UIC
 The SHOW UIC command prints details about the space allocated
 to a particular UIC. The UIC may be associated with any number
 of usernames; none (a vagrant), one (the normal case), or more
 than one (different usernames have the same UIC).

 Format:
        SHOW [ UIC ]  uic
3 QUOTAS
 The SHOW QUOTAS command lists quotas and usage for every user
 sorted by account.

2 USE
 The USE command permits the user to change the current
 device, which is used by all other GQM commands. When GQM
 is started, the current device defaults to the value of the
 logical name SYS$DISK.

 Format:
       USE device[:]
2 VAGRANTS
 Vagrants are defined as UIC's which possess a quota, but
 which are not associated with any usernames. This may occur
 if a username is deleted from the authorisation file without
 deleting the files or quota owned by it. One command is
 provided to deal with these stray UIC's:
 
       LIST VAGRANTS

