1 09/08/92  as_who
  2 
  3 Syntax as a command:  as_who {-control_args} {User_ids}
  4 
  5 
  6 Function: lists the contents of the answering service user tables--
  7 answer_table, absentee_user_table, and daemon_user_table, in the
  8 directory >sc1.
  9 
 10 
 11 Arguments:
 12 User_ids
 13    are access control names of the form
 14    Person_id.Project_id
 15       lists all users logged in with the specified Person_id and
 16       Project_id.  The star convention is allowed.
 17    Person_id
 18       lists all users logged in with the specified Person_id.  The star
 19       convention is allowed.
 20    .Project_id
 21       lists all users logged in with the specified Project_id.  The
 22       star convention is allowed.
 23 
 24 
 25 Control arguments:
 26 -absentee, -as
 27    prints the ratio of absentee users logged in to the number of
 28    absentee slots currently available and then lists the absentee
 29    users.
 30 -channel chn_id, -chn chn_id
 31    lists only interactive users whose tty ID matches chn_id, daemon
 32    users whose source name (e.g., prta, vinc, etc) matches chn_id, or
 33    absentee users whose absentee name (e.g., abs1) matches chn_id.  The
 34    chn_id argument can be a starname to list several users.
 35 -connected
 36    prints a list of connected processes only.
 37 -cpu
 38    shows CPU usage in seconds for the listed processes.  It requires
 39    access to metering_gate_ or phcs_.
 40 
 41 
 42 -daemon, -dmn
 43    prints the number of currently active daemon processes and then
 44    lists them.
 45 -disconnected, -disc
 46    prints a list of disconnected processes only.
 47 -group {name}, -gp {name}
 48    prints a list of users that fall under the specified load control
 49    group (see "Notes" below).
 50 -idle
 51    shows how long, in seconds, the listed processes have been idle.
 52    It requires access to metering_gate_ or phcs_.
 53 -interactive, -ia
 54    prints a list of all users having current interactive processes.
 55 
 56 
 57 -long, -lg
 58    prints the long form of output including log-in time and tty ID.  If
 59    you give no -lg, the command prints the User_id
 60    (Person_id.Project_id) and flag for each user (see "Notes" below).
 61 -name, -nm
 62    sorts the users by name.
 63 -no_header, -nhe
 64    suppresses column headings and load control heading from the printed
 65    output.
 66 -pdir_volume {lv_name}, -pdv {lv_name}
 67    either includes in the output the name of the logical volume
 68    containing the user's process directory segments (if you give no
 69    lv_name argument) or prints information about only those users
 70    whose process directory segments are on the volume specified by the
 71    lv_name argument.
 72 
 73 
 74 -process_id, -pid
 75    includes the process_ids of the listed processes.
 76 -project, -pj
 77    sorts the users by project.
 78 -secondary, -sc
 79    prints a list of all users having currently active secondary user
 80    processes (see "Notes" below).
 81 
 82 
 83 Access required: Access to the user tables is usually restricted,
 84 preventing you from using this command.  If you lack access to these
 85 tables, use the who command to list the whotab segment in >sc1, which
 86 is a public list of logged-in users.
 87 
 88 
 89 Notes: As an active function, as_who returns Person_id.Project_id for
 90 the processes selected for output, separated by spaces.
 91 
 92 The default sort is by login time.
 93 
 94 Anonymous users' true log-in names are shown, preceded by a *.
 95 
 96 Specification of -long returns time of login, tty ID, weight, device
 97 channel, load control group, flags indicating special variables, and a
 98 User_id for each user.
 99 
100 
101 Users should note the selection control arguments are usually additive.
102 E.g. as_who -connected -disconnected is equivalent to as_who
103 -interactive; as_who -as -daemon lists both absentee and deamon
104 processes, -daemon does not override the absentee selection.
105 
106 Specification of any User_id will cause the headers to be suppressed.
107 
108 
109 Notes on flags: Included in the output next to the User_id are flags,
110 indicating preemption attributes (primary or secondary status) and the
111 current status of that user's process (these attributes vary according
112 to the login instance and the discretion of the project
113 administrator).  When you invoke as_who with -long, the column listing
114 these flags has the heading "PNDS." The flags in these four-column
115 positions indicate the user's status with respect to Preemption,
116 Nolist, Disconnected, and Suspended statuses.  Additionally if you
117 select -idle, R and W flags can occur.  An R flag indicates the process
118 is ready; a W flag indicates the process is waiting for another event.
119 
120 
121 List of preemption attribute flags:
122 <blank>
123    indicates that the user has primary status.
124 S
125    indicates that the user has secondary status.
126 +
127    the user has the nobump attribute (cannot be preempted).
128 >
129    the user, whose grace period has run out, is subject to bumping
130    (preemption).
131 X
132    the user has been bumped but has not yet logged out.
133 D
134    identifies a daemon user.
135 
136 
137 List of nolist flags:
138 <blank>
139    the user does not have the nolist attribute.
140 N
141    the user has the nolist attribute.
142 
143 
144 List of disconnected flags:
145 <blank>
146    the user is not disconnected.
147 D
148    the user is disconnected.
149 
150 
151 List of suspended flags:
152 <blank>
153    the user is not suspended.
154 S
155    the user is suspended.