home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 18 REXX / 18-REXX.zip / ACTS11.ZIP / README.CLK < prev   
Text File  |  1992-11-04  |  6KB  |  94 lines
  1.    Program: ACTSCLOK.CMD - set system date and time from Automatic                
  2.                 Computer Time Service (ACTS) maintained by the                    
  3.                 National Institute of Standards                                   
  4.  
  5.    Version: 1.1 - November, 1992
  6.  
  7.    Author:  Chuck Giglia, Delaware Valley OS/2 Users Group
  8.             1129 Webster Drive, Wilmington, Delaware 19803                        
  9.             Compuserve: 72317,3704
  10.             Delaware Valley OS/2 Users Group BBS (302-477-0236): /0
  11.                                                                                   
  12.    Acknowledgements:                                                              
  13.             Many thanks to Jerry am Ende of the Delaware Valley OS 2              
  14.             Users Group for his enthusiasm toward REXX which piqued               
  15.             my interest in improving on his TIMESET.CMD routine.                  
  16.             Also, I appreciate the design ideas I got from reading John
  17.             Deurbrouck's article in the October 27, 1992 issue of PC Magazine.
  18.             His program was a bit flashier, but it was written for                
  19.             Windows in C and I didn't think this problem needed a                 
  20.             graphical solution.                                                   
  21.                                                                                   
  22.    Warrantee:
  23.             I hope you can use this routine to your advantage, but I
  24.             provide no warrantees nor do I guarantee that it performs             
  25.             any useful function.                                                  
  26.                                                                                   
  27.             Your feedback or ideas for improvement are appreciated.               
  28.                                                                                   
  29.    Product Description                                                            
  30.         ACTSCLOK.CMD is an OS/2 REXX command file which sets the System Date
  31.         and Time of the invoking computer to the current date and time from       
  32.         the Automated Computer Time Service (ACTS) maintained by the National     
  33.         Institute of Standards. The ACTS returns Greenwich Mean Time (GMT),       
  34.         so ACTSCLOK.CMD provides for handling a positive or negative offset       
  35.         from GMT and allows the user to enable or disable Daylight Saving         
  36.         Time (DST) adjustment.                                                    
  37.                                                                                   
  38.    Usage is:                                                                      
  39.          ACTSCLOK <offset> <dstIndicator> <comPort> <PhoneNumber> <dialPrefix>    
  40.                 <offset>       = Minutes from GMT (i.e. EST = -300).              
  41.                                 The default is -300                               
  42.                 <dstIndicator> = Adjust for DST? (Y or N). The default is Y       
  43.                 <comPort>      = COM port to use (COM1, COM2, etc.). The          
  44.                                 default is COM1                                   
  45.                 <PhoneNumber>  = Area code and phone number of the ACTS.          
  46.                                 The default is 303-494-4774.                      
  47.                 <dialPrefix>   = Any dialing prefixes or codes required to dial   
  48.                                 the ACTS. The default is 1, (the comma causes     
  49.                                 the modem to pause briefly before continuing)     
  50.                                                                                   
  51.         Individual command line arguments may be forced to use the default by     
  52.         coding an exclamation point (!) in that argument's position. For example  
  53.         to accept all defaults except the COM port and dialing prefix, use:      
  54.                                                                                   
  55.                         ACTSCLOK ! ! COM2 ! 9,                                    
  56.                                                                                   
  57.         This example will set the system clock to 300 minutes before GMT during   
  58.         Standard Time or 240 minutes before GMT during Daylight Saving Time.      
  59.         The system will use COM2 to dial 9,303-494-4774 to connect to the ACTS.
  60.  
  61.         Run ACTSCLOK without any arguments (or with a single question mark (?) 
  62.         as its sole argument) to obtain help.
  63.  
  64.    Future Plans:
  65.         There's no guarrantee I'll get to these, but a few fixes and improvements 
  66.         came to mind as I was adding this documentation. They include:
  67.  
  68.           - Testing ACTSCLOK on a wider range of communications hardware. I've
  69.             run it successfully using a Practical Peripherals PM 2400FX96SA and
  70.             a Racal Vadic 2400PA. There's no reason it shouldn't work with any
  71.             Hayes compatible modem, but I ran into trouble when trying to run
  72.             over a network to a shared modem pool - just didn't seem to dial the
  73.             modem.
  74.  
  75.           - Can't figure out why the modem doesn't hang up when ACTSCLOK sends
  76.             the hang up command (ATH). If you read the REXX code, you'll see I've
  77.             tried a couple things, but it still doesn't do it. For now, you're
  78.             left with either manually reseting the modem or waiting for the ACTS
  79.             to time you out and hang up.
  80.  
  81.           - Enabling ACTSCLOK to run on a schedule (i.e. once a month, etc.). It
  82.             seems a bit extravagant to put this routine into the OS/2 2.0 startup
  83.             folder and have it run daily (although this may be useful to some).
  84.  
  85.    Release Notes:
  86.           10/28/92  Version 1.0 -  Initial Release
  87.  
  88.           11/4/92   Version 1.1 -  Added functionality to automatically determine
  89.                                    date format set for system - Thanks again to
  90.                                    Jerry am Ende for his input here.
  91.                                    Also, corrected small problem with time adjustments
  92.                                    crossing into yesterday.
  93.  
  94.