  
 		ACCOUNT FILE MAINTANENCE
 HELP on specific topics is available by typing
 HELP $ACCOUNT keyword, where keyword is one of the following.
 
	COMMANDLINE	COMMANDLINE for the ...RSE program.
	ERROR 		Error messages for the enhancements.
	ERROR		Error messages for ACCLOG.
	ERROR BYE	Error messages for BYE.
	ERROR HELLO	Error messages for HELLO.
	ERROR INSTALL	Error message from INS.
	ERROR RESET	Error messages for RESET.
	ERROR TRUNCATE	Error messages for TRUNC.
	ERROR UPDATE	Error messages for UPDATE.
	ERROR WHO	Error messages for WHO.
	LOG		Getting a ACCOUNT status report.
	MAIL		Using the MAIL utility
	MAIL SEND	Sending mail to another user
	MAIL RECEIVE	Receiving mail sent by yourself or another user.
	SET BLOCKS	Setting the users allowed number of disk blocks.
	SET PRIVLEGES	Setting the users privleges.
	SET TASK	Setting a task to run after logon.
	RESET		The account maintanance program RESET(/Task=...RSE).
	RESET ALL	Resetting the LOGON TIME, LOGON FLAGS, LOGON NUMBER(all accounts).
	RESET FLAGS	Resetting the ACCOUNT BUSY FLAGS.
	RESET LOGONS	Resetting the number of logons(all entries).
	RESET TIME	Resetting the LOGON TIME(all entries).
	UPDATE		Updateing the users disk block usage.(...UPD).
	WHO		Finding out who is on the system.
  
  
1	LOG
 READING THE TOTAL LOGON TIME, THE # OF LOGONS, THE PRIVLEGE MASK, and the TASK
 	To read the status of the account file at any time , type  RUN  $ACCLOG
 ACCLOG is a task which will provide a printed record of virtually every item in 
 the account file with the exception of the password, the system device, and the 
 date and time of the last logon.  In addition it indicates which accounts are 
 currently in useby flagging an active account with the terminal number logged  
 onto the account.  This entry is of the form TTn.
 
1	MAIL
	Users may leave messages for themselves or other users by
	means of an intra-user MAIL utility, MAIL.  When a user logs
	on he/she is notified if ther is any mail waiting to be looked at.
 
			>>>YOU HAVE MAIL<<<
 
	Immediately following logon, or any time thereafter, a user may
	request that mail be displayed at their termina.  The user is
	given the option of having the MAIL.TXT file entered into their
	directory at that time or deleting the MAIL.  The directory
	entering operation only works if the user's SY: is LB1:.  Further
	HELP on using the MAIL utility may be requested by typing
	HELP $ACCOUNT MAIL keyword     where keywords are
 
		SEND		Sending mail to another user.
		RECEIVE		Receiving mail from another user.
 
2	RECEIVE
	A user who is notified that he/she has MAIL waiting, may receive
	mail by typing MAIL ME, or  ME in response to the  TO WHO?  prompt.
	The user is given the oportunity of retaining the mail by having
	it entered into their directory on LB1:.  Otherwise, the MAIL is
	"burned" after reading.  If the user's  SY: is not LB1:, his mail
	can never be saved(regardless of what MAIL says).  When the system
	prints out the MAIL message it prefixes it with the date it was sent,
	the UIC of the sender, and the sender's last name.
 
2	SEND
	MAIL may be sent to another user by either typing
 
			MAIL username
		or
			MAIL
 
	If 'username' is omitted, the SYSTEM prompts for the name with
	TO WHO?, at which time the 'username' is entered.  The SYSTEM will
	inform the user if the 'username' does not represent a valid account.
	If the 'username' is accepted the SYSTEM prompts with MAIL>, at which
	time the user may type in up to 80 characters followed with a carriage
	return.  Text lines may be entered in this manner until done, at
	which time the user enters a Control Z(^Z) to signify the end of
	the MAIL file.
		Valid 'username's are either the user's last name or
	their account number specified as [GGG,MMM],[GGG/MMM], or
	GGG,MMM.  The correct user name must be known to send MAIL.
  
  
