Digital PDFs

AA-Z413A-TE

September 1984

28 pages

Original

1.5MB

view download

OCR Version

1.6MB

view download

Document:	VAX/VMS Disk Quota Utility Reference Manual
Order Number:	AA-Z413A-TE
Revision:	000
Pages:	28
Original Filename:	aa-z413a-te.pdf

OCR Text

VAX/VMS
Disk Quota Utility
Reference Manual
Order No. AA-Z413A-TE

dlilgliltlall

- software

VAX/VMS
Disk Quota Utility
Reference Manual
Order Number: AA-Z413A-TE

September 1984

This document describes the Disk Quota Utility for use on VAX
processors.

Revision/Update Information:

This is a new manual.

Software Version:

VAX/VMS Version 4.0

digital equipment corporation
maynard, massachusetts

September 1984

The information in this document is subject to change without notice and should

not be construed as a commitment by Digital
Equipment Corporation. Digital
Equipment Corporation assumes no responsibility for any errors that may appear
in this document.
The software described in this document is furnished under a license and may be

used or copied only in accordance with the terms of such license.

No responsibility is assumed for the use or reliability of software on equipment
that is not supplied by Digital Equipment Corporation or its affiliated companies.

The postpaid READER'S COMMENTS form on the last page of this document

requests the user’s critical evaluation to assist in preparing future documentation.

The following are trademarks of Digital Equipment Corporation:
DEC

DIBOL

DEC/CMS

EduSystem

VAX

DEC/MMS

DECnet

IAS

VAXcluster

MASSBUS

VMS

DECsystem-10

PDP

DECSYSTEM-20

PDT

DECUS

RSTS

DECwriter

RSX

UNIBUS

dlilgli/t[all]
ZK-2305

This document was prepared using an in-house documentation production system. All

page composition and make-up was performed by TEX, the typesetting system developed

by Donald E. Knuth at Stanford University. TgX is a registered trademark of the American
Mathematical Society.

Disk Quota Contents
PREFACE

NEW AND CHANGED FEATURES
FORMAT
_—

DISKQUOTA COMMANDS
-_—

DESCRIPTION

vii
DQT-1
DQT-1

DQT-2

CREATING A NEW QUOTA FILE

DQT-2

ERROR MESSAGES

DQT-3

_—

COMMANDS

DQT-4

ADD

DQT-5

CREATE

DQT-6

DISABLE

DQT-7

ENABLE

DQT-8

EXIT

DQT-9

HELP

DQT-10

MODIFY

DQT-11

REBUILD

DQT-12

REMOVE

DQT-13

SHOW

DQT-14

USE

DQT-15

Disk Quota Contents

INDEX

TABLES

DQaT-1

DISKQUOTA Command Summary

DQT-2

Preface
Intended Audience
This manual is intended for VAX/VMS system managers, operators, and
system programmers.

Structure of This Document
This document is composed of three major sections.

The Format Section is an overview of DISKQUOTA and is intended as a
quick reference guide. The format summary contains the DCL command
that invokes DISKQUOTA, listing all commands and qualifiers. The usage
summary describes how to invoke and exit from DISKQUOTA, how to direct
output, and any restrictions you should be aware of.
The Description Section explains how to use DISKQUOTA.

The Command Section describes each DISKQUOTA command. Commands
appear in alphabetical order.

Associated Documents
For additional information on the topics covered in this document, refer to
the VAX/VMS DCL Dictionary and the Guide to VAX/VMS System Management
and Daily Operations.

Conventions Used in This Document
Convention

Meaning

[reT)

A symbol with a one- to three-character abbreviation
indicates that you press a key on the terminal, for

example, [RET] .

The phrase CTRL/x indicates that you must press

the key labeled CTRL while you simultaneously press

another key, for example, CTRL/C, CTRL/Y, CTRL/O.

$ SHOW TIME

05-JUN-1985 11:55:22

Command examples show all output lines or

prompting characters that the system prints or

displays in black letters. All user-entered commands
are shown in red letters.

$ TYPE MYFILE.DAT

Vertical series of periods, or ellipsis, mean either
that not all the data that the system would display in
response to the particular command is shown or that
not all the data a user would enter is shown.

