1 02/13/85  get_quota, gq
 2 
 3 Syntax as a command:  gq {paths} {-control_arg}
 4 
 5 
 6 Syntax as an active function:  [gq {path} {-control_arg}]
 7 
 8 
 9 Function: returns information about the secondary storage quota and
10 pages used by segments.
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 and the corresponding price according to the rate structure
25    of the current process.
26 -nonzero, -nz
27    lists directories with nonzero quota used only.
28 -quota
29    returns the terminal quota on each directory.  (Default: to return
30    terminal quota and number of pages used)
31 
32 
33 -records_left, -rec_left
34    returns the number of available pages in each directory, equal to
35    the terminal quota minus the pages used.  If a directory has no
36    terminal quota set, the available pages are computed from the
37    terminal quota on the lowest parent with nonzero terminal quota,
38    minus the pages used under that parent with nonzero terminal quota.
39 -records_used, -rec_used
40    returns the number of pages used in each directory.
41 -sort
42    sorts directories by the requested quota value or by records used if
43    you request more than one value.  The largest value is printed
44    first.
45 
46 
47 -total, -tt
48    returns, for quota used, the total quota used by the subtree.
49    Master directories in a subtree are not included in its total.
50 -zero
51    lists directories with zero quota used only.
52 
53 
54 Access required: You require status permission on each directory for
55 which you want quota.  Determining the value of -records_left may
56 require access further up the hierarchy.  If the required access is
57 lacking, an error message is printed.
58 
59 
60 Notes: The short form of output (the default) prints the number of
61 pages of quota used by the segments in that directory and in any
62 inferior directories charging against that quota.  The output is
63 prepared in tabular format, with a total, when you specify more than
64 one pathname; when you give only one, a single line of output is
65 printed.
66 
67 The long form of output gives the quota and pages-used information
68 provided in the short output and prints the logical volume identifier
69 of segments, the time-record product in units of record days, and the
70 date you last updated this number; thus you can see what secondary
71 storage charges your accounts are accumulating.  If you have inferior
72 directories with nonzero quotas, you need print this product for all
73 these directories to obtain the charge.
74 
75 
76 Notes on active function: Supply only one directory in the active
77 function.  You can't use the star convention.
78 
79 The active function doesn't accept -long, -nonzero, -sort, and -zero.
80 
81 You can specify any of -quota, -records_left, or -records_used; the
82 default is -quota.