		Sun MTP date/time configuration
		-------------------------------

The Sun MTP date/time configuration utility provides Sun MTP and
MBM users a way to change the date/time for Sun MTP and MBM
systems.  By default, Sun MTP and MBM reflect the UNIX system time.
For the purpose of Year 2000 testing, it is useful to change the 
date/time to a date in the future (or past) and check if the 
applications running under Sun MTP/MBM are behaving as expected. 
Also, users can have an advance view of the Sun MTP/MBM Y2K
compliance and behavior. 

To use the date/time configuration utility for Sun MBM, the environment 
variable PACK must be set. To use the date/time configuration utility
for Sun MTP, the environment variable KIXSYS must be set.

The various menu options are explained below:-

1. Set Sun MTP startup date
   ------------------------

   This option allows the user to enter a date in the format
   MM/DD/YYYY-HH:MM:SS

   The date is validated. (it must be between 1970 and 2030) 
   If valid, this date is then treated as an absolute startup date each time 
   the Sun MTP region (corresponding to the specified KIXSYS) is 
   started. 

   For example, if the user specifies 12/31/1999-23:30:00,
   the time at which Sun MTP starts will be Dec. 31, 1999 11:30 p.m. 
   This time shall keep incrementing within Sun MTP; i.e., after eight 
   hours, the Sun MTP time shall be Jan 01, 2000 7:30 a.m. If the Sun MTP 
   system is brought down (say after a couple of days) and restarted, 
   the Sun MTP time shall again be Dec. 31, 1999 11:30 p.m. and
   incrementing.  This is why we call this time the absolute startup time.

2. Set Sun MBM startup date
   ------------------------

   This option allows the user to enter a date in the format 
   MM/DD/YYYY-HH:MM:SS

   The date is validated. (it must be between 1970 and 2030)
   If valid, this date is then treated as an absolute startup date
   each time the Sun MBM system (corresponding to the specified PACK) 
   is started. 

   For example, if the user specifies 12/31/1999-23:30:00, the time at
   which Sun MBM starts will be Dec. 31, 1999 11:30 p.m.  This time
   shall keep incrementing within Sun MBM; i.e., after eight hours,
   the Sun MBM time shall be Jan 01, 2000 7:30 a.m. If the Sun MBM
   system is brought down (say after a couple of days) and restarted,
   the Sun MBM time shall again be Dec. 31, 1999 11:30 p.m. and
   incrementing.  This is why we call this time the absolute startup time.

3. Set current date for both Sun MBM and MTP
   -----------------------------------------

   This option allows the user to enter a date in the format
   MM/DD/YYYY-HH:MM:SS

   The date is validated. (it must be between 1970 and 2030)
   If valid, this date becomes the "current" date for BOTH Sun MTP
   and MBM. By "current", we mean that this date starts incrementing
   from the user-specified value right when the date/time configuration
   tool confirms that it has set the "current" date. It keeps on 
   incrementing with every passing second EVEN IF Sun MTP 
   and/or MBM systems are down. It is important to realize that
   the clock starts ticking for the startup date right when the 
   tool accepts it and NOT when the system is brought up next.
   The date at which the Sun MTP and MBM systems start up is the 
   date that the Sun MTP and MBM systems would have had if they 
   would have continued running. This durable behaviour
   of the date even if Sun MTP and MBM systems recycle is the
   difference between this option and the absolute date option (1 & 2)
   described above. If absolute date (options 1 & 2) is chosen, the startup 
   date is always set to the date specified. 

   For example, if the user specifies 12/31/1999-23:30:00,
   the time at which Sun MBM starts will be Dec. 31, 1999 11:30 p.m. 
   and the time at which Sun MTP starts will also be Dec. 31, 1999 11:30 p.m.
   (if these systems are started immediately after setting their current date).
   This time shall keep incrementing within Sun MTP and MBM; i.e.,
   after eight hours, the Sun MBM time shall be Jan 01, 2000 7:30 a.m. and
   the Sun MTP time shall also be Jan 01, 2000 7:30 a.m. If the Sun MBM
   system is brought down (say after exactly two days) and restarted, the
   Sun MBM time shall be Jan 03, 2000 7:30 a.m. If the Sun MTP system is
   brought down (say after exactly 3 days) and restarted, the Sun MTP time
   shall be Jan 04, 2000 7:30 a.m. Thus, once the current date is set for
   Sun MTP and MBM, it keeps on incrementing with time even if the
   systems are down.

   To explain this further, let us take another example. Say the 
   user specifies 12/31/1999-23:30:00 as the "current" date for 
   Sun MTP and MBM and decides to bring the two systems up at a later 
   time. Let's say he brings the Sun MBM system up after 20 minutes. The 
   Sun MBM time on startup shall be Dec. 31, 1999 11:50 p.m. Let's say he 
   brings the Sun MTP system up after 12 hours, the Sun MTP time on startup 
   shall be Jan 01, 2000 11:30 a.m. At that time, the Sun MBM time would
   also have been incremented to Jan 01, 2000 11:30 a.m. So, this option 
   achieves the task of keeping the Sun MTP and MBM date/time in sync. 

D. Display present date/time configuration
   ---------------------------------------

   This option displays the date/time configuration for both the 
   Sun MTP and MBM systems. It displays the startup time for both
   Sun MTP and MBM systems. If the date has been specified as a
   relative date (option 3), the date displayed is, the "current" date for
   that system.  The "current" date for the system would be the user-specified
   date (in option 3) plus the time elapsed since option 3 was used. 
   (in the date/time configuration utility) 

   If the date has been specified as an absolute date (option 1 & 2),
   the date displayed is the startup date. If the date/time
   has not been configured for Sun MTP and/or MBM, it indicates so 
   in the display.

R. Reset Sun MTP/MBM current date to the UNIX system date
   ------------------------------------------------------

   This option resets the date/time configuration for both the 
   Sun MTP and MBM systems, if any. If there isn't any existing 
   date/time configuration for Sun MTP and/or MBM, this option 
   shall indicate so in the display. Since we do not allow 
   option 3 if option 1 or 2 has been used (i.e. relative date
   if existing configuration has absolute date) and vice-versa
   (i.e. option 1 or 2 if option 3 has been used, absolute date
   if existing configuration has relative date), this option is 
   useful to wipe out existing date/time configuration.

H. Help
   ----
   This option displays this help file. This help file explains the 
   various options that can be used in the date/time configuration 
   utility. If you are viewing this, you probably already know about 
   this option. 

E. Exit configuration
   ------------------

   This option exits the date/time configuration utility.

  