file-spec,...

Horizontal ellipsis indicates that additional parameters,

values, or information can be entered.

Preface

Convention
[logical-name]

Meaning
Square brackets indicate that the enclosed item is
optional.

(Square brackets are not, however, optional

in the syntax of a directory name in a file specification
or in the syntax of a substring specification in an
assignment statement.)
quotation marks

apostrophes

The term quotation marks is used to refer to double
quotation marks (”). The term apostrophe (') is used
to refer to a single quotation mark.

New and Changed Features
There are no technical changes in the Disk Quota Utility for VAX/VMS
Version 4.0.

vii

DISK QUOTA
Description

MODIFY
/PERMQUOTA
=quota

/OVERDRAFT
=quota-plus

REBUILD
REMOVE

SHOW
USE

DESCRIPTION You use the Disk Quota Utility to allocate disk volume space to users. Table
DQT-1 summarizes the DISKQUOTA commands by format and function.

Table DQT-1

Command

DISKQUOTA Command Summary

Function

ADD

Adds an entry to the quota file

CREATE

Creates a quota file for a volume that does not currently

contain one

DISABLE

Suspends quota operations on a volume

ENABLE

Resumes quota operations on a volume

EXIT

Returns the user to DCL command level

HELP

Lists the DISKQUOTA commands

MODIFY

Changes an entry in the quota file

REBUILD

Reconstructs the usage counts for all entries

REMOVE

Deletes an entry from the quota file

SHOW

Displays quotas and usage counts

USE

Specifies the volume to be acted upon

Creating a New Quota File
The sequence of commands for creating a new quota file usually includes:
1

USE—To name the volume (can be omitted if the volume is the user's
default device)

CREATE—To create the quota file

MODIFY—To set the quota and overdraft for UIC [0,0]

REBUILD—To add entries for existing files (can be omitted on an empty

volume)

ADD—To add entries (one ADD command per entry) for UICs not
automatically added during Step 4

The sequence of commands for modifying an existing quota file typically

includes (1) a USE command followed by (2) an ADD, MODIFY, or REMOVE

command for each entry being changed.

DQT-2

DISK QUOTA
Description

Error Messages
The VAX/VMS System Messages and Recovery Procedures Reference Manual lists
messages issued by the Disk Quota Utility, and provides explanations and

suggested user actions.

DQT-3

DISK QUOTA
Commands

COMMANDS

DAT-4

This section describes DISKQUOTA commands and provides examples of

their use.

DISK QUOTA
ADD

ADD
Adds an entry to the quota file. The usage count for a new entry is
initialized to zero. The ADD command requires write access to the

quota file.

—
e

FORMAT
command

ADD

uic

parameter

Specifies the user identification code (UIC) for which the quota entry is added.

command
qualifiers

/PERMQUOTA=quota
Specifies a positive integer that provides the quota for the specified UIC. If

You can specify the UIC in numeric or alphanumeric format. (For complete
information on UIC specification, refer to the VAX/VMS DCL Dictionary.)

you omit the quota value, the quota defaults to the value of the quota in the
entry for [0,0].

/OVERDRAFT-quota-plus
Specifies a positive integer that provides an overdraft value for the specified
UIC. If you omit the quota-plus value, the overdraft value defaults to the

quota-plus in the entry for [0,0].

e
e

EXAMPLE
DISKQ> ADD [300,211] /PERMQUOTA=200/O0VERDRAFT=50

The command in this example sets the quota for UIC [300,211] to 200 and the
overdraft to 50 (for an absolute limit of 250 blocks).

DQT-5

DISK QUOTA
CREATE

CREATE

Creates a quota file for a volume that does not currently contain one.

FORMAT

CREATE

command

None.

parameters

command
qualifiers

None.

DESCRIPTION A quota file must not already be present on the volume being used. The

CREATE command should be immediately followed by a MODIFY command

for UIC [0,0] with quota and overdraft set to reasonable default values.

The CREATE command requires write access to the volume’s master file

directory (MFD), as well as one or more of the following: SYSPRV privilege,
a system UIC, or ownership of the volume.

EXAMPLE
DISKG> CREATE

The command in this example creates a new quota file.

DQT-6

DISK QUOTA
DISABLE

DISABLE
Suspends the maintenance and enforcement of quotas on a volume.
Use of the DISABLE command requires one or more of the
following: the SYSPRV privilege, a system UIC, or ownership of
the volume.

FORMAT

DISABLE

command

None.

command

None.

parameters

qualifiers

EXAMPLE
DISKQ> DISABLE

The command in this example suspends quota enforcement.

DQT-7

DISK QUOTA
ENABLE

ENABLE
Resumes quota enforcement on a volume.
Use of the ENABLE command requires one of the following: the

SYSPRYV privilege, a system UIC, or ownership of the volume.

et
e e, e, e
e
e

FORMAT

ENABLE

command

None.

parameters

command

qualifiers

None.

EXAMPLE
DISKQ> ENABLE

The command in this example resumes quota enforcement.

DISK QUOTA
EXIT

Returns the user to DCL command level.

FORMAT

EXIT

command

None.

parameters

command

None.

qualifiers

I
—

EXAMPLE
DISQ>

EXIT

The command in this example terminates the DISKQUOTA session and
returns control to the DCL level.

DQT-9

DISK QUOTA
HELP

HELP
The HELP command lists and explains the DISKQUOTA commands.
e
)

