 FORMAT:
     Locally:
 
       FINGER [user] [Qualifiers]
 
     over the network:
 
       FINGER [user] @host[@host...] [Qualifiers]
 
 Finger is a SHOW USERS-like program (tells you who's logged in, etc.)
 that performs the following functions:
 
 o SHOW USERS-like output, showing username,  location, program name,
   etc., of all users currently logged in.
 
 o Detailed information about a specified user including the contents
   of the user's  "PLAN" 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 username of a person  whose name you know.
   There are variations on this:   e.g. you can find the usernames of
   all users with the first name of Fred. The rule Finger follows for
   the command "$ FINGER user" is:
 
 	1) Check if "user" is a valid Username (login ID). If it is,
 	   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".
/ALL
  /ALL
 
  List all jobs, including system jobs.
 
  Note: /ALL selects all jobs for display,  whereas /FULL specifies that
  all information for the selected jobs be displayed.
/AREA
  /AREA (D)
  /NOAREA

  Display the default file area for the job.
/BATCH
  /BATCH (D)
  /NOBATCH
 
  List the batch jobs on the system.
/BYPASS
  /BYPASS (D)
  /NOBYPASS
 
  Determines whether (NOBYPASS) or not (BYPASS) control  characters such
  as escape sequences are filtered before output is displayed.
/CPUTIME
  /CPUTIME (D)
  /NOCPUTIME
 
  Display the  amount of  CPU time used.  Format is mm:ss  (or mmmmm for
  times over 99.9 minutes.)
/FULL 
  /FULL
 
  Displays all  information  for the  selected jobs.  This display  will
  overflow the screen width on most terminals.
 
  Note: /ALL selects all jobs for display,  whereas /FULL specifies that
  all information for the selected jobs be displayed.
/HELP 
  /HELP
 
  Print this message.
/IMAGENAME
  /IMAGENAME (D)
  /NOIMAGENAME
 
  Display the user's image (program) name.  A $ means the user is at the
  DCL level.
/INTERACTIVE
  /INTERACTIVE (D)
  /NOINTERACTIVE
 
  List interactive jobs.
/JOB
  /JOB (D)
  /NOJOB
 
  Display the user's job number. 
/LOCATION
  /LOCATION (D)
  /NOLOCATION
 
  Display the location of the user's terminal for interactive jobs.
/LOGINTIME
  /LOGINTIME (D)
  /NOLOGINTIME
 
  Display the time the user logged in.  Format is hh:mm.
/MAIL
  /MAIL (D)
  /NOMAIL

  Display the new mail count and unread message information.
/MESSAGE
  /MESSAGE (D)
  /NOMESSAGE
 
  Display the system message of the day with the output.
/NETWORK
  /NETWORK (D)
  /NONETWORK
 
  List network (DECnet) jobs.
/PERSONALNAME
  /PERSONALNAME
  /NOPERSONALNAME (D)
 
  Display the user's personal name,  as recorded in the system authoriz-
  ation file (SYSUAF).
/PLAN
  /PLAN (D)
  /NOPLAN

  Display the user's plan file.
/PPN
  /PPN (D)
  /NOPPN

  Display the job's Project-Programmer Number.
/PRIORITY
  /PRIORITY
  /NOPRIORITY (D)

  Display the job's priority and run-burst values.
/RUNTIMESYSTEM
  /RUNTIMESYSTEM
  /NORUNTIMESYSTEM (D)

  Display the job's current run-time system.
/SIZE
  /SIZE
  /NOSIZE (D)
  
  Display the  amount of memory  in K-words used by the job,  as well as
  the maximum memory available to the job.
/STATE
  /STATE
  /NOSTATE (D)
  
  Display the job state.
/SYSTEM
  /SYSTEM (D)
  /NOSYSTEM
 
  List system jobs (jobs running under PPN [1,2]).
/TERMINAL
  /TERMINAL (D)
  /NOTERMINAL
 
  Display the terminal line number.
/TTTYPE
  /TTTYPE (D)
  /NOTTTYPE
 
  Display the type of terminal for interactive users.
/USERNAME
  /USERNAME (D)
  /NOUSERNAME
 
  Display the user's username (login ID).
/VERSION
  /VERSION
  /NOVERSION (D)

  Display the version information for the Finger program.
*User
      
 Asking for a specific user will give 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 RSTS/E username,  possibly with wildcards.  For example,
     "FL$SMITH", "BEN*", etc.  Standard wild-card conventions are ob-
     served i.e. "*" matches any string, "%" or "?" matches any char-
     acter.
 
 o   A local personal name or part thereof.  All matches will be out-
     put.
 
 o   A "." (period) to finger yourself.  (e.g. to check your mail.)
 
 o   An ID on a foreign network host, e.g. SYSTEM@JCSVAX1 or .@SPC11B
     Note in the  second example above that .@host will return infor-
     mation  about a user on a remote  host with the same username as
     yourself, handy for checking your mail on the other system.
 
 See also "HELP Finger Plan" and "HELP Finger Mail"
*Network
 
 Finger can retrieve information  from a remote host  on the network if
 that host supports Finger commands.
 
 The host is specified by a hostname, preceded by an atsign, e.g. @XYZ.
   
 An alternate form for specifying a nodename is with a double colon ::.
 The following two commands are equivalent:
 
 	FINGER @FOO
 	FINGER FOO::
 
 In parsing the command, Finger searches for "@" first and if it cannot
 find this it searches for "::".
 
 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 username 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.  For example:
 
 	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.
*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.
*Mail
 
 If you Finger an individual user,  information about that  user's mail
 messages will be listed.  This consists of the number of new mail mes-
 messages received  since last read by the user,  and (if any are  from
 you) the date, time and subject is displayed. This is useful to see if
 a person has read your mail yet etc.
*Area
 
 If you Finger an individual user,  that user's default directory spec-
 ifcation will be displayed.
*Nodes
 
 The following nodes  accessible from the SPC Academic  Computer Center
 are in the Finger database as of March 1989.  These are those believed
 to support Finger.  If you Finger other nodes,  it will try anyway for
 DECnet nodes, but will not try for BITnet nodes.
 
 DECnet nodes -
 
 SPC11A  -  SPC Academic Computer Center PDP-11/84  (research)
 SPC11B  -  SPC Academic Computer Center PDP-11/44  (CS computing)
 SPC11C  -  SPC Academic Computer Center PDP-11/44  (Non-CS  "   )
 SPC11D  -  SPC Academic Computer Center PDP-11/70  (CS Unix)
 SPC11E  -  SPC Academic Computer Center PDP-11/70  (CS Unix tech)
 SPC11Y  -  SPC Academic Computer Center PDP-11/23+ (Micro router)
 SPC11Z  -  SPC Academic Computer Center PDP-11/83  (RSTS SIG)
 SPCVXA  -  SPC Academic Computer Center VAX-11/785 (VAX users)
 
 BITnet nodes -
 
 JCSVAX1 -  Jersey City State College VAX 8600      (admin cluster)
