home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / utility / intvl175.zip / INTERVAL.DOC < prev    next >
Text File  |  1993-01-18  |  6KB  |  187 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.                                 GENERAL NOTICE
  13.  
  14.     This computer program is being distributed under the SHAREWARE concept.
  15.     This means that you are granted license to evaluate INTERVAL for a period
  16.     of THIRTY DAYS. Should you continue to use it beyond this time limit
  17.     registration IS required.
  18.  
  19.                              BENEFITS OF REGISTRATION
  20.  
  21.     Upon registration you will receive the current version of this program
  22.     with all of the annoying `NAG' features removed. The registered version
  23.     has a smaller code and runs considerably faster than the shareware
  24.     version. DO NOT PANIC!!! This is a very inexpensive program to register.
  25.     See the included file REGISTER.ME! for complete details on registration.
  26.  
  27.                                    WARRANTY
  28.  
  29.     The author makes absolutely no warranties on this software. This software
  30.     is not even warranted to take up space on your disk!!! USE THIS SOFTWARE
  31.     AT YOUR OWN RISK!!!! The author is not responsible for any damages what
  32.     so ever!!!!
  33.  
  34.  
  35.        INTERVAL.DOC    Copyright (C) 1993 by Samuel Kaplin     Page 1
  36.  
  37. -------------------------------------------------------------------------------
  38.  
  39.                                   PREFACE
  40.  
  41. INTERVAL is a DOS based program which will execute a DOS command or
  42. program once during a user defined period of time (measured in days).
  43. INTERVAL is not a TSR. It must be invoked from the command line or a
  44. batch file every time you wish to use it. INTERVAL has a number of command
  45. line options, each one must be defined before INTERVAL will run.
  46.  
  47. INTERVAL was initially created to run a time setting program. Because of
  48. this most of the manipulation of the time and date happens after the
  49. event is run. This is to ensure that the next scheduled event reflects
  50. the updated time and date. The date handling routines will compensate
  51. for just about any calendar oddity (leap years etc...) Even though
  52. INTERVAL was created for time setting programs, It works admirably with
  53. DOS commands and other programs.
  54.  
  55.  
  56.  
  57.        INTERVAL.DOC    Copyright (C) 1993 by Samuel Kaplin     Page 2
  58.  
  59. -------------------------------------------------------------------------------
  60.  
  61.                                THE COMMAND LINE
  62.  
  63.  INTERVAL d=[file] e=[y,n] a=[duration] i=[interval] l=[ne,nr,e,r] c=[command]
  64.  
  65.  EXAMPLE:
  66.  INTERVAL d=c:\date.fil l=ne e=y a=5 i=10 c=del c:\dl\*.zip
  67.  
  68.  This example will delete all files with the extension of `zip' once
  69.  every 10 days. It uses the file `c:\date.fil' to keep track of the last
  70.  time interval ran an event. INTERVAL is keeping logs only when an event
  71.  is run. The logs do not have a header on them. INTERVAL will give you 5
  72.  seconds to abort an event. Interval will also set an errorlevel upon
  73.  exiting.
  74.  
  75.                            COMMAND LINE PARAMETERS
  76.  
  77.              PLEASE NOTE THAT ALL OPTIONS MUST BE SPECIFIED!!!!
  78.  
  79.  
  80.  d= datefile to use.
  81.  
  82.  This option tells INTERVAL the datefile to use. If the datefile does
  83.  not exist INTERVAL will create it. The first line of the datefile
  84.  is the word `DATEFILE'. The second line is the date that the last event
  85.  was run.
  86.  
  87.  
  88.  
  89.  e= enable or disable setting errorlevel upon exiting.
  90.  
  91.  This feature is useful if INTERVAL is going to be used as part of a
  92.  batch file. The results are as follows.
  93.  
  94.       n = disabled
  95.       y = enabled
  96.         errorlevel = 1 if the event is run.
  97.         errorlevel = 2 if the event is not run
  98.         errorlevel = 3 if the event is aborted by the user.
  99.  
  100.  
  101.  
  102.  a= time delay in seconds for the user to abort an event.
  103.  
  104.     This feature is a value from 0 to 59 seconds. A value of 0 will give
  105.     the user no option to abort the event. A value of 59 will give the
  106.     user 59 seconds to abort the event. The first time INTERVAL is run
  107.     it will not allow you to abort.
  108.  
  109.  
  110.  
  111.  i= interval to run the event.
  112.  
  113.  This feature is a value from 1 to 10,000. This is how often that you
  114.  want interval to run the event. The value is specified in days.
  115.  
  116.  
  117.  
  118.        INTERVAL.DOC    Copyright (C) 1993 by Samuel Kaplin     Page 3
  119.  
  120. -------------------------------------------------------------------------------
  121.  
  122.  c= command to execute.
  123.  
  124.  This is the actual command that INTERVAL is to execute when it runs an
  125.  event.
  126.  
  127.  
  128.  
  129.  l= select log status.
  130.  
  131.  The log file will have the same filename as the datefile. The extension
  132.  will be LOG. As an example, if the datefile is named TIMESET.FIL the log
  133.  file will be called TIMESET.LOG. The log file will be in the same directory
  134.  as the datefile. The options which do not have a header on them were
  135.  included to facilitate merging log events from several different
  136.  logs into one master log. If you switch from an option with no header to an
  137.  option that has a header INTERVAL will not put a header on it. INTERVAL
  138.  only puts headers on new log files. The options are as follows.
  139.  
  140.       N  = no logs
  141.       R  = logs every time INTERVAL is run.
  142.       E  = logs only when an event is run.
  143.       NR = logs every time INTERVAL is run. No header on the log file.
  144.       NE = logs only when an event is run. No header on the log file.
  145.  
  146.  
  147.  
  148.  
  149. SMSnet
  150.                        REGISTRATION FOR INTERVAL 1.75
  151.  
  152. Please send payment to:
  153.                                Samuel Kaplin
  154.                         3520 West 32nd Street #214
  155.                         Minneapolis, MN 55416-4529
  156.  
  157.  
  158.  
  159.  
  160. NAME___________________________________PHONE_________________________________
  161.  
  162. ADDRESS______________________________________________________________________
  163.  
  164. CITY/STATE/ZIP/COUNTRY_______________________________________________________
  165.  
  166. [ ] Copies of INTERVAL              @  $10.00 per copy.
  167. [ ] Site licenses for INTERVAL      @  $60.00 per facility.
  168. [ ] Check here for a 3½ inch disk.  @  $ 1.00 per copy.
  169.  
  170. Canadian orders please add $2.00 shipping and handling.
  171. Foreign orders please add $10.00 shipping and handling.
  172.  
  173. All payments MUST be in United States dollars.
  174. All checks must be drawn on a United States bank.
  175.  
  176.  
  177. Payment by:   [ ] Check [ ] Money Order       TOTAL ENCLOSED________________
  178.  
  179.  
  180. WHERE DID YOU OBTAIN INTERVAL?_______________________________________________
  181.  
  182.  
  183.  
  184. COMMENTS:
  185.  
  186.  
  187.