.PN1 L....................................................................A .FO2 AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA>@@ [[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[ UNOTE 007‰ Page # of 3 ‰ ‰ Ref: UNOTE 007~ L....T.T......................R............L.........................A From‰:‰Customer Services 6 Jan 1988~ L....T.T.............................................................R Re‰ :‰All you wanted to know about uclock - and kept on asking!~ AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA>@@ [[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[ L.......T.......T.......T.......T.......T.......T.......T.......T....R What does uclock do?~@@ CCCCCCCCCCCCCCCCCCCC uclock is a binary which, when running, will check at given intervals@@ AAAAAA the Uniplex alarms file (UAP/diary/diary.alarms). This file contains@@ IIIIIIIIIIIIIIIIIIIIII details of messages which need to be sent to users at specific times and binaries which need to be run at specified times. If action needs to be taken for any of these occurrences, uclock will take the@@ AAAAAA appropriate action. The possible actions depend on whether the the message recipient is using a Uniplex process, using a non-Uniplex process, or is logged out:~ L.............A...L.....T.......T.......T.......T.......T.......T....R ‰IN UNIPLEX An appropriate message is added to the file@@ AAAAAAAAAA /tmp/WPMS0ttyxxx where xxx represents the terminal@@ IIIIIIIIIIIIIIII III number.~ ‰IN OTHER A beep plus the message is sent to the recipients@@ AAAAAAAA terminal.~ ‰LOGGED OUT If the recipient requested that messages be saved@@ AAAAAAAAAA when logged out, the message will be retained in the alarms file. Otherwise no message will be sent.~ L.......T.......T.......T.......T.......T.......T.......T.......T....R Once running, uclock will also time stamp a lock file@@ AAAAAA (UAP/diary/.uclock.lock) every 30 seconds with the process identifier@@ IIIIIIIIIIIIIIIIIIIIII (pid) to indicate:-~ a) uclock is currently running.~@@ AAAAAA b) No other uclock should be enabled.~@@ AAAAAA When does uclock get kicked off?~@@ CCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCC uclock will normally only get activated on running Uniplex mail@@ AAAAAA (umail) or Uniplex Time management (udiary). Only one occurrence of@@ IIIII IIIIII uclock should be activated on a given system (the time stamping@@ AAAAAA described above ensures this). Both these modules initiate uclock by@@ AAAAAA executing the shell script ustartclock (located in UAP/cmds).~@@ AAAAAAAAAAA IIIIIIII uclock is always run as a background process, and can be kicked off@@ AAAAAA manually by the following command :-~ uclock n &~@@ BBBBBBBBBB where n indicates the time interval in minutes the alarms file will be@@ A checked. ustartclock simply contains the command: uclock 1 &~@@ AAAAAAAAAAA BBBBBBBBBB What happens if I turn uclock off?~@@ CCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCC By selecting the Disable Alarms to Screen option from the TIME MANAGER@@ IIIIIIIIIIIIIIIIIIIIIIII ADMIN menu, or by typing uclock off at a prompt, the user ensures that@@ IIIIIIIIII alarm or mail messages are not displayed on his or her screen. It does not affect the other functions of uclock, nor indeed does it even@@ AAAAAA need uclock to be running in the first place for this action to be@@ AAAAAA taken. .PM3 All that happens is that the users username is registered in a stop file (UAP/diary/diary.alarms.x) which will be checked before an alarm@@ IIIIIIIIIIIIIIIIIIIIIIII or message is about to be sent to that user. .PM5 How do I receive mail sent via Unix from within Uniplex?~@@ CCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCC This can be done in two ways. Both involve the invoking of the binary umd_runix which will check a given Unix mailbox at given intervals and@@ AAAAAAAAA transfer any mail in that mailbox to the Uniplex system.~ H...L...T.......T.......T.......T.......T.......T.......T.......T....R .PM6 1. When running Uniplex, pick and point the System Administration option and then the Enable Remote Mailbox option.~ ‰ When presented with the form, enter umd_runix for the Mailbox@@ AAAAAAAAA IIIIIII driver and enter your Unix mailbox (eg. /usr/spool/mail/myname)@@ IIIIII IIIIIIIIIIIIIIIIIIIIII for the Mailbox. Your Unix mailbox will then be checked every n@@ IIIIIII A minutes where n indicates the interval you set in this form.~@@ A .PM8 2. From a Unix prompt (or in the login procedure for a user) enter@@ IIIII the following instruction :-~ ‰ umd_runix /usr/spool/mail/myname~@@ AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA ‰ This will cause any Unix mail currently in your mailbox to be transferred to Uniplex. It will be run once only.~ L.......T.......T.......T.......T.......T.......T.......T.......T....R Can I avoid uclock running altogether?~@@ CCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCC Yes, copy the shell script ustartclock to a backup file and edit@@ AAAAAAAAAAA ustartclock so that it contains the single instruction :-~@@ AAAAAAAAAAA exit 0~@@ BBBBBB What are the consequences of doing this?~@@ CCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCC H.......L.......T.......T.......T.......T.......T.......T.......T....R 1. No alarm messages will be processed.~ 2. No background processes will be initiated that have been entered into the alarms file (eg: umd_clean to process@@ AAAAAAAAA non-read mail notifications and other mail clean ups)~ 3. No notification will be given of mail received.~ 4. No remote mail (or Unix mail) will be received unless umd_runix is initiated manually as described above.~@@ AAAAAAAAA L.......T.......T.......T.......T.......T.......T.......T.......T....R ie: you would not want to do this on a real "live" system, but might@@ IIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIII well want to in a benchmark situation.@@ IIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIII When does Uniplex display an alarm message on the screen?1~@@ CCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCJ .FS 1 See Update at the end of this document@@ J .FE If a message has been sent to a user, it will be displayed immediately if the user is not using a Uniplex process. If the user is in Uniplex, the message will get displayed either after 1000 keystrokes or if no keystrokes have been entered for 15 seconds. These limits are not user definable.1~@@ III J How does Uniplex do this?~@@ CCCCCCCCCCCCCCCCCCCCCCCCC When either of the above 2 conditions have been met, Uniplex will check the message file that uclock has written out (ie.@@ AAAAAA /tmp/WPMS0ttyxxx as described above). If there are messages in this@@ IIIIIIIIIIIIIIII file, they will get displayed on the screen.~ .PM4 Other time-driven activities (not controlled by UCLOCK)1~@@ CCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCJ ~ If the user is in menus, and a menu clock is being used, this will@@ AAAAA also get updated with the new time every minute.~ .PM12 Also, if the user is in the WP Editor and Checkpointing has been@@ AAAAAAAAA IIIIIIIIIIIII requested (ie. 'X' is included in the MODES flag of uniplex.sys1) the@@ AAAAA IIIIIIIIIIIJ file being edited will be automatically saved if the following conditions are true :-~ H.......L.......T.......T.......T.......T.......T.......T.......T....R 1) At least one keystroke has been entered since previous auto-save.~ 2) The Uniplex environment variable Uchktime is non-zero, if@@ IIIIIIII present.~ 3) At least Uchktime seconds (if present) or 600 seconds@@ IIIIIIII (default) have elapsed since previous auto-save.~ L.......T.......T.......T.......T.......T.......T.......T.......T....R .PM11 Update (July 1989)~@@ CCCCCCCCCCCCCCCCCC Uniplex 6.10 incorporates a number of enhancements relating to Message Delivery and Checkpointing. The following keywords may now be defined in the uniplex.sys file:~ L............R..L.......T.......T.......T.......T.......T.......T....R CHECKTIME~ These define when Uniplex checks for popup messages@@ RRRRRRRRR CHECKCHARS~ (Mail Notification and Alarms).~@@ RRRRRRRRRR SAVETIME~ These define when Uniplex performs autosaves.~@@ RRRRRRRR SAVECHARS~@@ RRRRRRRRR L.......T.......T.......T.......T.......T.......T.......T.......T....R The "X" flag in the uniplex.sys MODE string is now redundant, as is@@ B BBBB the Uchktime environment variable.~@@ IIIIIIII Further details of these keywords are included in Chapter 7 of the Uniplex 6.10 Configuration Guide (Part Two).