 FINGER
 
 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".
 
 
 
 FINGER
      
      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"
      
      
 
 FINGER
      
      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.
      
      
 
 FINGER
      
      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.
      
      
 
 FINGER
      
      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.
      
      
 
 FINGER
      
      Area
      
      If you Finger an individual user,  that user's default directory spec-
      ifcation will be displayed.
      
      
 
 FINGER
      
      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)
      
      
 
 FINGER
      
      Qualifiers
      
      
      /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
      
      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
      that all information for the selected jobs be displayed.
      
      /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.
