Metropoli BBS
VIEWER: excerpt MODE: TEXT (ASCII)
Excerpt from CHANGES.TXT:
JRBUTILS v1.1     1-Aug-1991

2. Bugs Fixed

   (b) USERS did not always correctly detect the maximum number of
       connections for the particular version of Netware.
   (c) USERS /a displayed the previous connection's network address for
       an NLM, or garbage if the NLM had connection 1.

3. New Features

   (a) USERS can display logins for members of selected groups.
   (b) USERS can display logins or connections on all servers to which the
       workstation is currently attached (previously it did the current
       server, selected servers or all servers on the net).
   (c) USERS can optionally display 30 character locations.
   (d) USERS now accepts network addresses in addition to station addresses
       in location.srt.
   (e) DQUOTA, SDQUOTA and USERS have had their command line parsing
       improved. Options may now be preceded by / or -, and invalid
       options are rejected rather than ignored.

Excerpt from JRBUTILS.TXT:
JRB Utilities                                           30-JUL-91

      JRB Utilities

The following programs are provided without warranty. Although every effort
has been made to ensure that they are bug free, and perform as described,
neither the author nor Lincoln University accept any liability whatsoever for
any damage or loss incurred as a result of using these programs.

Please report any problems to j.baird@ono.lincoln.ac.nz.


Displaying Users Logged In
--------------------------

USERS is an enhanced version of USERLIST. It has the following
advantages: 

o     Shows the user's full name as well as the username.
o     Can show where a user is logged in.
o     Shows the number of users logged in.
o     Can show users logged in on all specified servers, all servers on the
      network or all servers to which the workstation is attached.
o     Can show all connections including those where no user is logged in.
o     Can show members of selected groups who are logged in.

      Usage: users [<options>]

      options = /a             Displays network addresses rather than the
                               fullname and login time.
                /c             Show all connections (includes workstations
                               which are connected to the server, but dont
                               have a user logged in).
                /g=group(s)    Select by group.  Group names must be separated
                               by commas and up to 10 groups may be specified.
                /l=location    Displays all users at the specified location.
                               The location may be preceded or followed by a *
                               e.g. /l=h228* would display all users logged on
                               in H228.
                /o             Display a 30 character location and omit the
                               login date and time.
                /n=network address
                               Show those users on a particular network
                               segment.  Leading zeros may be omitted e.g.
                               /n=1b would show all users whose workstations
                               are connected directly to network 0000001B.
                /p             Display the output one screenful at a time.
                /s=servers     Displays a list of users on the named servers.
                               You may enter one or more server names (maximum
                               = 10) separated by commas; or '*' to indicate
                               all servers; or 'A' to indicate those servers
                               to which the workstation is currently attached.
                /u=username    Displays all users with the name specified.
                               The username may be preceded or followed by a *
                               e.g. /u=b* would display all users whose
                               username begins with b.
                /?             Displays help if it is the first option.

If a value contains a dash or slash, it must be enclosed in double quotes
e.g. users /u="smith-jones". To include a double quote in a value, use two
consecutively e.g. users /l=""the dungeon"" displays users logged on in "the
dungeon".

To show where users are logged in, USERS requires a database containing
station addresses and locations. This file must be named location.srt, must
contain one workstation address and location per line, and must be sorted
into ascending alphanumeric order by workstation address. The workstation
address may be either a 12 byte physical station address or the combined 8
byte network address and 12 byte physical station address separated by a
colon e.g. 00000001:0000C0123456. The network address must either be present
for all entries, or not used at all.

The location must be separated from the address by a single blank and may be
up to 30 characters long. By default, only the first 15 characters are
displayed, but the /o option forces USERS to suppress the login date and
time, and to display the full 30 character location.

An NLM (e.g. PSERVER) may have a connection number but no network address. In
this case USERS assumes a network and address of zero (i.e.
00000000:000000000000) and an entry may be included in location.srt for this.

