1 8/7/86  forum_list_users, flsu
  2 
  3 
  4 Syntax as a command:  flsu {meeting_name} {-control_args}
  5 
  6 
  7 Syntax as an active function:  [flsu {meeting_name} {-control_args}]
  8 
  9 
 10 Function:  prints a list of selected participants of a meeting.  For
 11 each participant selected, the Person_id, Project_id, current
 12 transaction number (last one seen), the date/time last attended, and
 13 several flags are listed.  As an active function it returns a list of
 14 Person_ids.
 15 
 16 
 17 Arguments:
 18 meeting_name
 19    is the name or pathname of the meeting for which participants are to
 20    be listed.  Either this argument or the -meeting control argument
 21    (but not both) must be given.
 22 
 23 
 24 Control arguments:
 25 -after TIME, -af TIME
 26    lists only those participants who have attended since the given
 27    time.
 28 -all, -a
 29    lists all participants, including those who are not participating in
 30    the meeting.
 31 -ascending, -asc
 32    sort in ascending order.  This is the default for sorting by name.
 33    This may not be used if invoked as an active request.
 34 -attending, -at
 35    lists only participants who are currently attending this meeting.
 36 -before TIME, -ne TIME
 37    lists only those participants who have not attended since the given
 38    time.
 39 
 40 
 41 -brief, -bf
 42    suppresses the message "No participants were selected."
 43 -descending, -dsc
 44    sort in descending order.  This is the default for sorting by time
 45    last attended.  This control argument cannot be used if list_users
 46    is invoked as an active request.
 47 -eligible, -elig
 48    prints a list of users and projects that are eligible to attend the
 49    meeting.  Read-only eligibility is denoted by an asterisk (*).  This
 50    control argument cannot be used if list_users is invoked as an
 51    active request.  This control argument cannot be combined with any
 52    other control argument.
 53 -header, -he
 54    prints the header.  prints the header.  This control argument cannot
 55    be used if list_users is invoked as an active request.  (Default)
 56 
 57 
 58 -long, -lg
 59    prints the "No participants were selected."  message if this is the
 60    case.  (Default)
 61 -meeting meeting_name, -mtg meeting_name
 62    lists participants of the meeting_name meeting.  The meeting_name
 63    argument can be either a name or a pathname of a meeting.  The
 64    default lists participants of the current meeting.
 65 -names_only
 66    only prints the names of the selected participants.  This control
 67    argument is not valid if names_only is invoked as an active request.
 68 -no_header, -nhe
 69    suppresses printing of the name_list header.
 70 
 71 
 72 -no_notify, -nnt
 73    list only those users who do not have the notify switch set.
 74 -no_participating, -npart
 75    lists only those users who are no longer participating.
 76 -no_read_only, -nro
 77    does not list read-only participants.
 78 -notify, -nt
 79    lists only participants with the notify flag on.
 80 -only_deleted, -odl
 81    lists only information for participants who have been deleted by the
 82    chairman.  (Default)
 83 
 84 
 85 -only_non_deleted, -ondl
 86    lists only information for participants who have not been deleted by
 87    the chairman.  (Default)
 88 -participating, -part
 89    lists only users who are participating.  (Default)
 90 -project Project_ids, -pj Project_ids
 91    lists only information about participants on the specified project.
 92    All arguments following -project until the next control argument are
 93    taken as Project_ids.
 94 -read_only, -ro
 95    lists just read-only participants.
 96 -seen transaction_number
 97    lists only participants who have read the specified transaction.
 98 
 99 
100 -sort TYPE
101    sorts the output by TYPE.  TYPE is either "name" for sorting by the
102    Person_id of participants, "last_seen" (ls) for sorting by highest
103    transaction seen, or "date_time_attended" (dta) for sorting
104    by the time the participant last attended the meeting.  This control
105    argument can not be used for the active function.
106 -totals, -tt
107    prints only the total number of participants selected.
108 -unseen transaction_number
109    lists only participants who have not read the specified transaction.
110 -user Person_ids
111    prints only information about the named participants.  All arguments
112    following -user until the next control argument are taken as
113    Person_ids.
114 
115 
116 Notes:  The displayed flags have the following meanings:
117 
118      r    the participant has been removed from the meeting and is
119           therefore no longer a participant.
120 
121      n    the user has the notify flag turned on.
122 
123      o    the user is an observer and cannot enter transactions.