1 05/04/84  get_dir_quota
 2 
 3 Syntax as a command:  get_dir_quota  {paths} {-control_arg}
 4 
 5 
 6 Syntax as an active function:  [get_dir_quota {path} {-control_arg}]
 7 
 8 
 9 Function:  prints information about the directory quota and pages used
10 by inferior directories.
11 
12 
13 Arguments:
14 paths
15    are pathnames of directories for which you want quota information.
16    If one of the paths is -working_directory (-wd), your working
17    directory is used.  If you don't supply paths, your working
18    directory is assumed.  The star convention is allowed.
19 
20 
21 Control arguments:
22 -long, -lg
23    includes the cumulative time-page product for the current accounting
24    period.  The active function doesn't accept it.
25 -quota
26    returns the terminal quota on each directory.  The default is to
27    return terminal quota and number of pages used.
28 -records_left, -rec_left
29    returns the number of available pages in each directory, equal to
30    the terminal quota minus the pages used.  If a directory has no
31    terminal quota set, the available pages are computed from the
32    terminal quota on the lowest parent with nonzero terminal quota,
33    minus the pages used under that parent with nonzero terminal quota.
34 -records_used, -rec_used
35    returns the number of pages used in each directory.
36 
37 
38 Access required:  You require status permission on each directory for
39 which you want quota.  Determining the value of -records_left may
40 require access further up the hierarchy.  If the required access is
41 lacking, an error message is printed.
42 
43 
44 Notes:  The short form of output (the default) prints the number of
45 pages of quota used by the segments in that directory and in any
46 inferior directories charging against that quota.  The output is
47 prepared in tabular format, with a total, when you specify more than
48 one pathname; when you give only one, a single line of output is
49 printed.
50 
51 The long form of output gives the quota and pages-used information
52 provided in the short output.  In addition, it prints the logical
53 volume identifier of segments, the time-record product in units of
54 record days, and the date you last updated this number.  Thus, you can
55 see what secondary storage charges your accounts are accumulating.  If
56 you have inferior directories with nonzero quotas, you need print this
57 product for all these directories in order to obtain the charge.
58 
59 
60 Notes on active function:  Supply only one directory in the active
61 function.  The star convention is not allowed.
62 
63 You can specify any of -quota, -records_left, or -records_used; the
64 default is -quota.