1 4/4/85 forum request: list_meetings, lsm
2
3 Syntax: lsm meeting_names -control_args
4
5
6 Syntax as an active request: lsm -control_args
7
8
9 Function: Prints a list of selected meetings on the user's terminal.
10 For each meeting selected, information about the names of the meeting
11 and per-user meeting attributes are listed.
12
13
14 Arguments:
15 meeting_names
16 are optional meeting_names. If any are supplied, information about
17 only the specified meeting_names is printed. The star convention is
18 supported for meeting_names. If no meeting_names are given,
19 information for all meetings found in the 'forum' search path
20 will be printed.
21
22
23 Control arguments:
24 -absolute_pathname, -absp
25 Causes the absolute pathname of a meeting to be printed. The default
26 is to list the long and short meeting names only.
27 -adjourned, -adj
28 specifies that information about adjourned meetings be printed.
29 -all, -a
30 specifies that information about all meetings be printed. The
31 default is to print information about the meetings in which the user
32 is eligible to participate only.
33 -before DATE_TIME, -be DATE_TIME
34 selects meetings which have not changed since the specified time.
35 DATE_TIME is any string acceptable to the convert_date_to_binary_
36 subroutine.
37
38
39 -brief, -bf
40 suppresses the message 'No meetings have changed' which is printed
41 by default if the -changes control argument is used and no meetings
42 have changed.
43 -chairman username, -cm username
44 specifies that information about meetings of which the user is
45 chairman be printed. If username is not given, the user's
46 personid will be used.
47
48
49 -changes, -chg
50 specifies that information about meetings in which the user is a
51 participant and in which new transactions have been entered be
52 printed.
53 -count, -ct
54 prints out the number of new transactions for a meeting in which the
55 user is participating. This control argument may not be used if
56 list_meetings is invoked as an active request.
57 -eligible, -elig
58 specifies that information about all meetings in which the user is
59 eligible to participate be printed. Default
60
61
62 -exclude meeting_names, -ex meeting_names
63 excludes the meetings identified by meeting_names from the output
64 list. This control argument is designed to be used when a starname
65 has been supplied as the meeting_names in order to exclude the
66 specified meetings from being selected. The default -include is to
67 select all meetings which match the specified starname.
68 -from DATE_STRING, -fm DATE_STRING
69 selects meetings which have changed since DATE_STRING. DATE_STRING
70 is any string acceptable to the convert_date_to_binary_ subroutine.
71 The default is the current time.
72 -header, -he
73 print the header. This is the default, unless the -changes
74 control argument was supplied.
75 -include meeting_names, -incl meeting_names
76 specifies that the meetings identified by meeting_names not be
77 excluded from the output list. This control argument is intended to
78 be used when a starname has been specified for selecting meetings.
79 It is the default.
80
81
82 -inhibit_error, -ihe
83 specifies that warning messages for such things as bad meeting
84 format and errors encountered while searching for meetings are not
85 to be printed. Default
86 -long, -lg
87 causes the message 'No meetings have changed' to be printed if the
88 -changes control argument was used and no meetings in which the user
89 is a participant had changed. Default
90 -no_adjourned, -nadj
91 specifies that information about adjourned meetings not be printed.
92 -no_changes, -nchg
93 specifies that changed meetings are not to be listed.
94 -no_header, -nhe
95 suppress printing of the meeting header.
96 -no_inhibit_error, -nihe
97 specifies that all warning messages be printed.
98
99
100 -no_notify, -nnt
101 specifies that meetings in which the notify flag is set are not to
102 be listed.
103 -no_participating, -npart
104 specifies that meetings in which the user is a participant are not
105 to be listed.
106 -no_read_only, -nro
107 do not list meetings to which the user has only read access.
108 -notify, -nt
109 specifies that only meetings in which the user has the notify flag
110 set be listed.
111 -participating, -part
112 specifies that only meetings in which the user is participating be
113 listed. The default is to print information about all meetings
114 which the user is eligible to participate in.
115
116
117 -read_only, -ro
118 list only meetings to which the user has only read access.
119 -user access_id
120 specifies that the user specified by access_id be used in
121 determining participation, eligibility, and changes attributes.
122 access_id is in the form Person_id.Project_id.tag, where any of the
123 components can be the character '*'. If a component is omitted, it
124 is assumed to be '*'.
125 -verbose, -vb
126 prints the chairman's userid and current and last transactions for
127 each meeting. May not be used with -changes or when lsm is being
128 invoked as an active request.
129
130
131 List of flags:
132 The output from this command may include flags that have the following
133 interpretation:
134 a attending flag
135 The user is currently attending this meeting.
136 c change flag
137 new transactions have been entered in the proceedings of the
138 meeting since the user last attended this meeting.
139 e eligible flag
140 the user can participate in the meeting.
141 j adjourned flag
142 the chairman has temporarily adjourned the meeting.
143 n notify flag
144 the user has turned on the notify flag in the meeting i.e.
145 the user has requested online notification when new
146 transactions are entered in the meeting.
147
148
149 o observer flag
150 the user has only read access to the meeting.
151 p participant flag
152 the user is a participant in meeting i.e. has gone to the
153 meeting at least once.
154 r removed flag
155 the user has removed himself from participation in the
156 meeting.
157
158
159 Notes on flags: The flags corresponding to the selection criteria are
160 not shown i.e. if the user is selecting meetings to which he is
161 eligible the "e" flag is not printed it is assumed.