1	RESET
 The task RESET is used to RESET the account file(#logons, terminal
 connect time, account busy flags).  It must be run with the UIC=[1,54].
 It must be installed as ...RSE (for RESET).  For help with the command line
 for RSE, type HELP $ACCOUNT COMMANDLINE.
2	TIME
 RESETING THE TOTAL LOGON TIME(ALL ENTRIES)
 	This entry is zeroed or reset using RESET
  
 			INS $RESET
 			RSE TIME
 			REM RSE
  
2	FLAGS
 RESETTING THE ACCOUNT BUSY FLAG(ALL ENTRIES)
  
 	In rare cases(system crash, etc.) it is possible for the system to
 stop without a user logging off.  In this event the flag entry in the account
 file of the form  TTn is not cleared.  This means that a non-privleged user
 may not log on until this flag in his section of the account
 file is cleared.  This is accomplished using
  
 			INS $RESET
 			RSET FLAGS
  			REM RSE
  
 All non-privleged users should be off the system when this is done since
 all terminal flags in the account file will be zeroed together.  This will
 not adversely effect a privleged user who is logged on.  A non-prvleged user
 would not get screwed up, but upon logging off, the accumulated terminal time
 for his session would not get added into his account.
  
 RESETTING THE ACCOUNT BUSY FLAG FOR JUST ONE USER
 	Install RESET,   then enter the command string
  
 		RSE USER=NAME:PASSWORD/FLAG
  
 where NAME is the user's last name(in the account) and PASSWORD is the user's
 password.  Only the user's account busy flag will be reset.
  
2	LOGONS
 RESETTING THE TOTAL NUMBER OF LOGONS ENTRIES
 	This is accomplished using  RSE.
  
 			INS $RESET
 			RSE LOGONS
 			REM RSE
  
2	ALL
 RESETTING ACCOUNT FLAGS, # OF LOGONS, AND LOGON TIME AT ONCE
 	For ease in monthly reseting of the account file, the account
 flags, the # of logons entries, ad the total terminal connect time
 entries can be all zeroed out with one command.
  
 			INS $RESET
 			RSE ALL
 			REM RSE
  
1	SET
2	PRIVLEGES
 SETTING AND CLEARING THE PRIVILEGE MASK WORD
  
 	At present the first eight bits and BIT 15 of the PRIVLEGE MASK word
 in U.PRV1 of the terminal UCB are defined.
  
 	BIT	0	User may not use the RUN command
 	BIT	1	User may only run tasks owned by him or by [377,377]
 	BIT	2	A task(6 letter name) in the account file will be run
 			as HELLO exits.
 	BIT	3	When set the user's terminal is logged on SLAVE.
 	BIT	4	When set, do not abort non privleged tasks at logoff.
	BIT	5	Reserved for BATCH.
 	BIT	6	When the user logs off BYE sends an MCR command to ...UPD
 			to update the user's account file to reflect the number
 			of files and disk blocks in use on that account.
	BIT	7	The user has group manager privleges.  His login UIC's
			member number changes he/she changes UIC's via SET /UIC.
	BIT	8	The user is 'non-privleged user manager'.  By convention
			all non-privleged accounts have UIC's >[310,x].  This
			user is allowed to change his LOGON UIC to any value as
			long as UIC>[310,x].  Otherwise user is treated 
			identically with non-privleged user.
 	BIT	15	The user is logged on as privleged even if his UIC is 
 			nonprivileged
  
 The PRIVLEGE MASK word is set using
  
 			RSE USER=NAME:PASSWORD/PRIV=NNNNNN
  
 	where NNNNNN is a 6 character octal number.
  
 cleared using, 
  
 			RSE USER=NAME:PASSWORD/PRIV=
  
2	TASK
 INSERTING A TASK NAME INTO THE ACCOUNT FILE
  
 	Inserting a task name into the account file is done using
  
 			RSE USER=NAME:PASSWORD/TASK=XXXXXX
  
 where XXXXXX is a 6 character ASCII task name.
  
