1 03/08/82  monitor_quota
 2 
 3 Syntax:  monitor_quota  {-control_args}
 4 
 5 
 6 Function: calculates storage of a directory and will send a warning
 7 message at the approach of a record quota overflow condition.
 8 
 9 
10 Control arguments:
11 -call STR {N}
12    specifies that STR is to be passed to the command processor as a
13    command when a directory's segment quota used is found to be
14    greater then 90 percent of the quota assigned.  If N is given then
15    the default of 90 percent will be overridden.  (See Notes below.)
16 -console {N}
17    sends a warning of an approaching record quota overflow condition
18    to the system console.  Access to the phcs_ gate is required to
19    issue warnings on the system console.  If N is specified then the
20    default percent value at which the warning is to be issued will be
21    overridden.
22 -off
23    turns off all monitoring completely in this process.  This control
24    argument must not be given with any other arguments.
25 
26 
27 -pathname, -pn
28    specifies the pathname of the directory to be monitored. Only one
29    path may be given when invoked. The default is the user's working
30    directory.
31 -repeat DT, -rpt DT
32    identifies the interval to set the monitor time to.  This argument
33    will override the default time calculation.  The DT is a relative
34    time >= 1 minute and acceptable to convert_date_to_binary_.
35 -print, -pr
36    provides a list of directories being monitored and control
37    information on the selected directories.
38 -warn User_ids {N}
39    sends the warning message to the individual specified in
40    User_id.  A limit of ten users may be listed with the
41    use of this control argument.  The invoking user will be sent a
42    message by default if this control argument and -console is
43    omitted.  If N is specified then the default percent value at which
44    the warning is to be issued will be overridden.
45 
46 
47 Notes: This command can be used several times in a process to monitor
48 several different directories.  Use of the -off control argument stops
49 monitoring of all directories.
50 
51 The number of records given with the -call, -console and -warn {N}
52 control argument must be less then the quota assigned to the
53 directory.
54 
55 The default interval when invoked without the -repeat control argument
56 will automatically be set with a time interval dependent on how much
57 available storage was found.  That is, if the directory was 50% full,
58 then an alarm would be set to trigger in 30 minutes to check again.
59 If the quota was found to be at 80% then a message would be sent and
60 an alarm time of 2 minutes would be set.  At 90% it would send a
61 warning every minute, and if -call has been provided, then the
62 specified string will be passed to the command processor.