Sorting can be done using the DOS SORT utility, and is required to maximise
the speed of operation of USERS. The file can be anywhere in the search path.
USERS has storage allocated for a maximum of 500 addresses/locations.

USERS will function without location.srt. It then displays the station
address rather than the location. It does the same if a particular station
does not have an entry in the file.

An example file without the network address is:

0000394D0B00 B422 J Lay
0000C0008416 F052 R Smyth
0000C0022418 F206 10
0000C0028218 C103  1
0000C004341A F036 Planning
0000C004F212 F704 P & R
0000C005F512 H207 K Thompson
0000C006341C H112 Charon
0000C0064D19 H203 L Wiltshire
0000C006AE14 H228 24
0000C0070415 H113 Philippa

If the user does not have an existing connection to a server on which a
userlist is requested, USERS will attempt to attach as GUEST without a
password. If this fails, the user is prompted for a username and password.
This username/password combination is retained, and used, if required, on
subsequent servers. If both GUEST/no password, and username/password fail on
a subsequent server, the user is prompted for another username/password
combination to replace the previous one.

An example of output from USERS with no options selected is:

User Information for Server KEA at 13:41

  1 GUEST      Guest                          S5   20         19-07-1991 12:56
  4 KING       King, J M                      F606 J King     19-07-1991 09:31
  9 LASERUSER  <No name specified>            F312 LSCP       19-07-1991 11:21
 11 BUP        New Backup                     C105 Operators  19-07-1991 09:07
 15 GUEST      Guest                          E156            19-07-1991 13:41
 16 MIRANDA    Sikking, M J                   F704 P & R      19-07-1991 11:50
 18 GUEST      Guest                          S5   24         19-07-1991 12:42
 21 GUEST      Guest                          S4   16         19-07-1991 13:38
 22 F704SERVER Print server in F704           F704 P'server   19-07-1991 09:21
 25 CHAPMAP    Chapman Paul Donald            E064  4         19-07-1991 13:40
 26 CHARON     Charon mail gateway            H114A Tutors    19-07-1991 12:45
 28 GUEST      Guest                          H112 John       19-07-1991 13:41
 30 PERKINS    Perkins, H C                   F706 H Perkins  19-07-1991 12:50
 31 MANSELL    Mansell, R E                   F609 R Mansell  19-07-1991 08:34
 32 LPRSERVER  LPR Novell <-> VMS             H112 Charon 2   19-07-1991 12:55
 35 CARSONGW   Carson, Gregory William        E064  8         19-07-1991 13:41
 37 MCGREGOR   McGregor, H O                  F708 H McGregor 19-07-1991 12:28
 40 GUEST      Guest                          S5    8         19-07-1991 13:28
 41 MLCOCH     Mlcoch, L                      E064  6         19-07-1991 08:50
 43 PHETCHC    Chutinto Phetchai              E170            19-07-1991 13:40

Number of users = 20

Sample CRDLST.SRT:
00000000:000000000000 Server                           PRINTQ_0
00000001:00608C5B0484 @User 3's desk                   Q_2
00000001:0080C7025A04 @Xircom #1 (User 4)              NONE
00000001:0080C76BEA01 @Xircom #2 (User 2)              NONE
00000001:02608C0CEAE5 @User 1's desk                   Q_3
00000001:02608C0D06B4 @User 5's desk                   PRINTQ_0
00000001:02608C0E3997 @User 2's desk                   Q_2
00000001:02608C0E3998 @User 4's desk                   Q_1
00000001:080009173831 NET HP LaserJet (Q_1)            Q_1
00000001:08000917DC6C NET HP LaserJet (Q_2)            Q_2
00000001:08000917EC96 NET HP Laserjet (Q_3)            Q_3
00000001:08001A04C428 @Server 2 user                   NONE
00000001:08001A04C42A @Server 2 user                   NONE
[ RETURN TO DIRECTORY ]