RSX11M V03 ACOUNTING ENHANCEMENTS The following steps need be ta ken to include the accounting en- hancements and run privlege design ation in RSX11M V03. These files have only been implemented on a mapped system. Modifications to the build files should make it poss ible to use these modifications and programs on an unmapped system, but the only way to find out for sure is to try. 1. Apply the SLP fil e to INSHD.MAC(MCR source disk), assemble it, and insert it in INS.OLB. The Software Dispatch has numerous examples of how to do this. As alway s, for safety keep the ori- gional copy of INSHD.OBJ extracted from INS.O LB. Rebuild INS.TSK using the build file on the mapped object disk(INSBLD .CMD). Once one has a built the new INS.TSK one may either move it to the system disk(if an RK05 system) and install it with VMR or more conservatively one may proceed as follows. INS INS;-1/TASK=...TNS REM INS TNS INS Now one can try out the new copy of INS with no risk to the sys- tem. Using the new version of INS will enable RUN p rivileges to be assigned on a user by user basis(via the PRIVILEGE MASK word in U.CW3 of the terminal's UCB). However, modifying INS is not required to make the modifications to HELLO, and BYE work. The new ACTFIL.MAC provides documentation as to what the various bit setting in th e PRIVILEGE MASK WORD will accomplish. The choices are 1) the user ma y not run any uninstalled task , 2) the user may not run task not owned by him(H.DUIC <>LOGIN UIC), 3) an op- tional task is requested to run as HELLO exits, 4) the terminal is logged on a privileged regardless of UIC, 5) A non-privleged user is to have his account updated to reflect the nu mber of disk blocks and files he is using. 2. The SLP file s for HELLO and BYE should be applied. HELLO, BYE and the new ACTFIL .MAC should be assembled and insert- ed into MCR.OLB. Rebuild HELLO and B YE. 3. The tasks ACCLOG,ACCDSK and ACCSET should be built. The build files for ACCLOG are ACC.CMD, ACCASM.CMD,and ACCBLD.CMD. The build files for ACCDSK are DSK.CMD, DSKASM.CMD, and DSKBLD.CMD. The build files for ACCSET are SET.CMD, SETASM.CMD , and SETBLD.CMD. The se build files should be modified to reflect the users disk assignment s. ACCLOG is the task which produces reports on the current status of the account file it is privi- leged but need not be rebuilt with each s ysgen. ACCSET is the task ...RSE which is used to set and reset account file parame- ters. It is non privileged and must run under the UIC which owns the account file RSX11.SYS. On our system RSX11.SYS is owned by [1,54], however, the Operators Manual suggests runing ACNT under [1,2 ] to create the account file. We did not choose to do this since ACNT. TSK was owned by [1,54] and the procedure seemed il- logical. Several SP R's to DEC convinced them that the procedure was also illogical since any privleged task regardless of the UIC under which it runs can read th e account file(surprise!!). ACCDSK is the task ...UPD which updates the user's disk block usage when he logs off. This feature is selectable on a user by user basis by setting a bit in the privlege mask word. It makes no sense to apply this to a privleged user who has files on more than one UIC and/or on more than one disk. The task ...UPD is priv leged and must be rebuilt each sysgen. RSX11M V03 ACOUNTING ENHANCEMENTS PAGE 2 4. Almost all documentation as to what the enhancements will do is contained within the SLP files. Docu mentation on how to use ACCLOG, ACCDSK, and ACCSET is contained with a fil e ACCOUNT.TXT. The user will probably want to change the title l ine in ACCLOG.MAC to reflect the name of the user's institution rather than KMS FUSION. to do so EDI ACCLOG.MAC and PF TITLE1:. I f just the HELLO, and BYE modifications are made, [0,0]RSX11.SYS will start keeping a running tally of total con- nect time by each user . Only privleged users are allowed to be logged onto more than one te rminal at a time. If the system is inproperly shut down( a crash?) users may still be logged on. Upon rebooting these users will not be ab le to log on unless privleged. At this point the system manager must, ins tall ACCSET as ...RSE and with the UIC set to [1,54] type RSE FLAGS. T his will zero all the account file busy flags. ******* RESTRI CTION A problem exists because SHUTUP does not log off the termi- nal from which it is run. If SHUTUP is always run from the con- so le device for the system(the terminal the system boots with) then no problems exist. However, if SHUTUP is run from some other terminal, th en the account busy flag(of the form TTn) for that account is not res et. For a multiuser protection system, the the system boots with the cons ole device logged on, so as a normal procedure in the STARTUP command f ile, the console (boot) terminal is logged off at the end of the command f ile. This re- sets the proper account busy flag ONLY if SHUTUP was r un from that terminal. Otherwise it notices that no flag of the form TT0 exists in the account file, and prints a warning message. Ho wever, an account file busy flag exists still under another ac- count. If someone then goes to use the non console device termi- nal from which SHU TUP was run the night before, he is logged on and now the account file has two account busy flags of the form TTn in the account file under diff erent accounts. When the user goes to log off, the first account foun d with an TTn is reset. This may or may not be the user who is loging off. If it is not the user, the next time he tries to log on, HELLO will notice that his account busy flag is still set, will inform him(if he is non privleged) that multiple logons are illegal, and prevent him lo ging on. Two solutions exist for this problem. First, one can alwa ys run SHUTUP from the console device. Second, in the STARTUP.CMD file, one can install ACCSET and SET /UIC=[1,54] and reset all flags ( RSE /FLAGS). This is a permanent restriction. Since the system only knows the terminal number and account number when a user logs off, there is no unique way of finding the user's account if more tha n one account busy flag per given terminal gets set in the ac- count file. RSX11M V03 ACOUNTING ENHANCEMENTS PAGE 3 If difficulties, or bugs are found, please contact me JAMES G. DOWNWARD KMS FUSION, INC 3941 RESEARCH PARK DRIVE ANN ARBOR, MICH 48104 313-769-8500 and I will try and b e of help and fix bugs as time allows. I would appreciate it if sugge stions for improvements are passed on to me.