FORMAT

HELP [command]

command

parameters

Specifies the name of a DISKQUOTA command.

command

None.

qualifiers

EXAMPLE
DISKQ> HELP ENABLE
ENABLE

Enable diskquotas on the default volume.
be selected by issuing the USE command.
on a volume,

The default volume may
Once a quota file is created

disk quotas are assumed enabled until

explicitly

disabled.
FORMAT:
ENABLE

The command in this example displays information about the ENABLE
command.

DQT-10

DISK QUOTA
MODIFY

MODIFY

Changes an entry in the quota file. The MODIFY command requires
write access to the quota file.

If the disk quota is less than the current usage count, a warning
message is issued. (The new quota does take effect, however.)

e
MODIFY uic
FORMAT
command

parameter

uic

Specifies the user identification code (UIC). You can specify the UIC in
numeric or alphanumeric format. (For complete information on UIC specification, refer to the VAX/VMS DCL Dictionary.)

/PERMQUOTA=quota
Specifies a positive integer that provides the quota for the specified UIC. If
you omit the quota value, the quota defaults to the value of the quota in the
entry for [0,0].

/OVERDRAFT=quota-plus
Specifies a positive integer that provides an overdraft value for the specified
UIC. If you omit the quota-plus value, the overdraft value defaults to the
quota-plus in the entry for [0,0].

e
EXAMPLE
DISKQ> MODIFY [300,211) /PERMQUOTA=300

The command in this example sets the permanent at}ltxota for UIC [300,211] to
300 blocks, while making no change to the overdraft.

DQT-11

DISK QUOTA
REBUILD

REBUILD
Reconstructs the usage counts for all entries on the volume.
_

FORMAT

REBUILD

command

None.

parameters

command

None.

DESCRIPTION

The REBUILD command automatically adds entries for files owned by UICs

qualifiers

with no entries in the quota file, setting their quotas and overdrafts to the
values of the defaults in UIC [0,0]. While the REBUILD command is ex-

ecuting, file activity on the volume is frozen—no files can be created,
deleted, extended, or truncated. For this reason, the command should be

used judiciously, normally in the following situations:

Establishing a quota file—When a quota file is created on a volume with

existing files, the REBUILD command should be run before the ADD
command. REBUILD adds entries and records the existing usage for all

UICs with detected usage.

Reenabling disk quotas—If usage counts have not been updated for some
period because of suppression or suspension of the DISKQUOTA feature,

REBUILD should be run to correct the usage.

The REBUILD command requires write access to the quota file, as well as one

of the following: the SYSPRV privilege, a system UIC, or ownership of the

volume.

_—

EXAMPLE
DISKQ>

REBUILD

The command in this example reconstructs the usage counts for all entries on
the volume.

DQAT-12

DISK QUOTA
REMOVE

REMOVE
Deletes an entry from the quota file. The REMOVE command
requires write access to the quota file.

