% VAX-11 Librarian V04-00o x7x! "5 GQM7x1 GQM6 GQM is the Group Quota Manager program, which permits7 authorised users to dynamically allocate disk space to persons within their group.9 Each account is granted a total allocation by the System2 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 A DD 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 ACCOUNT9 The ADD ACCOUNT command is used by the System Manager to7 create an entry in the account quota file. An initial , allocation must be specified at this time.  Format:* ADD ACCOUNT accountname initial_all3 The accountname is 1 to 8 alphanumeric characters,; including the '$' and '_' characters. The initial value is8 a decim al number between 0 and approximately 4 billion.; SYSTEM access (see HELP PRIVILEGES) is required to perform this command.3 USER7 The ADD USER command permits the System Manager or the4 account owner to add a new user to the account. The8 allocation given to the new user is subtracted from the2 remaining allocation for the account. An initial , allocation must be specified at this time.  Format:+ ADD [ USER ] username initial_all8 ACCOUNT (see HELP PRIVILEGES) access is required to add7 a user in the same account as the current user. SYSTEM' access is required in all other cases. 3 IDENTIFIER7 The ADD IDENTIFIER command permits the System Manager 7 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 DISK9 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 accountname3 TOTAL; The DISK TOTAL command lists the total allocation of space& for a particular group for all disks. Format: DISK TOTAL accountname2 EXIT9The EXIT command simply terminates the GQM session. It is- exactly equivalent to typing ^Z (control-Z).  Format: EXIT2 LIST7 The LIST command prints a list of all accounts, users,5 vagrants or identifiers which have a quota entry on  the current device. 3 ACCOUNTS8 The LIST ACCOUNTS command prints a list of all accounts9 which have a quota entry on the current disk. It details8 the usage and allocation for each account. The accounts" are listed in alphabetical order. Format: LIST ACCOUNTS3 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 IDENTIFIERS8 The LIST IDENTIFIER command shows what identifiers have disk space alloted to them. Format: LIST IDENTIFIERS 2 MAXIMIZE8 The MAXIMIZE command permits a suitably privileged user6 to update newly added account records, and set users'7 allocation (if overdrawn) to their current usage. This6 is very useful when GQM has just been brought up on a5 disk, and all accounts have usage but no allocation.5 When bringing up GQM first do a MAXIMIZE USERS, then a MAXIMIZE ACCOUNTS Format: MAXIMIZE type 3 ACCOUNTS9 The MAXIMIZE ACCOUNTS command sets the allocation of all7 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]3 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 be0 overdrawn after this command has been executed. Format: MAXIMIZE USERS3 SYSTEM access is required to perform this command.2 MODIFY9 The MODIFY command permits a suitably privileged user to6 change the allocation granted to a particular user or; account. This command is used to change the allocation for an already existing entry. 3 ACCOUNT9 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 USER9 The MODIFY USER command permits the account owner or the9 System Manager to alter the amount of space granted to a5 particular user. If the allocation is DECREASED, the6 surplus is added back into the account pool. If it is9 INCREASED, space is subtracted from the pool. More space6 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 IDENTIFIER2 The MODIFY IDENTIFIER command permits the System 2 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 PRIVILEGES5 The commands a user is permitted to issue to GQM areA determined from the identifiers granted to the user and the UIC.6 There are three levels of access used by GQM for this< purpose; they are referred to as USER, ACCOUNT, and SYSTEM.D SYS TEM access is granted to any user who has the SYSMGR identifier.E 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 USERB MODIFY UIC (only if the user is in the same account) REMOVE USER3 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 NULLS3 USER? USER access does not permit the user to make any modificationsA to the GQM database whatsoever. The USE, SHOW, and LIST commands9 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 an9 entry has been made to system quota file using DISKQUOTA; instead of GQM. This is also the method used to initialise7 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 REMOVE9 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 USERA The REMOVE USER command removes an entry from the standard quotaB 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 UIC8 The REMOVE UIC command is used to remove an entry for a0 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:1 RENAME ACCOUNT old_account_name new_account_name2 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 NOOUTPUT2 SHOW9 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 IDENTIFIERB The SHOW IDENTIFIER command details the amount of space allocated( t o 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 more2 than one (different usernames have the same UIC). Format: SHOW [ UIC ] uic3 QUOTAS> The SHOW QUOTAS command lists quotas and usage for every user sorted by account.2 USE7 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 VAGRANTS9 Vagrants are defined as UIC's which p ossess a quota, but< which are not associated with any usernames. This may occur= if a username is deleted from the authorisation file without8 deleting the files or quota owned by it. One command is) provided to deal with these stray UIC's:  LIST VAGRANTSww