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