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