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.
!
! Updated for Finger V5.20	6-Oct-1983		Rg
!
FORMAT:
    Locally:

      FINGER [user] [Qualifiers]

     over the network:

      FINGER [user] [@host[@host...]] [Qualifiers]

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.  The rule finger follows for the
  command "$ FINGER user" is:

	1) See if "user" is a valid Username (login ID).  If
	   so: use it.

	2) Match "user" against the list of personal names kept by
	   the system.  Output all matches.  This match can be to
	   any part of the name.  Thus "Rich" will match both
	   "Richard" and "Heinrich".
!  The "user" string must be at
!	   least 3 characters long to be considered for this type of
!	   match.
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   A local personal name or part thereof.  All matches for all
    matching users will be output.

o   A "." (period) to finger yourself.  (e.g. to check you mail box.)

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

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@CUCS20  	(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.  

2 Qualifiers

/HELP

Print this message.

/INTERACTIVE
 /INTERACTIVE (D)
 /NOINTERACTIVE

List interactive processes.

/BATCH
 /BATCH
 /NOBATCH (D)

List the batch Processes on the system.

/SUBPROCESS
 /SUBPROCESS
 /NOSUBPROCESS (D)

List subprocesses.

/NETWORK
 /NETWORK
 /NONETWORK (D)

List network (DECnet) jobs.

/SYSTEM
 /SYSTEM
 /NOSYSTEM (D)

List system processes.

/ALL

List all processes, including system processes.

Note: /ALL selects all processes for display, whereas /FULL specifies
that all information for the selected processes be displayed.

/MESSAGE
 /MESSAGE (D)  
 /NOMESSAGE

Display the system message of the day with the output.

/PROCESSNAME
 /PROCESSNAME (D)  
 /NOPROCESSNAME

Display the user's process name.  Note: process name will be the same 
as the Username (login ID) except for batch jobs and when the user is
logged in on more than one terminal.

/PID
 /PID
 /NOPID (D)

Display the user's process ID (PID).

/USERNAME  
 /USERNAME  
 /NOUSERNAME (D)

Display the user's username (login ID).  Note: process name will be the
same as the Username (login ID) except for batch jobs and when the user
is logged in on more than one terminal.

/PERSONALNAME
 /PERSONALNAME (D)  
 /NOPERSONALNAME

Display the user's personal name.

/IMAGENAME
 /IMAGENAME (D)  
 /NOIMAGENAME

Display the user's image (program) name.  A "$" means the user is at the
DCL level.

/TERMINAL  
 /TERMINAL  
 /NOTERMINAL (D)

Display the terminal line number.

/LOGINTIME
 /LOGINTIME (D)  
 /NOLOGINTIME

Display the time the user logged in.  Format is hh:mm.

/CPUTIME
 /CPUTIME (D)  
 /NOCPUTIME

Display the amount of CPU time used.  Format is mmm:ss.

/IDLETIME  
 /IDLETIME  
 /NOIDLETIME (D)

Display the time since the last terminal activity if the system is waiting
for terminal input from the user.  Format is hh:mm.  A single "." in the
display means the terminal has been idle for more than 1 second but less
than 1 minute.

/LOCATION
 /LOCATION (D)  
 /NOLOCATION

Display the location of the user's terminal for interactive jobs.

/TTType  
 /TTType  
 /NOTTType (D)

Display the type of terminal for interactive users.

/FULL

Displays all information for the selected processes.  This display 
will overflow the screen width on most terminals.

Note: /ALL selects all processes for display whereas /FULL specifies
that all information for the selected processes be displayed.
