Removes an entry from a quota file.
Requires write (W) access to the quota file.
Format
DISKQUOTA REMOVE owner
1 – Parameter
owner
Specifies the user identification code (UIC) or rights
identifier. 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 more information
about 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 – Qualifier
2.1 /DEVICE
/DEVICE=device-spec
Specifies the disk volume containing the quota file. SYSMAN
validates the device specification and translates any logical
name in the target environment before deleting the UIC entry.
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.
3 – Description
The DISKQUOTA REMOVE command eliminates the specified UIC from
the quota file on the named device.
If the usage count for the UIC is not zero, files remain on
disk and the user can still log in, but any attempt to create
or extend files will fail.
The UIC [0,0] entry cannot be removed.
4 – Example
SYSMAN> SET ENVIRONMENT/NODE=MARS
SYSMAN> SHOW PROFILE
%SYSMAN-I-DEFDIR, Default directory on node MARS -- WORK2:[CASEY]
%SYSMAN-I-DEFPRIV, Process privileges on node MARS --
TMPMGX
OPER
NETMBX
SYSPRV
SYSMAN> DISKQUOTA REMOVE /DEVICE=DUA45: [TTD,DAVIS]
These commands remove UIC [TTD,DAVIS] from the quota file for
disk DUA45, which is located on node MARS.