2	BLOCKS
 SETTING THE NUMBER OF BLOCKS THE USER IS ALLOWED TO USE
  
 	The account file has an entry for the number of blocks the user is  
 allowed to use.  When the user logs on, HELLO checks to see if this number has 
 been exceeded.  If it has, HELLO prints a warning message at the terminal.
 To set the number of blocks the user is allowed to use the syntax is
  
 			RSE USER=NAME:PASSWORD/BLKS=NNNN
  
 where NNNN is a decimal number.
  
  
  
  
1	COMMANDLINE
 		THE ACCOUNT FILE UTILITY -- RESET
  
 	The ACCOUNT FILE utility, RESET, installed as ...RSE (for RESET)
 supports the following syntax in its command line.
  
 		RSE COMMAND[=qualifier]/SW1[=XX]/SW2[=ZZ].....
  
 The allowed commands are
  
 				FLAGS
 				TIME
 				LOGINS
 				ALL
 				USER
  
 Of these commands only the last command, USER, requires a qualifier.   It's
 syntax is
  
 			USER=name:password
  
 where the ":" is required syntax to seperate the user's name from his password.
 Also the USER command requires one or more switches.  Three switches exist
  
 			/TASK=XXXXXX
 			/PRIV=NNNNNN
 			/FLAG
 			/BLKS=NNNN
  
 In all cases the account file entry is set by following the "=" with either
 a task name or octal or decimal digit, or reset by not following the "=" 
 with anything.  The switch /FLAG need not be followed by anything.  If present 
 the user's account busy flag is cleared.
  
  
1	UPDATE
 UPDATING THE USERS ACCOUNT WITH THE NUMBER OF FILES AND BLOCKS IN USE
  
 	If BIT 6 in the terminal PRIVLEGE MASK (U.PRV1) is set BYE sends a
 message to UPD to update the users account with the total number of files
 and blocks the user had on his system device when he logged off.
 The format of the message is
  
 			UPD DEV:[UIC]password/UP
  
 For this procedure to work the task UPDATE (Account for disk block usage) must
 be installed as ...UPD.  UPD may be run at any time by any user to find out the 
 of files and blocks on use by any account.  However, if the desire is to update
 the account file [0,0]RSX11.SYS, then UPD must be run from a privleged terminal
 and both the password and the /UP switch must be present.  The /UP switch is to
 safegard UPD from accidental use by a privleged.  The non privleged account
 account syntax requires that the password and the /UP switch be omitted.
 However,  a privleged account might accidently type a file specifier after the
 [UIC].  The/UP switch is to insure that aything following the [UIC] is intended
 and justifies reading through the account file to search for a match.
 
1	WHO
	To quickly find out 'who' is on the system type
 
			WHO
 
	The information displayed is the user's LOGON UIC, Terminal Number,
	First Name, and Last Name.
 
		[GGG,MMM]  TTn	Firstname    Lastname
 
	For a nonprivleged user, the LOGON UIC will be their Current UIC.
	A privleged user, however, may have changed their UIC to other than
	the initial LOGON UIC.
 
1	ERROR
 
	Request HELP on error messages using the keword specific to the program
	giving the error message, ie.
 
		HELP $ACCOUNT ERROR keyword
 
	where keyword is ACCLOG,BYE,HELLO,RESET,TRUNCATE,UPDATE, or WHO.
 
2	ACCLOG
  
	ACCLOG -- ACCOUNT FILE OPEN FAILURE
		The account file, LB0:[0,0]RSX11.SYS, could not be opened.  Either
		the account file is busy(try again), LB0: is dismounted or offline,
		or the file is locked.  The file only will get locked if the system
		or an account file task crashes while the file is being updated.
	ACCLOG-- ACCOUNT FILE READ ERROR
		A FCS error was detected during a read operation.  If ACCLOG gets
		part of the way through the file, a parity error on the disk(bad block) 
		may have developed.
 
