Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

ADD

CREATE

DELETE

DISABLE

ENABLE

MODIFY

REBUILD

REMOVE

SHOW

Parameter

Qualifiers

/DEVICE

/OVERDRAFT

/PERMQUOTA

Qualifier

Example

/DEVICE

Qualifier

Example

/DEVICE

Qualifier

Example

/DEVICE

Parameter

Qualifiers

Examples

/DEVICE

/OVERDRAFT

/PERMQUOTA

Qualifier

Example

/DEVICE

Parameter

Qualifier

Example

/DEVICE

Parameter

Qualifiers

Example

/DEVICE

/OUTPUT

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:

ParameterQualifiers

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/OVERDRAFT/PERMQUOTA

/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:

QualifierExample

Qualifier

Additional information available:

/DEVICE

/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:

QualifierExample

Qualifier

Additional information available:

/DEVICE

/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:

QualifierExample

Qualifier

Additional information available:

/DEVICE

/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:

ParameterQualifiersExamples

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/OVERDRAFT/PERMQUOTA

/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:

QualifierExample

Qualifier

Additional information available:

/DEVICE

/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:

ParameterQualifierExample

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=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:

ParameterQualifiersExample

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/OUTPUT

/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.

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026