If the usage count for the UIC is not zero, a warning message
is issued. (The UIC is removed, however.) UIC [0,0] cannot be
removed.

FORMAT
command
parameter

REMOVE

uic

Specifies the user identification code (UIC). You can specify the UIC
in numeric or alphanumeric format. (For complete information on UIC
specification, refer to the VAX/VMS DCL Dictionary.)

command

None.

qualifiers

EXAMPLE
DISKG> REMOVE [300,211]

The command in this example deletes UIC [300,211] from the quota file.

DQT-13

DISK QUOTA
SHOW

SHOW
Displays quotas, overdrafts, and usage counts.
Use of the SHOW command requires no privileges to show one’s
own quota, overdraft, and usage count, but otherwise requires read

access to the quota file.

FORMAT
command
parameters

SHOW uic
uic
Specifies the user identification code (UIC). You can specify the UIC

in numeric or alphanumeric format. (For complete information on UIC
specification, refer to the VAX/VMS DCL Dictionary.)
You can use an asterisk wildcard character (+) to specify the UIC as follows:

command
qualifiers

Command

Description

SHOW [300,211]

Show user 211 in group 300

SHOW [300,+]

Show all users in group 300

SHOW [+,211]

Show all users with a member number of 211

SHOW [+,1]

Show all users

None.

EXAMPLE
DISKQ>

sHOw

([360.+]

The command in this example displays quotas, overdrafts, and usage counts
for all users in group 360.

DQT-14

DISK QUOTA
USE

USE
Specifies the volume to be acted upon.
—
A

FORMAT
command
parameter

USE

device

Specifies the physical or the logical name of the device for which disk quotas
are being set.

If USE is not specified, DISKQUOTA uses the user’s default device. USE
can be specified more than once during a session to work with quota files on
more than one volume.

Any volume in a volume set can be specified. The volume actually operated
on, however, is relative volume 1.

command

None.

qualifiers

EXAMPLES
1}

DISKQ> USE DMA2:

DISKQ> USE X2_RESEARCH_DATA

This command specifies the device by its physical name, DMA2:.
This command specifies the logical name of the physical device.

DQT-15

Index

ADD command *DQT-56

Quota file

altering® DAT-11
creating®DQT-2

deleting an entry*DQT-13
displaying an entry*DQT-14

Command summary®DQT-2
CREATE command ® DQT-6

REBUILD command * DQT-12
REMOVE command *DQT-13
DISABLE command®DQT-7

S
SHOW command ®DQT-14

ENABLE command *DQT-8
EXIT command *DQT-9
Exiting from DISKQUOTA ¢DQT-1

U
Usage counts

reconstructing® DQT-12
USE command *DQT-15

HELP command *DQT-10

\"/
Volume specification® DQT-15

Invoking DISKQUOTA ¢DQT-1

MODIFY command®DQT-11

Index—1

VAX/VMS Disk

Quota Utility
Reference Manual

AA-Z413A-TE
I
——

READER’'S

Note: This form is for document comments only. DIGITAL will use comments

submitted on this form at the company’s discretion. If you require a written reply

COMMENTS and are eligible to receive one under Software Performance Report (SPR) service,
submit your comments on an SPR form.

Did you find this manual understandable, usable, and well organized? Please make suggestions for
improvement.

Did you find errors in this manual? If so, specify the error and the page number.

Please indicate the type of user/reader that you most nearly represent:
O Assembly language programmer
O Higher-level language programmer
O Occasional programmer (experienced)
O User with little programming experience
O Student programmer

O Other (please specify)

Name

Date

Organization
Street

City

State

Zip Code.

or Country

—

Do Not Tear - Fold Here and Tape

No Postage
Necessary
if Mailed in the
United States

BUSINESS REPLY MAIL
FIRST CLASS PERMIT NO.33 MAYNARD MASS.
POSTAGE WILL BE PAID BY ADDRESSEE

SSG PUBLICATIONS ZK1-3/J35
DIGITAL EQUIPMENT CORPORATION

110 SPIT BROOK ROAD

—

Do Not Tear- Fold Here

Cut Along Dotted Line

NASHUA, NEW HAMPSHIRE 03062-2698