SYSMANHELP.HLB  —  DISKQUOTA  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

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.
Close Help