SYSMANHELP.HLB  —  DISKQUOTA  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, SYSMAN issues a warning message before it
    implements the new quota.

    Requires write (W)  access to the quota file.

    Format

      DISKQUOTA MODIFY  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 a complete description
    of rights identifiers, see the VSI OpenVMS Programming Concepts
    Manual.

    When working in nonlocal environments, make sure 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 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 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 you omit a value, 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 you omit a value, the permanent quota defaults
    to the value of the quota in the entry for [0,0].

3  –  Description

    The DISKQUOTA MODIFY command changes values in a quota file for
    the disk named in the device specification. If you establish a
    quota limit that is less than the current usage count, a user can
    still log in and out, but cannot create files.

    After creating a quota file, use the DISKQUOTA MODIFY command to
    set default values for quotas and overdrafts. UIC [0,0] sets the
    default permanent quota and overdraft values for a quota file,
    so you must change the entry [0,0] to values appropriate for
    your installation. Unless you specify quota and overdraft values
    when adding a file entry, SYSMAN applies these defaults to UIC
    entries.

4  –  Examples

    1.SYSMAN> SET ENVIRONMENT/NODE=NODE21
      SYSMAN> DISKQUOTA MODIFY /DEVICE=DUA12: [0,0] -
      _SYSMAN> /PERMQUOTA=3000 /OVERDRAFT=300

      The commands in this example edit the entry for UIC [0,0] in
      the quota file on DUA12, which is located on NODE21.

    2.SYSMAN> DISKQUOTA MODIFY /DEVICE=SYS$DISK1 [TTD,DAVIS] -
      _SYSMAN> /PERMQUOTA=900

      This command 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.

      If the user name DAVIS has a unique UIC on the system, you can
      enter the following command:

        SYSMAN> DISKQUOTA MODIFY DAVIS/PERMQUOTA=900
Close Help