+-+-+-+ Beginning of part 3 +-+-+-+ X$ Write`009`009Sys$Output`009" " X$ Set Verify X$ Purge/Log`009Sys$Help:FingMaint.Hlb X$ Purge/Log`009'F$Log("Finger$Directory")'Finger.exe X$ Purge/Log`009'F$Log("Finger$Directory")'FingerShr.exe X$ Purge/Log`009'F$Log("Finger$Directory")'FingMaint.exe X$ Purge/Log`009'F$Log("Finger$Directory")'Idle-Mon.exe X$ Purge/Log`009'F$Log("Finger$Directory")'FingerLAT.com X$ Purge2:`009! 'F$Verify(0)' X$ If`009.not. NetFinger`009`009Then GoTo Purge3 X$ Set Verify X$ Purge/Log`009Sys$Common:[Sysexe]Finger.Com X$ Purge3:`009! 'F$Verify(0)' X$ NoPurge:`009! 'F$Verify(0)' X$ Type`009`009Sys$Input X X`009The program will now be installed with the privileges needed. X X$ Set Verify X$ Set Prot=(W:rwe)`009'F$Log("Finger$Directory")'FingerShr.Exe X$ Run Sys$System:Install VFinger$Directory:Finger /Open /Shared /Header /Priv=(SYSPRV,WORLD,CMKRNL,OPER X) XFinger$Directory:FingerShr /Open /Shared /Header /Write /Priv=(SYSPRV,SYSGBL) X$! Set Prot=(W:re)`009'F$Log("Finger$Directory")'FingerShr.Exe X$ If Options`009Then Goto L9`009! 'F$Verify(0) X$ Type`009`009Sys$Input X X`009The installation procedure is now complete. However you must X`009do several things more: X X`0091) You must call the Finger start-up code, START_FINGER.COM, X`009 from the system startup file, SYS$MANAGER:SYSTARTUP.COM, X`009 so that the program will work after rebooting. START_FINGER.COM`032 X`009 must be edited for your site. X X`009 You must also run the Idle-Mon program during the start up X`009 procedure if you wish to have idle times for RTA and LTA terminals. X`009 The Idle-Mon program needs to be run after DECNet has been started X`009 but before LAT is started. The program can be activated by`032 X`009 the command: X V$ WRITE SYS$OUTPUT " $ RUN ''F$LOG("Finger$Directory")'Idle X-Mon" X$ Type`009`009Sys$Input X X`0092) Finger must be defined as a foreign command for users. The X`009 following line should be put into your system wide login command X`009 file: X X$ L9: X$ Set Verify X$ F*INGER`009:==`009$'F$Log("Finger$Directory")'Finger X$! 'F$Verify(0) X$ If Options`009Then Goto L10 X$ Type`009Sys$Input`032 X X`0093) If you want a file containing a system message ("message of the X`009 day") displayed as part of the FINGER output, create the file X`009 and assign it the logical name "Finger$Message". This can be X`009 done via a /SYSTEM logical name at BOOT time. X X`0094) If you use jnet, and want to build the Finger daemon, you should X`009 review the documentation (FINGER.DOC) and run the procedure X`009 INSTALL_JNET_FINGER.COM and also put a call to the startup code X`009 START_JNET_FINGER.COM into your jnet startup procedure. X X`0095) You must use the FINGMAINT program which was copied to the des- X`009 ignated directory, to define the database for personal names,`032 X`009 terminal locations and network hosts. There is a sample file, X`009 START_FINGER.COM, which you can use as a model for this. The X`009 definitions should be edited into START_FINGER if you desire to X`009 reconstruct the database after each system Boot.`032 X X`009Finger will now be run as a test. If the results do not correspond X`009to the sample output in the installation document, please review X`009the procedure and start over. X$ L10: X$ If .not. Options`009Then Goto Clr$1 X$ Write`009`009Sys$Output`009" " X$ Inquire`009Ans`009" Clear FINGERSHR database? (YES) " X$ If Ans.eqs.""`009Then Goto Clr$1 X$ If .not. Ans`009`009Then Goto Clr$2 X$ Clr$1: X$ Run`009'F$Log("Finger$Directory")'FingMaint XClear`009/All XExit X$ Clr$2: X$ Write`009`009Sys$Output`009" " X$ Set Verify X$ FINGER X$ Exit:`009`009! 'F$Verify(0) X$ Exit`009`009! 'F$Verify(Save_Verify) $ GOSUB UNPACK_FILE $ FILE_IS = "DUMJ.FOR" $ CHECKSUM_IS = 1917677429 $ COPY SYS$INPUT VMS_SHARE_DUMMY.DUMMY XC..`009`009`009`009`009Dummy jnet interface XC..`009`009`009`009`009R. Garland / CUCHEM / 29-Nov-1983 X Xc`009This module contains dummy entries for jnet routines. Xc`009Actual jnet support (using IBM RSCS protocols) is`032 Xc`009available from Joiner Associates using licensed software. X Xc`009updated for JANLIB Xc`009R. Garland`00912-Sep-1985 X X`009Integer Function ROU_NoNode X`009ROU_NoNode = 1 X`009Return X`009End Xc X X`009Integer`009Function`009Jan_Hook_Init X`009External `009FING_jNA X`009Jan_Hook_Init = %Loc(Fing_jNA) X`009Return X`009End X X`009Integer`009Function`009Jan_Receive_Msg X`009External `009FING_jNA X`009Jan_Receive_Msg = %Loc(Fing_jNA) X`009Return X`009End X X`009Integer`009Function`009Jan_Remove_Hook X`009External `009FING_jNA X`009Jan_Remove_Hook = %Loc(Fing_jNA) X`009Return X`009End X X`009Integer`009Function`009Jan_Send_Msg X`009External `009FING_jNA X`009Jan_Send_Msg = %Loc(Fing_jNA) X`009Return X`009End $ GOSUB UNPACK_FILE $ FILE_IS = "FINGER.$PACKAGE" $ CHECKSUM_IS = 203447867 $ COPY SYS$INPUT VMS_SHARE_DUMMY.DUMMY X* FINGER V51.1.24 as maintained by Terry Kennedy at St. Peter's College X* You can either request FINGER.PACKAGE to get the whole collection in X* a package, or you can request individual components. X* X* Info-Finger is a mailing list for discussing Finger. Here is the des- X* cription: X* X* I-Finger%SPCVXA.BITNET@CUNYVM.CUNY.EDU (Internet) X* I-FINGER@SPCVXA.BITNET (Bitnet) X* `032 V* Discussion of the Finger program and related utilities. Finger is a util X- V* ity which performs username lookup, WHOIS functions, and system statu Xs V* functions. This list is hosted on the system where VMS Finger and RSTS/ XE V* Finger are maintained, so initial discussions will probably center aroun Xd V* these versions. However, discussions about any Finger variant or simila Xr X* utilities are welcomed. X* `032 V* There is no automated archive retrieval facility, however requests fo Xr X* archived material may be sent to the request address below. X* `032 V* Requests to be added to or deleted from this list, problems, questions X, V* etc., should be sent to I-FinReq%SPCVXA.BITNET@CUNYVM.CUNY.EDU (Internet X) X* or I-FINREQ@SPCVXA.BITNET (Bitnet) X* `032 X* Coordinator: Terry Kennedy X*`032 XFINGER.$PACKAGE XFINGER.01_OF_24 XFINGER.02_OF_24 XFINGER.03_OF_24 XFINGER.04_OF_24 XFINGER.05_OF_24 XFINGER.06_OF_24 XFINGER.07_OF_24 XFINGER.08_OF_24 XFINGER.09_OF_24 XFINGER.10_OF_24 XFINGER.11_OF_24 XFINGER.12_OF_24 XFINGER.13_OF_24 XFINGER.14_OF_24 XFINGER.15_OF_24 XFINGER.16_OF_24 XFINGER.17_OF_24 XFINGER.18_OF_24 XFINGER.19_OF_24 XFINGER.20_OF_24 XFINGER.21_OF_24 XFINGER.22_OF_24 XFINGER.23_OF_24 XFINGER.24_OF_24 $ GOSUB UNPACK_FILE $ FILE_IS = "FINGER.DOC" $ CHECKSUM_IS = 470965637 $ COPY SYS$INPUT VMS_SHARE_DUMMY.DUMMY X[FINGER.DOC] January 1991 X XVMS Version V5.4-1 Finger Version V51.1.24 X X VAX/VMS FINGER X X Written by X Dr. Richard Garland X Columbia University Department of Chemistry X Box 351 Havemeyer Hall X New York, NY 10027 X (212) 280-3183 X X Modifications by X Rand P. Hall X Director, Academic Computing X Merrimack College X 315 Turnpike Rd. X North Andover, Mass. 01845 X 508.683.7111 X X And X X Terry Kennedy X Operations Manager, Academic Computing X Saint Peter's College X 2641 Kennedy Blvd X Jersey City, NJ 07306 X (201) 435-0252 X terry@spcvxa.bitnet X X XOVERVIEW X XThe finger program for VAX/VMS was originally written at the Columbia Uni- Xversity Chemistry department, with later modifications by the above per- Xsons, as well as many others. The original intention was to learn how a Xuser written DECnet task could be written all in a high level language, and Xto be compatible with the protocol of the DECsystem-20 at Columbia (this Xnow works for the 20's and VAXen over DECnet and over the ARPAnet via Xgateways). The project acquired a life of its own and has been the subject Xof many midnight hacking sessions. X XThe program serves 3 main functions: X Xo Identifies users of the system, where they are, what program, etc. X For this function it serves as a personalized SHOW SYSTEM. X Xo Finds a specific user, gives the above information if s/he is logged X on, and in addition gives information about his/her mail and an op- X tional information file s/he may supply. (Plan file) X Xo Serves as an in-bound and out-bound network server. Remote users can X finger the local system as above and local users can finger remote X systems that support the function. As part of the network "finger X protocol" it performs explicit route-through. This is valuable in an X internet situation such as going from DECnet to ARPAnet, BITnet to X DECnet etc. As of April 1989 it supports in-bound and out-bound X DECnet, in-bound and out-bound jnet (BITnet) and out-bound TCP/IP X (Using Kashtan's code available from TWG). X XNote: TCP/IP has not been tested by me (tmk) as I have no TCP/IP links, but Xit is reported to be working. Please feel free to report any bugs. X XIn a network situation where users are spread over many nodes, and in which Xthere is large mail traffic, it can be an invaluable tool in finding peo- Xple, ascertaining if they got your mail etc. X XIf you are not part of a network, the program is valuable as a local utili- Xty. Most use of it is likely to be local except in very distributed situa- Xtions anyway. If you are not part of a network, just ignore the network Xrelated instructions below. X X XNEW FEATURES WITH THIS VERSION X XThe main "feature" for this version was to get things working for VMS V5.x. XIn doing this (major) overhaul, a number of other fixes and features were Xadded. Features added since last DECUS submission may be found in the Xfiles AAAREADME.* in this directory. X X XINSTALLATION INSTRUCTIONS: X XNetwork distribution is via a VMS_SHARE archive distributed in several X(many?) parts in order to remain under 16K per part. Thus, netwwork distri- Xbution does not contain object or executables. If you receive a tape, there Xare 2 directories, [FINGER] and [FINGER.SRC]. Everything needed for a X'vanilla' installation is in the [FINGER] directory, with the complete Xsources in the [FINGER.SRC] directory. X XSteps necessary to install finger: X Xo If you received the distribution as ASCII text only somehow, you must X create the Object and Help Libraries. This is done using the proce- X dure FINGER_BUILD.COM: X X $ @FINGER_BUILD X X This procedure compiles all the appropriate routines and places them X in the appropriate libraries for use later. NOTE: This version re- X quires the version 4 Fortran compiler since it uses some of the new X structure syntax. X X You NEED NOT do this step if you received a BACKUP saveset or via X DECnet VMS to VMS. ( Note also - some of these may be edited first: X read on - ) X X Xo Optional - Study the source FINGER.FOR and FINGERCLD.CLD see what ( if X anything ) you need to change. Most changes that people seem to want X to make have to do with which information to display on the screen as X default. This type of change can be made in FINGERCLD.CLD without X touching FINGER.FOR. Merely change which options have the "DEFAULT" X attribute in the CLD file and you will probably get what you want. X (note - you should change the defaults shown in the help file, X FINGER.HLP, to correspond with your changes.) X X I suggest not changing FINGER.FOR for the first go round. Options X which may differ from site to site are identified by the phrase X "Site-specific" in the source. Most options (maybe all) can be left X as-is and a working program should result for almost any site, but X you really should at least look at them. The file FINGER_CUSTOM.DOC X in this directory lists most of the options which may be customized. X X NOTE - if you recompile these or any other routines you will have to X put the resulting .OBJ into FINGERLIB.OLB. This can be done by hand X or using FINGER_BUILD.COM X Xo Optional - Edit the Help file (FINGER.HLP) to reflect changes in X default qualifiers (see above step) and to change or delete the infor- X mation about nodes which is specific to each site. X Xo Optional - The shared database is set up for 100 terminals, 5000 X users, 150 network hosts, and 5 networks. These numbers were chosen X to accommodate most sites without requiring re-compilation. With X system memory capacities continually increasing, the database's memory X requirements are not large by today's standards. If these figures are X inadequate, or you do not have enough free memory for the database as X supplied, edit the file FINGERCOM.FOR. This is an include file (don't X compile it). The FINGERSHR.FOR and FINGMAINT.FOR files should then be X compiled (no need to link them - that is done by the install proce- X dure). These new versions must then be put into the object library by X hand or using FINGER_BUILD.COM before installing Finger. X Xo Required - Run the procedure INSTALL_FINGER.COM and the program will X be installed. Follow instructions carefully. X X THIS STEP IS THE MINIMUM YOU NEED TO DO TO RUN FINGER. X X It will run without any other steps being done, although the 3 re- X quired steps below should be done if Finger is to be available to your X users. X Xo Required - Construct the database for personal names, terminal loca- X tions and network hosts. This is done using the FINGMAINT program and X uses a shared common section. The startup file, START_FINGER.COM can X be used as a prototype. When you edit and produce your own version of X START_FINGER.COM it should be called from the system startup file that X runs when the system is booted (SYS$MANAGER:SYSTARTUP_V5.COM). X X Note: If you want to try Finger before going to the trouble of build- X ing these databases, just run it and it will work fine but will obvi- X ously not list locations of terminals or user names. X Xo Required - Put a call to START_FINGER.COM into SYS$MANAGER:SYSTART- X UP_V5.COM X Xo Required - Put a foreign command definition into the system-wide login X file such as F*INGER :== $wherever:FINGER X Xo Optional - If you are part of BITnet or use the jnet (tm) RSCS emula- X tion package for RSCS networking, you should link finger with the X appropriate jnet shareable image. This is done as part of the regular X installation procedure. You can include finger as a jnet server X (daemon) by running the procedure INSTALL_JNET_FINGER.COM. You must X also put a call to START_JNET_FINGER into your jnet startup procedure. X X jnet is a trademark of Joiner Associates of Madison Wisconsin. X X NOTE: This version of Finger was developed with jnet 3.3. Compatibili- X ty with earlier releases has not been determined. X Xo If you are actively debugging/editing parts of Finger, it will be -+-+-+-+-+ End of part 3 +-+-+-+-+-