1 :Info: terminal_report:  1986-11-19  terminal_report
 2 
 3 Syntax as a command:  terminal_report {-control_args}
 4 
 5 
 6 Function:  Displays terminal usage on the system based on the
 7 information obtained from the answering service logs.
 8 
 9 
10 Control arguments:
11 -from time, -fm time
12    specifies that the first message being examined for terminal data in
13    the log is the first message at or after the specified time.  If no
14    -from value is specified, the default is the first message in the
15    log.  This is incompatible with -last.
16 -to time
17    specifies the last message in the log to be examined for terminal
18    data.  If not specified, the default is all the remaining messages
19    in the log.  This is incompatible with -for and -last.
20 -for time
21    specifies a time interval relative to the starting time
22    (specified by -from) containing the messages to be examined.  This
23    is incompatible with -to and -last.
24 
25 
26 -last time, -lt time
27    specifies that only the most recent messages in the given time
28    interval are to be examined.  This is incompatible with -to, -from
29    and -for.
30 -terminal_type name, -ttp name
31    specifies that only terminal type data for the terminal type named
32    name be displayed.
33 -all_terminal_types, -att
34    specifies that all terminal type data is to be displayed. (Default)
35 -user name
36    specifies that only the terminal type data for the user named name
37    be displayed (name is any Person_id).
38 -all_users, -au
39    specifies that all terminal type data found in the log should be
40    displayed. (Default)
41 
42 
43 -meters, -mt
44    specifies that cpu time and connect time meters for the individual
45    terminal types, and personids is to be given.
46 -no_meters, -nmt
47    specifies that cpu time and connect time meters is not to be given.
48    (Default)
49 -output_file path, -of path
50    directs output to the file whose pathname is path.
51 -no_output_file, -nof
52    specifies that output is to be printed on the terminal. (Default)
53 
54 
55 Access required:  read permission is required on the log segments
56 themselves, and status permission is required on their containing
57 directories.  If an access error is encountered searching for older
58 logs, the search is stopped at that point, and no further history
59 will be available.
60 
61 
62 Notes:
63 Use of the -meters control argument will substantially increase the
64 time taken to produce the output.  Much more log searching and checking
65 must be performed to produce the meter information.
66 
67 
68 The command displays data in two formats.  First, it displays all
69 individual terminal type information sorted by terminal types.  Second,
70 it displays the same information sorted by answerbacks.
71 
72 
73 :hcom:
74 
75 
76 
77 /****^  HISTORY COMMENTS:
78   1) change(2020-12-16,GDixon), approve(2021-02-22,MCR10088),
79      audit(2021-05-27,Swenson), install(2021-05-27,MR12.6g-0056):
80       A) Change "Syntax:" to "Syntax as a command:" in command info seg
81          last changed after 1984.
82                                                    END HISTORY COMMENTS */
83 
84 
85