Adds an entry to a disk quota file and initializes the usage count to zero. Requires write (W) access to the quota file. Format DISKQUOTA ADD owner
1 – Parameter
owner Specifies the user identification code (UIC) or rights identifier for which the quota entry is added. You can specify the UIC in numeric or alphanumeric format. For complete information about UIC specification, see the VSI OpenVMS Guide to System Security. Rights identifiers are granted with the Authorize utility and use an ID format rather than a UIC format. For a complete description of rights identifiers, see the VSI OpenVMS Programming Concepts Manual. When working in nonlocal environments, be careful that the alphanumeric UIC or rights identifiers that you use are valid for the environment.
2 – Qualifiers
2.1 /DEVICE
/DEVICE=device-spec Specifies the location of the quota file. SYSMAN validates the device specification. You can specify a logical name for device- spec. If you do, the logical name is translated in the target environment. Without a device specification, SYSMAN uses the default disk on the target node. Unless you have set a default device with the SET PROFILE command, the default disk is the current device on the local node or the login default device on another node, depending on the established environment.
2.2 /OVERDRAFT
/OVERDRAFT=value Specifies a positive integer that provides an overdraft value for the specified UIC. If omitted, the overdraft value defaults to the overdraft value in the entry for [0,0].
2.3 /PERMQUOTA
/PERMQUOTA=value Specifies a positive integer that provides the quota for the specified UIC. If omitted, the permanent quota defaults to the value of the quota in the entry for [0,0].
3 – Description
The DISKQUOTA ADD command appends individual entries to a quota file on the specified disk. Note that the quota file must already exist and be enabled. Unless you specify the permanent quota and overdraft values, SYSMAN applies the default values from the UIC entry [0,0]. You adjust UIC [0,0] with the DISKQUOTA MODIFY command.
4 – Example
SYSMAN> SET ENVIRONMENT/NODE=(NODE21,NODE22) %SYSMAN-I-ENV, Current command environment: Individual nodes: NODE21,NODE22 Username ALEXIS will be used on nonlocal nodes. SYSMAN> SET PROFILE /PRIVILEGE=SYSPRV SYSMAN> DISKQUOTA ADD [MKT,MORSE] /DEVICE=WORK1 - _SYSMAN> /PERMQUOTA=200 /OVERDRAFT=50 SYSMAN> DISKQUOTA ADD PAYROLL /DEVICE=WORK1 /PERMQUOTA=1000 This command sequence performs the following tasks: o Defines the management environment to be NODE21 and NODE22. o Adds SYSPRV privilege to the user's current privileges in order to write to the quota file. o Adds UIC [MKT,MORSE] to the quota file on the device named WORK1 on both NODE21 and NODE22, setting the permanent quota to 200 disk blocks and the overdraft limit to 50 disk blocks, for an absolute limit of 250 blocks. If the user name MORSE has a unique UIC on the system, you can enter the following command: SYSMAN> DISKQUOTA ADD MORSE o Adds an entry for the rights identifier PAYROLL. Any user holding the PAYROLL identifier can use this disk space.