MCR SYSMAN DISKQUOTA — VMS 5.4-3
Additional information available:
ADDCREATEDELETEDISABLEENABLEMODIFYREBUILD
REMOVESHOW
ADD
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
Additional information available:
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 on UIC specification, refer to the VMS DCL Concepts Manual. Rights identifiers are granted with the AUTHORIZE Utility and use an ID format rather than a UIC format. See the Introduction to VMS System Services Manual for a complete description. When working in nonlocal environments, be careful that the alphanumeric UIC or rights identifiers that you use are valid for the environment.
Qualifiers
Additional information available:
/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 on another node, depending on the
established environment.
/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].
/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].
CREATE
Creates and enables a quota file for a disk volume that does not
currently contain one.
Requires write (W) access to the volume's master file directory
(MFD), plus one of the following: SYSPRV privilege, a system UIC,
or ownership of the volume.
Format
DISKQUOTA CREATE
Additional information available:
Qualifier
Additional information available:
/DEVICE
/DEVICE=device-spec
Specifies the disk volume on which to create a quota file.
SYSMAN validates the device specification. A logical name may be
specified for device-spec. If so, it 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 on another node, depending on the
established environment.
Example
SYSMAN> SHOW ENVIRONMENT
%SYSMAN-I-ENV, Current command environment:
Node ATHENS of local cluster
Username ALEXIS will be used on nonlocal nodes
SYSMAN> DO SHOW DEVICES
.
.
.
SYSMAN> DISKQUOTA CREATE /DEVICE=DJA31:
SYSMAN> DISKQUOTA MODIFY /DEVICE=DJA31: [0,0] /PERMQUOTA=10000 -
_SYSMAN> /OVERDRAFT=100
The commands in this example sequence display the
characteristics of the current management environment and
verify the device name. Then they create a quota file on the
disk DJA31 and set up default quota values.
DELETE
Removes an entry from a quota file. See the command DISKQUOTA REMOVE for more information. The DISKQUOTA REMOVE and DISKQUOTA DELETE commands perform the same function.
DISABLE
Suspends the maintenance and enforcement of disk quotas on a
volume.
Requires SYSPRV privilege, a system UIC, or ownership of the
volume.
Format
DISKQUOTA DISABLE
Additional information available:
Qualifier
Additional information available:
/DEVICE
/DEVICE=device-spec
Specifies a disk volume on which to disable a quota file.
SYSMAN validates the device specification. A logical name may be
specified for device-spec. If so, it 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 on another node, depending on the
established environment.
Example
SYSMAN> SET ENVIRONMENT/NODE=AMANDA
SYSMAN> DISKQUOTA DISABLE /DEVICE=DJA1:
The command in this example suspends quota enforcement on disk
DJA1, located on node AMANDA.
ENABLE
Resumes quota enforcement on a disk volume.
Requires SYSPRV privilege, a system UIC, or ownership of the
volume.
Format
DISKQUOTA ENABLE
Additional information available:
Qualifier
Additional information available:
/DEVICE
/DEVICE=device-spec
Specifies a disk volume on which to enable the quota file.
SYSMAN validates the device specification. A logical name may be
specified for device-spec. If so, it 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 on another node, depending on the
established environment.
Example
SYSMAN> SET ENVIRONMENT/NODE=BAKER
SYSMAN> SET PROFILE/DEFAULT=DJA12:[ALEXIS.MGR]
SYSMAN> DISKQUOTA ENABLE
SYSMAN> DISKQUOTA REBUILD
The command in this example resumes quota enforcement on
the default disk DJA12, which is located on node BAKER. The
DISKQUOTA REBUILD command updates the quota file, correcting
quotas and adding any new entries.
MODIFY
Changes an entry in a quota file or adjusts default values for
quotas and overdrafts. If a new quota limit is less than the
current usage count, the utility issues a warning message before
it implements the new quota.
Requires write (W) access to the quota file.
Format
DISKQUOTA MODIFY owner
Additional information available:
Parameter
owner Specifies the user identification code (UIC) or rights identifier. You can specify the UIC in numeric or alphanumeric format. For complete information on UIC specification, refer to the VMS DCL Concepts Manual. Rights identifiers are granted with the AUTHORIZE Utility and use an ID format rather than a UIC format. See the Introduction to VMS System Services Manual for a complete description. When working in nonlocal environments, make sure that the alphanumeric UIC or rights identifiers that you use are valid for the environment.
Qualifiers
Additional information available:
/DEVICE
/DEVICE=device-spec
Specifies the disk volume that contains the quota file. SYSMAN
validates the device specification. A logical name may be
specified for device-spec. If so, it 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 on another node, depending on the
established environment.
/OVERDRAFT
/OVERDRAFT=value
Specifies a positive integer that provides an overdraft value
for the specified UIC. If you omit a value, the overdraft value
defaults to the overdraft value in the entry for [0,0].
/PERMQUOTA
/PERMQUOTA=value
Specifies a positive integer that provides the quota for the
specified UIC. If you omit a value, the permanent quota defaults
to the value of the quota in the entry for [0,0].
Examples
1. SYSMAN> SET ENVIRONMENT/NODE=SIREN
SYSMAN> DISKQUOTA MODIFY /DEVICE=DUA12: [0,0] /PERMQUOTA=3000 -
_SYSMAN> /OVERDRAFT=300
The command in this example edits the entry for UIC [0,0] in
the quota file on DUA12, which is located on node SIREN.
2. SYSMAN> DISKQUOTA MODIFY /DEVICE=SYS$DISK1 [TTD,DAVIS] -
_SYSMAN> /PERMQUOTA=900
The command in this example sets the permanent quota for
UIC [TTD,DAVIS] to 900 blocks, while making no change to the
overdraft limit. SYSMAN modifies the quota file that is located
on disk SYS$DISK1 in the current environment.
REBUILD
Updates a quota file, adding new UICs and correcting usage counts
for each user on the volume.
Requires write (W) access to the quota file, plus one of the
following: SYSPRV privilege, a system UIC, or ownership of the
volume.
Format
DISKQUOTA REBUILD
Additional information available:
Qualifier
Additional information available:
/DEVICE
/DEVICE=device-spec
Specifies the disk volume that contains the quota file. SYSMAN
validates the device specification and translates any logical name
in the target environment before rebuilding the file.
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 on another node, depending on the
established environment.
Example
SYSMAN> SET ENVIRONMENT /NODE=WEST
SYSMAN> SET PROFILE /PRIVILEGE=SYSPRV
SYSMAN> DISKQUOTA ENABLE /DEVICE=DUA226:
SYSMAN> DISKQUOTA REBUILD /DEVICE=DUA226:
The command in this example enables the quota file and
reconstructs the usage counts for all entries on disk DUA226,
which is located on node WEST.
REMOVE
Removes an entry from a quota file.
Requires write (W) access to the quota file.
Format
DISKQUOTA REMOVE owner
Additional information available:
Parameter
owner Specifies the user identification code (UIC) or rights identifier. You can specify the UIC in numeric or alphanumeric format. For complete information on UIC specification, refer to the VMS DCL Concepts Manual. Rights identifiers are granted with the AUTHORIZE Utility and use an ID format rather than a UIC format. See the Introduction to VMS System Services Manual for a complete description. When working in nonlocal environments, be careful that the alphanumeric UIC or rights identifiers that you use are valid for the environment.
Qualifier
Additional information available:
/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 on another node, depending on the
established environment.
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]
The command in this example removes UIC [TTD,DAVIS] from the
quota file for disk DUA45, which is located on node MARS.
SHOW
Displays quotas, overdrafts, and usage counts.
Requires no additional privileges to display your own quota,
overdraft, and usage count, but otherwise requires read (R) access
to the quota file.
Format
DISKQUOTA SHOW owner
Additional information available:
Parameter
owner Specifies the user identification code (UIC) or rights identifier. You can specify the UIC in numeric or alphanumeric format. For complete information on UIC specification, refer to the VMS DCL Concepts Manual. Rights identifiers are granted with the AUTHORIZE Utility and use an ID format rather than a UIC format. See the Introduction to VMS System Services Manual for a complete description. You can use an asterisk wildcard character (*) to specify the quota entry as follows: Command Description DISKQUOTA SHOW [TTD,CJ] Show user CJ in group TTD DISKQUOTA SHOW [TTD,*] Show all users in group TTD DISKQUOTA SHOW * Show all entries
Qualifiers
Additional information available:
/DEVICE
/DEVICE=device-spec
Specifies the disk volume containing the quota file. DISKQUOTA
validates device specification and translates any logical name in
the target environment before displaying UIC entries.
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 on another node, depending on the
established environment.
/OUTPUT
/OUTPUT[=filespec]
Directs output to the specified file. Without a file
specification, /OUTPUT defaults to SYSMAN.LIS in the current
directory on the local node where you are running SYSMAN.
Example
SYSMAN> DISKQUOTA SHOW [ACCT,*]
The command in this example displays quotas, overdrafts, and
usage counts for all users in group ACCT on the default disk.