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
! Updated with new qualifiers and nodes		1-Dec-1983	Rg
! Updated for V40.1.00 (VMS V4.0)		28-Mar-1985	Rg
! Updated for V41.1.10 (VMS V4.1)		22-May-1985	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.
!! NOTE above restriction applies if source is so changed
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.  Standard VMS wildcard conventions
    are observed, i.e. "*" matches any string, "%" matches any character.

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 a host name, preceded by an atsign, e.g. 
@CU20A.  Standard VMS wildcards can be used on the the hostname  
in which case the command will be sent to all hosts in the database
conforming to the pattern.  Thus:

	FINGER	@CU*

Will do a Finger to all hosts with names beginning with "CU".

( an alternate form for specifying a node is with the double colon.
Thus the 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  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.  

!! NOTE put your own list of nodes below
!2 Nodes
!The following nodes accessible from the Columbia Chemistry department
!are in the finger database as of Aug-1984.  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 -
!
!CUCHMB	-	Columbia Chemistry Vax 11/730
!CU20A	-	Columbia Computer Center DECsystem-20
!CU20B	-	Columbia Computer Center DECsystem-20
!CU20C	-	Columbia Computer Center DECsystem-20
!CU20D	-	Columbia Computer Center DECsystem-20
!CUCS20	-	Columbia Computer Science DECsystem-20
!CUTC20	-	Columbia Teachers College DECsystem-20
!CMCCTA	-	C.M.U. Computer Center DECsystem-20
!CMCCTB	-	C.M.U. Computer Center DECsystem-20
!CMCCTC	-	C.M.U. Computer Center DECsystem-20
!CMCCTD	-	C.M.U. Computer Center DECsystem-20
!CMCCTE	-	C.M.U. Computer Center DECsystem-20
!CMCCTF	-	C.M.U. Computer Center DECsystem-20
!CMCSC	-	C.M.U. Computer Science DECsystem-20
!CMPSYA	-	C.M.U. Psychology VAX
!CMPSYB	-	C.M.U. Psychology VAX
!CMPSYC	-	C.M.U. Psychology VAX
!CMPSYD	-	C.M.U. Psychology VAX
!CMSTAT	-	C.M.U. Statistics VAX
!CMCFRA	-	C.M.U. Biology VAX
!CWRU20	-	Case Western DECsystem-20
!CWR20B	-	Case Western DECsystem-20
!CWR20C	-	Case Western DECsystem-20
!
!BITnet nodes (as of June 15 1984) -
!
!CUNYVMS1  CUNY - Graduate Center              VMS/jnet     VAX 11/780
!YALECS    Yale Univ. Computer Science Dept.   UNIX/UREP    VAX 11/750
!YALEVAX5  Yale Univ. Computer Science Dept.   VMS/jnet     VAX 11/750
!PSUVAX1   Penn State University               UNIX/UREP    VAX 11/780
!PSUPDP1   Penn State University               UNIX-R6      PDP 11/34
!PSUVMS1   Penn State University EE Dept.      VMS/jnet     VAX 11/780
!BROWNCS   Brown University Computer Science   UNIX/UREP    VAX 11/780
!CRNLCS    Cornell Computer Science Dept.      UNIX/UREP    VAX 11/780
!CRNLNS    Cornell Lab. of Nuclear Studies     jnet         VAX 11/780
!CUCCVX    Columbia Univ. Administrative Sys.  VMS/jnet     VAX 11/750
!CUCHEM    Columbia University Chemistry Dept. VMS/jnet     VAX 11/780
!CUCHMB    Columbia University Chemistry Dept. VMS/jnet     VAX 11/730
!ROCKVAX   Rockefeller University              UNIX/UREP    VAX 11/780
!UCBUNIXA  University California at Berkeley  >2.8 BSD      PDP 11/70
!UCBUNIXB  University California at Berkeley  >2.8 BSD      PDP 11/70
!UCBUNIXC  University California at Berkeley  >2.8 BSD      PDP 11/70
!UCBUNIXD  University California at Berkeley  >2.8 BSD      PDP 11/70
!UCBUNIXE  University California at Berkeley  >2.8 BSD      PDP 11/70
!UCBUNIXG  University California at Berkeley  >4.0 BSD      VAX 11/780
!UCBJADE   University California at Berkeley  >4.1aBSD      VAX 11/750
!UCSFVAXA  Univ. California at San Francisco  >4.1BSD       VAX 11/750
!HARVUNXW  Harvard Dept for Psy & Soc. Relatns UNIX/UREP    PDP 11/44
!HARVUNXU  Harvard University Science Center  >UNIX 2.9 BSD VAX 11/780
!HARVUNXA  Harvard University Science Center  >UNIX 2.9 BSD PDP 11/70
!HARVUNXB  Harvard University Science Center  >UNIX 2.9 BSD PDP 11/70
!MECAN1    MAINE Computer Applications Network VMS/jnet     VAX 11/780
!UCONNCS1  University of Connecticut           UNIX 4.2     VAX 11/780
!UIUCUXC   U. of Illinois at Urbana-Champaign >UNIX 4.1aBSD VAX 11/780
!SLACCB    SLAC's Crystal Ball experiment      VMS/jnet     VAX 11/780
!SLACMAC   SLAC's Magnetic Calorimeter exper.  VMS/jnet     VAX 11/780
!SLACMK3   SLAC's Mark III detector experiment VMS/jnet     VAX 11/780
!SLACSLC   SLAC's Linear Collider Project      VMS/jnet     VAX 11/780
!SLACMKII  SLAC's Mark II detector experiment  VMS/jnet     VAX 11/780
!SLACASP   SLAC's Anomalous Single Photon exp. VMS/jnet     VAX 11/750
!SLACTWGM  SLAC's Two-Gamma experiment         VMS/jnet     VAX 11/780
!SLACTBF   SLAC's Test Beam Facility           VMS/jnet     VAX 11/780
!VPIVAX3   Virginia Polytechnic Institute      VMS/jnet     VAX 11/780
!VPIVAX5   Virginia Polytechnic Institute      VMS/jnet     VAX 11/780
!ANLCHM    Argonne National Laboratory         VMS,ANL NJE  VAX 11/780
!ANLCMT    Argonne National Laboratory         VMS,ANL NJE  VAX 11/780
!ANLHEP    Argonne National Laboratory         VMS,ANL NJE  VAX 11/780
!ANLIPNS   Argonne National Laboratory         VMS,ANL NJE  VAX 11/780
!ANLPHY    Argonne National Laboratory         VMS,ANL NJE  VAX 11/780
!SUHEP     Syracuse Univ. High Energy Physics  VMS/jnet     VAX 11/780
!FNALVX13  Fermi National Accelerator Lab.     VMS/jnet     VAX
!OACVAX    Univ. of California at Los Angeles  UNIX         VAX 11/750
!TAMVXRSC  Texas A&M Remote Sensing Center     VMS/jnet     VAX
!TAMVXEE   Texas A&M Electrical Engineering    VMS/jnet     VAX
!TAMVXME   Texas A&M Mechanical Engineering    VMS/jnet     VAX
!TAMVXPHY  Texas A&M Physics Department        VMS/jnet     VAX
!TAMVXCGF  Col. of Eng. Central Graphics Facil.VMS/jnet     VAX
!EDUCOM    Interuniversity Communications Coun.VMS/jnet     VAX 11/750
!VANDVMS1  Vanderbilt University               VMS/jnet     VAX 11/780
!TAURUS    Tel Aviv University                 UNIX/UREP    VAX 11/780
!WISDOM    Weizmann Dept of Mathematics        UNIX/UREP    VAX 11/750
!TECHUNIX  Technion Dept of Mathematics        UNIX/UREP    VAX 11/780
!NEUVMS    Northeastern University             VMS/jnet     VAX 11/750
!WISCPSLA  University of Wisconsin             VMS/jnet     VAX 11/780
!WISCPSLB  University of Wisconsin             VMS/jnet     VAX 11/780
!
!Special pseudonyms -
!
!A		-	CU20A
!B		-	CU20B
!C		-	CU20C
!D		-	CU20D
!CS		-	CSCS20
!TC		-	CUTC20
!PSY-A	-	CMPSYA
!
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
 /NOCPUTIME (D)

Display the amount of CPU time used.  Format is mmm:ss  (or mmmmmm for
times over 999 minutes.)


/IDLETIME  
 /IDLETIME (D)  
 /NOIDLETIME

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.

/SIZE
 /SIZE
 /NOSIZE (D)
     
Display the process working set size in pages.
Includes both process and global pages.
     
/STATE
 /STATE
 /NOSTATE (D)
     
Display the process scheduling state.
Possible states are:
     
        Cur     Currently Executing Process
        Com[O]  Computable
        LEF[O]  Local Event Flag Wait
        CEF     Common Event Flag Wait
        MWait   Miscellaneous Wait, Mutex Wait, or Resource Wait
        PFW     Page Fault Wait
        Hib[O]  Hibernate Wait
        Susp[O] Suspend Wait
        ColPg   Collided Page Wait
        FPg     Free Page Wait
     
O suffix indicates outswapped.
     
/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.
/Swapped
 /Swapped
 /NOSwapped(D)

Displays Image name, Login time, and CPU time for out-swapped processes.
Normally these are not displayed since to do so would require in-swapping
the process.

/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.
