home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / PROGRAMS / UTILS / HARDWARE / IZZIT.ZIP / IZZIT.DOC < prev   
Encoding:
Text File  |  1989-12-04  |  4.0 KB  |  109 lines
  1.                                     IzzIt
  2.  
  3.                                by Giff Kucsma
  4.  
  5.                                 Version 1.30
  6.  
  7.  
  8.                              General Information
  9.                              -------------------
  10.  
  11.           The program IZZIT.COM implements a number of tests, or
  12.           inquiries, the answers to which are always either yes or no.
  13.  
  14.           IZZIT.COM may be useful in a situation where it is desirable
  15.           to condition the invocation of selected steps in an application
  16.           depending upon certain environmental factors, such as the time,
  17.           date, day of week, or hardware configuration.
  18.  
  19.           Simply invoke IzzIt without any parameters to obtain a brief
  20.           definition of the syntax for its use.
  21.  
  22.           The program will return a code that can be evaluated in a
  23.           batch file as a DOS ERRORLEVEL code.
  24.  
  25.                 If the result of the inquiry is Yes, the program
  26.                  will return a 1.
  27.  
  28.                 If the result of the inquiry is No, the program
  29.                  will return a 0.
  30.  
  31.  
  32.           If the user invokes IzzIt with missing or invalid command
  33.           line parameters, the program will display appropriate advice,
  34.           pause for the striking of any key before terminating and,
  35.           upon termination, will return a 2.
  36.  
  37.           The requirement that a key be struck before the program
  38.           will continue is intended to provide an opportunity to
  39.           suspend continuation of a batch file that contains an
  40.           incorrectly constructed IzzIt command.
  41.  
  42.  
  43.                   Notes on Time/Date/DayOfWeek Evaluations
  44.                   ----------------------------------------
  45.  
  46.  
  47.           IzzIt implements testing for "between" conditions, such as:
  48.  
  49.                         IZZIT BETWEEN 17:00 22:00
  50.                         IZZIT BETWEEN 4/1/1987 4/15/1987
  51.                         IZZIT BETWEEN MONDAY WEDNESDAY
  52.  
  53.           Note that these "between" comparisons are "inclusive".
  54.           That is, a "yes" result will be returned if the current
  55.           time, date, or day of the week is equal to or greater
  56.           than the starting value, or equal to or less than the
  57.           ending value.
  58.  
  59.  
  60.           IzzIt also implements testing for "before" and "after"
  61.           conditions, such as:
  62.  
  63.                         IZZIT BEFORE 9:00
  64.                         IZZIT AFTER 3/31/1988
  65.                         IZZIT BEFORE FRIDAY
  66.  
  67.           Note that these "before" and "after" comparisons are
  68.           "exclusive".  That is, a "yes" result will be returned
  69.           only if the current time, date, or day of the week is
  70.           greater or less than the specified value.
  71.  
  72.  
  73.  
  74.                     Notes on Time/Date/DayOfWeek Scaling
  75.                     ------------------------------------
  76.  
  77.           In evaluating time, IzzIt uses 24 hour, or "military"
  78.           time notation.  In evaluating "between" time conditions,
  79.           IzzIt will adjust the specified beginning and ending time
  80.           values to acknowledge the "wrap" that occurs at midnight,
  81.           when the clock scale goes from 23:59 to 00:00.  Therefor,
  82.           it is permissible, and correct results will be returned,
  83.           if you specify:
  84.  
  85.                         IZZIT BETWEEN 21:00 04:00
  86.  
  87.  
  88.  
  89.  
  90.           In evaluating dates, IzzIt is capable of discerning, and
  91.           factoring into comparisons, leap years.
  92.  
  93.  
  94.  
  95.  
  96.  
  97.           In evaluating days of the week, IzzIt considers Monday to
  98.           be the first day of a week.  Unlike time values, no "wrap"
  99.           is acknowledged between Sunday and Monday.  Consequently,
  100.           it can never be "after" Sunday, nor can it ever be
  101.           "before" Monday.  Also, specifying:
  102.  
  103.                       IZZIT BETWEEN SUNDAY TUESDAY
  104.  
  105.           will result in an error message indicating that the
  106.           starting day (SUNDAY) is greater than the ending day
  107.           (TUESDAY).
  108.  
  109.