1 FINGER
! This file was adapted by R. Garland, Columbia Chem Dept., from the TOPS-20
! file on the Columbia computer Center's DECsystem-20's, written by Frank
! da Cruz.
!
! -- Commented stuff might get implemented some day. -- Rg
!
Finger is a SHOW SYSTEM-like program (tells you who's logged in, etc.) 
that performs the following functions:

o "Show System"-like output, showing personal name, location, program
   etc., of all users currently logged in.  

o Detailed information about a specified user including the contents
  of the user's FINGER.PLN file (if the user has one) and the status
  of the user's mailbox.  In addition, if the user is logged in, the 
  user's job(s) is(are) displayed.
!
! o  Finger will look up the user ID of a person whose name you know.
!   There are variations on this: e.g. you can find the user ID's of
!   all users with first name Fred (/personal-name:"*,Fred").
!

FORMAT:
    Locally:

      F[inger] [user] [Qualifier [Qualifier...]]

      or over the network:

      F[inger] [user] [@host[@host...]] [switch [switch...]]

2 User
Asking for a specific user gives you a list of all the active jobs 
for that user, as well as plan and mail information if available.

A "user" can be specified in one of several ways:

o   A local  VAX/VMS  user  name , possibly with wildcards (*).
    Examples: "FL$SMITH", "BE*", etc.  Trailing "*" is the only
    allowed wildcard.

o   An ID on a foreign network host, e.g. 
    CS2.FOO@CU20C   or   FD0J@TOPSA@CU20B

See also "HELP Finger Plan" and "HELP Finger Mail"
2 Network
Finger can retrieve information from a remote host on the network
if that host supports finger.

The host is specified by one or more network host names, preceded 
by atsigns, e.g. @CU20A

Several  host  names  may be strung together to effect routing to 
other networks, e.g.:

     @SU-AI@CMUC  	(Routing is done right to left)

If you  give a host  name with no  user, you will get a listing of all 
the non-operator jobs at the specified site (providing it is connected
and  is able to  provide  Finger  service).  You may  include trailing
options for the foreign host;  these are not parsed locally,  they are
simply sent to the designated host, which  may or may not know what to
do with them.  E.g. 

	FINGER foo@unixa -a -b -c

In all cases, the  rightmost host name and its atsign are removed from
your command and the rest of it is sent to that  host as you typed it.
Intermediate  hosts do the same thing,  until the  command has no host
names left,  at which  point the host at which it has arrived executes
the remainder of the command.

2 Plan
If you  "Finger" an  individual  user,  personal information about that
user  will  be  listed if  it is  available.  A  user should  put  this
information  in a  file named  "FINGER.PLN" in his/her login directory. 
Information  such  as  phone  number,  office  hours,  etc.  may  be
appropriate. 
2 Mail
If you  "Finger" an  individual  user,  information  about that user's
mailbox  will  be  listed.   This  consists of the  number of new mail
messages  received since last read by the user, and whom they are from.
This is  useful to see if a  person has read your mail yet etc.  If you
do not  wish the  information about who has sent you mail to be listed,
protect your mail file with the following command: 

	$ SET PROTECTION=(S) MAIL.MAI

and remember to  always keep at least 1 old message in the file (if you
delete them all, MAIL will create a new file with different protection). 
2 /HELP
Print this message.
2 /BATCH
List the batch Processes on the system.
2 /ALL
List all jobs, including system processes.
