+-+-+-+ Beginning of part 6 +-+-+-+ Xo Edit the file FINGER$:FINGER.CNF to tailor the configuration for your X site. This is where you select the header lines, etc. A configuration X entry consists of a keyword letter, followed by a space, followed by a X value for the keyword. A brief discussion of each item follows: X X H - The local host name, including any other information which is ap- X propriate. Traditionally, this is the DECnet node name and CPU model. X X Example: H SPC11B PDP-11/44 X X O - The organization name. X X Example: O St. Peter's College - Academic Computer Center X X R - The DECnet node name of a system which will perform routing to X systems you are not directly connected to. If no router is available, X this keyword should be omitted. Be aware of subtle loops, such as a X pair of RSTS/E machines each listing the other as router. A Finger X router is NOT required to find nodes on your DECnet. It is only re- X quired for: X X 1) Routing to Bitnet or Internet hosts X 2) Routing to terminal servers X 3) Routing to wildcarded host names X X Example: R SPCVXA X X M - Either a one-line "Message of the day" OR a file specification for X such a file. File specifications MUST begin with the symbol '@'. X X Example: M @FINGER$:FINGER.MSG X X W - The minimum number of characters permitted in a wildcard username X lookup. If W is 0, anyone can get a list of all your users with the X command 'FINGER *'. If it is set to 3, for example, at least three of X the characters in the username must be non-wild. X X Example: W 0 X X 2 X`012 X N - Determines whether the originating DECnet node name is significant X when checking for unread mail. If your DECnet is set up such that user X names are the same across your network (for example, FRED@NODEA is the X same person as FRED@NODEB), set this flag to 0. If you are part of a X large DECnet, set this flag to 1.`032 X X Example: N 0 X X L - Sets the privacy level of Finger. If this flag is 0, Finger will X tell you the number of unread mail messages a user has, as well as X displaying the date, time and subject of any unread mail from you. If X the flag is 1, only the unread mail count is displayed. If the flag is X 2, no mail information is displayed. X X Example: L 0 X X 1 - Value for command defaults, part 1. This keyword is the sum of the X following values: X X /interactive 1 X /batch 2 X /network 4 X /system 8 X /version 32 X /message 128 X X Example: 1 143 X X 2 - Value for command defaults, part 2. This keyword is the sum of the X following values: X X /job 1 X /username 2 X /ppn 4 X /personalname 8 X /imagename 16 X /terminal 32 X /logintime 64 X /cputime 128 X /state 256 X /size 512 X /location 1024 X /tttype 2048 X /priority 4096 X /runtimesystem 8192 X X Example: 2 3575 X X 3 - Value for command defaults, part 3. This keyword is the sum of the X following values: X X /bypass 1 X /plan 2 X /mail 4 X /area 8 X X Example: 3 15 X 3 X`012 X Q - Terminates the scan of the configuration file. X X Example: Q X Xo Edit the two help files FINGER$:FINGER.HLP and FINGER$:FINHLP.HLP to X reflect the new defaults if you've changed any of the values of flags X 1-3 in the configuration file. X Xo Ensure that the protection code of FINGER.TSK is <232>, as follows: X X $ PIP FINGER$:FINGER.TSK<232>/RE X Xo Edit the RSTS/E system-wide help file (HELP$:HELP.HLP) to include the X following lines (normally right after the *Files keyword): X X *Finger X @FINGER$:FINHLP.HLP X Xo Edit the system startup file [0,1]START.COM to assign the FINGER$ log- X ical and the FINGER command: X X ASSIGN/SYSTEM _SY:[somewhere] FINGER$: X DEFINE/COMMAND/SYSTEM FIN-GER FINGER$:FINGER.TSK/LINE=CCL/PRIV X X You may also want to issue the DEFINE/COMMAND now, so you won't have X to restart the system to use FINGER. If you would like a shorter ab- X breviation than FIN, I suggest you modify the system-wide LOGIN.COM X file ([0,1]LOGIN.COM) to include something similar to the following: X X $ F*INGER == "CCL FINGER" X Xo If DECnet/E is installed on your system, make the Finger object number X known to DECnet by executing the following command: X X $ @FINGER$:FINDEF.COM X X Finger is defined as object number 117, a convention that dates from X the beginning of time. If you wish to change this, you will also have X to edit the FINGER.B2S file in several places and re-compile it. This X is strongly discouraged, especially if you are on a network with other X computer types which run versions of Finger. X Xo If you are using a message-of-the-day file, edit it appropriately. X Xo Edit the terminal database file, FINGER$:FINGER.TRM, to include the X locations and types of all your terminals. This file has a strange X record format, so be careful to keep all lines at the proper length. X If a terminal type is not known, such as on a dialup, use the keyword X 'Unknown' and Finger will use the value RSTS/E determined from a SET X TERMINAL/INQUIRE command. Before starting this step, a SHOW DEVICES KB X command may be useful to determine the actual port numbers in use on X your system. X X X X X X 4 X`012 Xo If you do not have DECmail-11, you will have to create a list of your X users in a special format in the file MAIL$:NAMES.DAT. The actual lo- X cation of the MAIL$: logical is unimportant, but it will need to be X defined for the next step. The format of the user information is PPN, X personal name, username. For example: X X [1,2],System Manager,SYSTEM X Xo Run the FINMAI.TSK program to create the FINGER$:FINGER.DAT file from X the MAIL$:NAMES.DAT file. This step will need to be done each time you X add or remove users from your system. X `032 Xo Once Finger is working users can be notified to create a plan file for X themselves. (see HELP FINGER PLAN). X X XSAMPLE FINGER OUTPUTS: X X------ Normal FINGER command ------ X X$ finger XSt. Peter's College - Academic Computer Center XSPC11B PDP-11/44, RSTS V9.7-08, Saturday, 12-Aug-1989 04:10, 9 Jobs, 63 Max. XUptime 08:46:33, since Friday, 11-Aug-1989 19:24 X X08-Aug-89 - Finger T1.0-02 in test on SPC11B. This is a test message. X VJob Username PPN Progrm Term Login CPU ST Location TTType X `032 V 1 SYSTEM 1,2 ERRCPY Det 00:41 SR - Detached - `032 X `032 V 2 SYSTEM 1,2 NPKDVR Det 00:44 SL - Detached - `032 X `032 V 3 SYSTEM 1,2 PBS... Det 00:05 SL - Detached - `032 X `032 V 4 SYSTEM 1,2 EVTLOG Det 00:11 SL - Detached - `032 X `032 V 5 SYSTEM 1,2 MAILQ Det 00:16 SR - Detached - `032 X `032 V 6 SYSTEM 1,2 HBKILL Det 04:39 SL - Detached - `032 X `032 V 7 TERRY 1,254 FINGER KB42: 21:41 23:31 RN LT2006 PORT_1 VT102 X `032 V 8 SYSOPR 1,3 DIS132 Det 34:07 SL - Detached - `032 X `032 V 9 SYSBAT 1,5 ...RDR KB43: 04:02 03:49 RN - Batch queue - `032 X `032 X X------ FINGER an individual ------ X X$ finger terry XSPC11B RSTS/E, Saturday, 12-Aug-1989 04:10 X VJob Username PPN Progrm Term Login CPU ST Location TTType X `032 V 7 TERRY 1,254 FINGER KB42: 21:41 23:33 RN LT2006 PORT_1 VT102 X `032 X X Default directory: _SY0:[1,254] X Logged in since: Friday, 11-Aug-1989 21:41`032 X Mail: (no new mail) X Plan:`032 X X`009Operations Manager, Academic Computer Center X X`009Office Hours: Varied and unenviable. Late afternoons and X`009evenings, usually. Call first to make sure I'm in. X X 5 X`012 X------ FINGER a part of a name ------ X X$ fin tom XSPC11B RSTS/E, Saturday, 12-Aug-1989 04:18 X XMANSHEIM_T - Tom Mansheim XPROTOMASTR_G - Gerard Protomastro X X------ FINGER a remote DECnet node ------ X X$ finger @spcvxa X[SPCVXA.DECnet] X XSt. Peter's College - Academic Computer Center VSPCVXA VAX-11/785, VMS V5.1-1, Saturday, 12-Aug-1989 04:11, 2 Users, 0 Batc Xh. XUptime 0 01:04, since Saturday, 12-Aug-1989 03:06, Load: 0.13 0.15 0.22 X X05-Aug-89 - The VAX has been upgraded to a 785. Please report any problems X to TERRY via MAIL. X VPID Username Program Term Login CPU Location TT Typ Xe V0000011F SYSMON Monitor TXF7: 03:14 1:54 Machine room VT100 X `032 V00000120 BEN $ LTA1: 03:14 5:20 LT2006 PORT_3 VT102 X `032 V00000128 SYSTEM Mfs Sub 03:47 0:00 - Subprocess - `032 X `032 V00000129 SYSTEM Bn_Slave Sub 03:47 0:04 - Subprocess - `032 X `032 V0000012B SYSTEM Fno Sub 03:47 0:00 - Subprocess - `032 X `032 V0000012C SYSTEM Profsin Sub 03:47 0:00 - Subprocess - `032 X `032 X X------ FINGER a terminal server ------ X X$ finger @lt2006 X[LT2006 via routing host SPCVXA] X[SPCVXA.DECnet] X[LT2006.LAT] X`032 XPort 1: Terry Kennedy Service Mode Current Session: 1 X- Session 1: Connected Interactive SPC11B X- Session 2: Disconnected Interactive SPCVXA X`032 XPort 3: Swamp PC Service Mode Current Session: 1 X- Session 1: Connected Interactive SPCVXA X`032 X------ FINGER a remote Bitnet node ------ X X$ finger @psuecla X[PSUECLA via routing host SPCVXA] X[SPCVXA.DECnet] X[PSUECLA.BITNET] X XECLA VAX 11/785 VMS V4.7. Saturday, 12-Aug-1989 04:11, 1 User, 3 Batch. X Up since Wednesday, 19-Jul-1989 20:58, Load: 2.21 X`032 XUsername Personal name Program Idle Location `032 XKSP Kwang-Seo Park Cwfhtr Batch `032 XSYSTEM System Manager $ Batch `032 XBACKUP Disk J. Backup Vmount Console 6 EEW`032 XFinger Command complete X X 6 X`012 XKNOWN PROBLEMS: X Xo This is Version 1.1. There are no known problems (yet?). Feel free to X report new bugs or desired features to me for future work. X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X 7 X`012 $ GOSUB UNPACK_FILE $ FILE_IS = "FINGER11.HLP" $ CHECKSUM_IS = 523877862 $ COPY SYS$INPUT VMS_SHARE_DUMMY.DUMMY X FINGER X`032 X FORMAT: X Locally: X`032 X FINGER [user] [Qualifiers] X`032 X over the network: X`032 X FINGER [user] @host[@host...] [Qualifiers] X`032 X Finger is a SHOW USERS-like program (tells you who's logged in, etc.) X that performs the following functions: X`032 X o SHOW USERS-like output, showing username, location, program name, X etc., of all users currently logged in. X`032 X o Detailed information about a specified user including the contents X of the user's "PLAN" file (if the user has one), and the status X of the user's mailbox. In addition, if the user is logged in, the X user's job(s) is(are) displayed. X`032 X o Finger will look up the username of a person whose name you know. X There are variations on this: e.g. you can find the usernames of X all users with the first name of Fred. The rule Finger follows for X the command "$ FINGER user" is: X`032 X `0091) Check if "user" is a valid Username (login ID). If it is, X `009 use it. X`032 X `0092) Match "user" against the list of personal names kept by X `009 the system. Output all matches. This match can be to any X `009 part of the name. Thus "Rich" will match both "Richard" X `009 and "Heinrich". X`032 X`032 X`032 X FINGER X `032 X User X `032 X Asking for a specific user will give you a list of all the active jobs X for that user, as well as plan and mail information if available. X `032 X A "user" can be specified in one of several ways: X `032 X o A local RSTS/E username, possibly with wildcards. For example, X "FL$SMITH", "BEN*", etc. Standard wild-card conventions are ob- X served i.e. "*" matches any string, "%" or "?" matches any char- X acter. X `032 X o A local personal name or part thereof. All matches will be out- X put. X `032 X o A "." (period) to finger yourself. (e.g. to check your mail.) X `032 X o An ID on a foreign network host, e.g. SYSTEM@JCSVAX1 or .@SPC11B X Note in the second example above that .@host will return infor- X mation about a user on a remote host with the same username as X yourself, handy for checking your mail on the other system. X `032 X See also "HELP Finger Plan" and "HELP Finger Mail" X `032 X `032 X`032 X FINGER X `032 X Network X `032 X Finger can retrieve information from a remote host on the network if X that host supports Finger commands. X `032 X The host is specified by a hostname, preceded by an atsign, e.g. @XYZ. X `032 X An alternate form for specifying a nodename is with a double colon ::. X The following two commands are equivalent: X `032 X `009FINGER @FOO X `009FINGER FOO:: X `032 X In parsing the command, Finger searches for "@" first and if it cannot X find this it searches for "::". X `032 X Several host names may be strung together to effect routing to other X networks, e.g.: X `032 X `009@SU-AI@CUCS20 (Routing is done right to left) X `032 X If you give a host name with no username you will get a listing of all X the non-operator jobs at the specified site (providing it is connected X and is able to provide Finger service). You may include trailing X options for the foreign host; these are not parsed locally. They are X simply sent to the designated host, which may or may not know what to X do with them. For example: X `032 X `009FINGER foo@unixa -a -b -c X `032 X In all cases, the rightmost host name and its atsign are removed from X your command and the rest of it is sent to that host as you typed it. -+-+-+-+-+ End of part 6 +-+-+-+-+-