*************************************************************************** * The files offered in the Technical Library Supplements (TLS) * * directory are for experimental or educational use only. They * * are provided "AS IS" to knowledgeable users as a courtesy. * * They are NOT supported by SCO Support Services. All use of * * this material is the sole responsibility of the user. See the * * associated "README" or "info" files located in the TLS directory * * on SCO's Online Support (SOS) system for further information. * *************************************************************************** TLS705: An RTC test program for SCO UnixWare Release 2.1 and UniWare 7 Systems ============================================================================== This TLS consists of a Real Time Clock (RTC) test program (check-rtc) that can be used to test the RTC of SCO UnixWare 2.1 and UnixWare 7 based systems. WARNING: The check-rtc program should never be run on a live system. To test the RTC of an SCO UnixWare 2.1 or UnixWare 7 server using the check-rtc program you should: 1) Copy TLS705.bin to the server you wish to test. Rename the file TLS705.bin to check-rtc using the command: mv TLS705.bin /check-rtc Note: tha program should be 11796 bytes in size. 2) Create an Emergency Boot floppy set for your system. For a complete description of how to create an Emergency Floppy set please refer to your UnixWare documentation, the emergency_disk(1M) manual page or to the Technical Article: http://www.sco.com/cgi-bin/ssl_reference?105385 3) Boot your server from the Emergency Boot floppies and follow the prompts until you reach the "Emergency Recovery Menu". 4) Choose the "Mount File Systems" menu pick to mount the root filesystem onto /mnt. 5) Choose the "Access UnixWare Shell" menu pick to get access to a UNIX shell prompt. 6) At the UNIX shell prompt ("#") type the following command: # /mnt/check-rtc This program will perform the following tests: a) A test to check if your system uses a 2 digit or a 4 digit RTC. A 2 digit RTC updates the Year field in the CMOS but does not update the Century byte. A 4 digit RTC updates both the Year and Century bytes. All SCO Operating Systems will function correctly with 2 digit and 4 digit RTCs. If your system has a 2 digit RTC then the century byte will not be used in the two following tests. b) A test to see if the RTC can successfully roll over from the 31st of December 1999 to the 1st of January 2000. A green PASSED message indicates that the test was a success. A red FAILED message indicated that your RTC is faulty and your hardware needs to be replaced in order to function correctly on rollover to the year 2000. c) A test to see if the RTC can successfully roll over from the 28th of February 2000 to the 29th of February 2000. A green PASSED message indicates that your RTC recognises 2000 as a leap year. A red FAILED message indicates that your RTC is faulty and your hardware needs to be replaced. NOTE: All tests are using a GMT TZ environment variable. This will not affect the timezone setting of the SCO Operating System on the hard drive of your SCO Server. 7) When these tests are complete you will be provided with a # shell prompt. To return to the "Emergency Recovery Menu" type exit and then press the keys 8) Select "Unmount File Systems" from the Emergency Recovery Menu. 9) Select "Reboot" from the Emergency Recovery Menu and follow the instructions to remove the Emergency Recovery floppy before you reboot your UnixWare Server. NOTE: Although SCO UnixWare and UnixWare 7 Operating Systems do not use the BIOS to read the RTC, the BIOS can interfere and corrupt your RTC when the system is performing its Power On Self Tests (POSTs). It is for this reason that you should test the BIOS of your server to ensure that it is not faulty. There are many different vendors of BIOS Y2k test programs. One program that is free to download and use is available from the National Software Test Labs (NSTL) at: http://www.nstl.com/html/nstl_ymark2000.html NOTE: It is recommended that you also contact the vendor of your hardware for advice on the Y2K readiness of your hardware. Please send comments, suggestions and criticisms to jboland@sco.com DISCLAIMER: SCO does not guarantee accuracy, adequacy or completeness of the features provided by this program. SCO MAKES NO WARRANTIES, EXPRESS OR IMPLIED, AS TO RESULTS TO BE OBTAINED BY ANY PERSON OR ENTITY FROM USE OF THE CONTENTS OF THIS PROGRAM. SCO MAKES NO EXPRESS OR IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE OF ANY PRODUCT MENTIONED IN THIS PROGRAM.