home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 11 Util / 11-Util.zip / sets.zip / SETS.TXT < prev    next >
Text File  |  1999-09-13  |  8KB  |  263 lines
  1.                         SETS.TXT
  2.                        ══════════════
  3.  
  4.                        12th SEPTEMBER 1999
  5.  
  6.                        SETS Version 1
  7.  
  8. INDEX
  9.  
  10. -1-  DISCLAIMER
  11.  
  12. -2-  INSTRUCTIONS
  13.      -2.1- Introduction
  14.          -2.1.1- Why use sets.exe?
  15.      -2.2- What sets.exe does.
  16.      -2.3- Getting Started
  17.      -2.4- timeadj.exe
  18.  
  19. -3-  TO DO LIST
  20.  
  21. -4-  SHAREWARE
  22.  
  23.                           -1-
  24.  
  25.                        DISCLAIMER
  26.                       ════════════
  27.  
  28.      ╔═════════════════════════════════════════════════════════════════╗
  29.      ║                                                                 ║
  30.      ║  I cannot make a warranty of any kind nor can I guarantee       ║
  31.      ║  that sets.exe and timeadj.exe are completely bug free.         ║
  32.      ║                                                                 ║
  33.      ║  You use sets.exe and timeadj.exe at your own risk.             ║
  34.      ║                                                                 ║
  35.      ║  You make the choice whether to use these program or not, so    ║
  36.      ║  by using the sets.exe and timeadj.exe programs you accept      ║
  37.      ║  full responsibility for their use.                             ║
  38.      ║                                                                 ║
  39.      ║  As I have no control over how you use sets.exe and timeadj.exe,║
  40.      ║  and because you use them at your own risk,                     ║
  41.      ║  I can accept no liability for any losses that may arise from   ║
  42.      ║  the use of sets.exe and/or timeadj.exe.                        ║
  43.      ║                                                                 ║
  44.      ╚═════════════════════════════════════════════════════════════════╝
  45.  
  46.  
  47.  
  48.                           -1-
  49.  
  50.                        INSTRUCTIONS
  51.                       ══════════════
  52.  
  53.  
  54. -2.1- Introduction
  55.  
  56.  
  57. My old computer has always lost about 8.3 seconds per day. I imagine that
  58. it must have something to do with one of the cards, or the tower itself, as
  59. I have used three motherboards in it.
  60.  
  61. To overcome this I wrote the original timeadj.exe in 1993.
  62.  
  63. I tried using timeadj.exe during startup but the delays made it inaccurate.
  64. I used a productivity program to schedule it for a while but I do not like
  65. alarm messages popping up when I am concentrating so I used the program
  66. manually for a few years.
  67.  
  68. Then I wrote the original to sets.exe so that I could start timeadj.exe
  69. every ten days and after the startup had finished.
  70.  
  71. Sets.exe comes in handy for a program that, if you place it in the
  72. startup folder, does not always start as minimised even though you
  73. intend it to be minimised.
  74.  
  75.  
  76. -2.1.1 Why use sets.exe?
  77.  
  78.  
  79. If you use a productivity program (utility or scheduler) you normally have
  80. to either set the start up of a program to a specific time on a
  81. specific day or a specific time weekly or daily. If your computer is up
  82. and running then the program is started but if your computer is off then
  83. the program has been skipped.
  84.  
  85. With this version of sets.exe you can schedule any program to start at
  86. startup, or a predetermined number of seconds after strartup, ranging
  87. from every startup  up to 3.37E+38 days (the max float value - not that
  88. anyone would be interested in waiting that long). The float value allows
  89. part days to be used e.g. 1.0417 is approximately 1 day + 1hour.
  90.  
  91.  
  92. You may not want a productivity program running in the background all
  93. the time. Sets.exe runs at startup only.
  94.  
  95.  
  96.  
  97.  
  98. -2.2- What sets.exe does.
  99.  
  100.  
  101. I have a shadow of sets.exe in the startup folder.
  102.  
  103. For each program in the file named setnames.dat.
  104. Sets.exe reads in the program to start data:
  105.  
  106.          program path + parameters
  107.          days between starting (a decimal not an integer)
  108.          seconds to delay before starting
  109.          parameters to pass to the start command
  110.  
  111. It then compares the number of days between starting to the difference
  112. between the time (in a file called settimes.dat) that the program
  113. was last started and the time sets.exe was started:
  114.  
  115.          If difference is greater than the days between starting
  116.          then the program is started and
  117.          and the time sets.exe started is substituted into settimes.dat
  118.  
  119. The program is then started using the start command through go.cmd
  120.  
  121.  
  122.  
  123. -2.3- Getting Started
  124.  
  125.  
  126. The setnames.dat file included contains the following:
  127.  
  128. TIMEADJ.CMD
  129. 10
  130. 30
  131. /MIN
  132.  
  133. When the program is started settimes.dat is automatically generated
  134. with the time sets.exe started used for this entry.
  135.  
  136. Explanation
  137.  
  138. TIMEADJ.CMD
  139.  
  140. I start timeadj.exe using TIMEADJ.CMD so that the session will
  141. automatically exit.
  142.  
  143. If a program is not in the current directory then use a complete path
  144. eg E:\UTILITY\TIMEADJ.CMD
  145.  
  146.  
  147. 10
  148.  
  149. Do the adjustment on the first startup after 10 days.
  150. Note this can be a decimal eg 10.2345
  151. Negative values for days are converted to 0.
  152.  
  153. 30
  154.  
  155. Wait 30 seconds before starting TIMEADJ.CMD. This is a lot longer than
  156. I need but I know that timeadj.exe will get a clear run.
  157. Negative values for seconds are converted to 0.
  158. Seconds are integer values (not decimal);
  159.  
  160.  
  161.  
  162. /MIN
  163.  
  164. You can put any of the start command parameters here
  165.  
  166. NOTE: The timeadj program will start minimised and requires you
  167.       to switch to it on the first start to enter data.
  168.       This can be avoided by starting timeadj.exe from the os2 command prompt
  169.       for its first use.
  170.  
  171. If you want to add another program just add the details
  172.  
  173. TIMEADJ.CMD
  174. 10
  175. 30
  176. /MIN
  177. E:\UTILITY\SOMEPROG.EXE
  178. 7
  179. 10
  180. /WIN /MAX
  181.  
  182. On the next starting of sets.exe the time sets.exe started
  183. will be placed in settimes.dat for this program.
  184.  
  185. While you add programs to the end a time will be automatically entered
  186. for the program on the next start up.
  187.  
  188. If a program is deleted then the settimes will need to be adjusted manually.
  189.  
  190. If a program is deleted from the end the extra time will be ignored until
  191. you add a new program. The time will be used for the new program.
  192.  
  193. If you remove a program from the middle and not the time then the wrong
  194. times will be used.
  195.  
  196.  
  197. -2.4- timeadj.exe
  198.  
  199.  
  200. On the first start of timeadj.exe it will prompt you for the adjustment.
  201. If your clock is loosing time then use a positive value and
  202. if it is gaining time use a negative value.
  203. It will not accept an adjustment value between -0.0001 and +0.0001
  204. (i.e. less than 1 second adjustment every 27.4 years).
  205. The data is stored in a file called time.dat in the current directory.
  206.  
  207. If you want to reset the delay then start timeadj.exe with any command
  208. line parameter.
  209.  
  210.  
  211.  
  212.                           -3-
  213.                        TO DO LIST
  214.                       ════════════
  215.  
  216. Make a PM interface to add and delete the programs and the times in
  217. the dat files.
  218.  
  219. Add an "after a spcific date and time" alternative.
  220.  
  221.  
  222.                           -4-
  223.                        SHAREWARE
  224.                       ═══════════
  225.  
  226. If you choose to try sets.exe and timeadj.exe and intend to continue
  227. using one, or both, then the shareware price is $15 Australian
  228. to the copyright owner:
  229.  
  230.                         R.McGuiness
  231.  
  232.                         51 Lord Street
  233.  
  234.                         Sandy Bay
  235.  
  236.                         Tasmania
  237.  
  238.                         Australia 7005
  239.  
  240.  
  241. Please send your name and address along with your payment so that
  242. you can be placed on a registered users list. If you register for one
  243. version of these programs then you are automatically registered for any
  244. future versions i.e. you can download future versions and and use them
  245. without registering again.
  246.  
  247. Please supply an email address as registered users will be sent
  248. a PM interface to add and delete the programs and the times in the
  249. dat files when I have finished programming it.
  250. (I estimate that it will be January 2000 before I have time to finish it.)
  251.  
  252.  
  253. If you want a receipt then you need to send a self addressed envelope
  254. with return postage.
  255.  
  256. This program is not disabled in any way.
  257.  
  258. If you find any bugs or constructive comments then the following email address
  259. should be valid until the end of 2000.
  260.  
  261. ramcg1@mugca.cc.monash.edu.au
  262.  
  263.