2	BYE
 
	BYE -- STILL LOGGED ONTO FIRST TERMINAL?
		Privleged users with UIC group numbers <=10, may if they
		so desire log onto more than one terminal at a time on the
		same account.  However, only the first terminal logged onto
		is marked with the Account Busy Flag.  The second and subsequent
		terminals logged onto have no flag set.  When BYE finds no flag,
		it logs off the terminal and reminds the user he may be logged
		on elsewhere also.
	BYE -- ACCOUNT FILE BUSY -- TRY AGAIN
		The account file could not be opened, most likely it was busy.
		See also discussion of ACCLOG error messages.
	BYE -- PRIVLEGED LOGOFFS DISABLED
		BYE will not let a privleged user logoff if logons are disabled.
	BYE -- ACCOUNT READ ERROR -- GET HELP!
		The system can't read the account file.  See also discussion of
		ACCLOG errors.
	BYE -- ACCOUNT FILE LOCKED -- TRY AGAIN
		When the account file was opened it wasn't locked.  When BYE went
		out to actually write to the file, it found the file locked.  More
		than likely, someone flipped on the write protect switch on LB0:
 
2	HELLO
  
	HEL -- MULTIPLE LOGONS ILLEGAL
		Only a bonifide privleged user with a group number <=10 may log onto
		more than one terminal at a time on the same account.
	HEL -- REQUESTED TASK NOT FOUND -- LOGGING OFF
		If a task is specifed in the account file to be run at logon and
		either the task is busy, or not found(not installed), this message
		is displayed.
2	RESET
 
	RESET -- ACCOUNT FILE WRITE ERROR
		An error occured in writing the account file.  Most likely
		only one block(4 accounts) are corrupted, but who knows?
	RESET -- ACCOUNT FILE READ ERROR
		Problems reading file. See explanation under ACCLOG.
	RESET -- ACCOUNT FILE BUSY
		Account file locked either because in use, or because improperly
		closed.
	RESET -- COMMAND SYNTAX ERROR
	RESET -- COMMAND ERROR
		The command to reset is not syntactically correct.
	RESET -- COMMAND WORD NOT RECOGNIZED
		An unrecognized keyword has been used.
	RESET -- ILLEGAL OCTAL VALUE
		Numbers between 0 - 7 only.
	RESET -- MISSING PASSWORD
		The password is required if the USER=NAME:PASSWORD  form of
		a command line is used.
	RESET -- ILLEGAL DECIMAL NUMBER
		Non-numeric character detected.
	RESET -- ALL ACCOUNT BUSY FLAGS RESET
	RESET -- ALL TOTAL LOGIN TIME ENTRIES ZEROED
	RESET -- ALL # OF LOGINS ENTRIES ZEROED
 
2	TRUNCATE
 
	SYNTAX ERROR		Invalid command line
	FCS ERROR nn		An FCS error number nn occured.
	NO SUCH FILE		The file specified in the command line does not exist.
2	UPDATE
 
	UPD -- SYNTAX ERROR
	UPD -- BAD DIRECTORY NAME
		[GGG,MMM] was not a valid UIC.
	UPD -- DISK OPEN ERROR NN
	UPD -- DISK WRTE ERROR NN
		An FCS error number NN was detected during a READ or
		WRITE.
	UPD -- ACCOUNT NOT UPDATED, ACCOUNT FILE BUSY OR LOCKED
	UPD -- ACCOUNT FILE READ ERROR, GET HELP!
	UPD -- ACCOUNT FILE WRITE ERROR, GET HELP!
	UPD -- ACCOUNT NOT FOUND
		The account specified in the command line could not be found.
	UPD -- PRIVLEGE VIOLATION
		A non-privleged user is not allowed to use the /UP switch
 
2	WHO
 
	See the error messages for ACCLOG.  WHO's messages have identical 
	meaning.
 
2	INSTALL
 
	INS -- PRIVLEGE VIOLATION - RUN COMMAND NOT ALLOWED
		The user is prohibited from using the RUN (INS/RUN=REM)
		command.
	INS -- PRIVLEGE VIOLATION -TASK OWNERSHIP
		The user may not run tasks which he doesn't own.
