home *** CD-ROM | disk | FTP | other *** search
/ ftp.update.uu.se / ftp.update.uu.se.2014.03.zip / ftp.update.uu.se / pub / rainbow / msdos / misc2 / rbclock.lzh / RBCLK.DOC < prev   
Text File  |  1985-10-04  |  9KB  |  250 lines
  1.  
  2.          # #       # ####    ######
  3.         # # #     # #              #      646-1 University Avenue
  4.        #   # #   #   #######       #        Rochester, New York
  5.       #     # # #           #      #            14607-1232
  6.      #       # #        #### ######           (716)-461-2446
  7.  
  8.         AV Software Designs, Ltd.            October  4, 1985
  9.  
  10.  
  11.  
  12.  
  13.                    DEC Rainbow Archive Package # 3
  14.  
  15.  
  16.      Package Title -
  17.                      DEC Rainbow 100/190 Workstation Clock
  18.  
  19.      Version    -    1.1(13)
  20.  
  21.      System     -    DEC Rainbow 100/A/B/+/190
  22.                      MS-DOS Version 2.11+
  23.  
  24.      Language   -    TurboPascal Version 3.01A
  25.  
  26.      Author     -    Alan I. Vymetalik for
  27.                      AV Software Designs, Ltd.
  28.  
  29.      All doucmentation, sources, and programs -
  30.  
  31.           Copyright (c) 1985 by AV Software Designs, Ltd.
  32.  
  33.  
  34.  
  35.  
  36.                  COPYRIGHT, WARRANTY, AND DISCLAIMERS
  37.  
  38.  
  39.           Any material included in this package may be used for
  40.      whatever application desired.  However,  no documentation,
  41.      sources, or programs created AV Software Designs, Ltd. may
  42.      be sold or otherwise included, in whole or part, in  other
  43.      software  being sold.  Licensing arrangements can by  made
  44.      through the above address.
  45.  
  46.  
  47.           Special exception is made  for any  sources that this
  48.      package contains.  The source routines may be used in  any
  49.      manner the user wishes.  The user is encouraged to include
  50.      the routines in his software to better the quality  of the
  51.      software and thereby the quality in public domain circula-
  52.      tion.  Appropriate references are appreciated.
  53.  
  54.  
  55.           Since  these materials are being released  under  the
  56.      FreeWare concept,  any  user  of this software may  freely
  57.      donate money, ideas, and comparable routines in return for
  58.      using this software if the user has felt he has benefitted
  59.      or learned something from this software.  Funds and  ideas
  60.      will go a long way in helping the author develop new soft-
  61.      ware and to maintain this and other packages.  Address all
  62.      inquires and communications to the above address.
  63.  
  64.  
  65.           Warranties and Guarantees - None!  Though  these pro-
  66.      grams have been tested as thoroughly as possible,  neither
  67.      the  author nor AV Software Designs, Ltd.  assumes  nor is
  68.      responsible  for any  damage occuring  to any  hardware or
  69.      software of the user nor  for any  typographical or  logic
  70.      errors that may occur.  This package and its contents  are
  71.      subject  to modification  without prior notice and no com-
  72.      mitment of any kind is stated or to be inferred.
  73.  
  74.  
  75.  
  76.  
  77.                 CLOCK V1.1 BACKGROUND AND INFORMATION
  78.  
  79.  
  80.           CLOCK Version 1.1 is an updated version of the origi-
  81.      nal CLOCK Version 1.0 (by the same author)  which attempts
  82.      to turn the DEC Rainbow into something more  than an over-
  83.      weight doorstop.  CLOCK Version 1.1 utilizies many  of the
  84.      enhanced Rainbow features such as highspeed video updating
  85.      and  was written in TurboPascal V3.01A under MS-DOS V2.11.
  86.      If the demand is overwhelming, CLOCK will be released  for
  87.      other systems.
  88.  
  89.  
  90.           Many of you are wondering why you need  another clock
  91.      display on the Rainbow!  Well, we're hoping that this will
  92.      be the only and last one you'll ever need.   Check out the
  93.      features below and we think you'll see why.
  94.  
  95.  
  96.  
  97.  
  98.               CLOCK V1.1 FUNCTIONS AND OPERATING GUIDE
  99.  
  100.  
  101.           In its current incarnation,  CLOCK V1.1 allows you to
  102.      program an alarm for a particular time AND date (yes,  you
  103.      could leave your system on for a month!, a year!)  and the
  104.      ability to change the system time and date to whatever you
  105.      want.  Thus, this program could be used to replace the MS-
  106.      DOS DATE and TIME functions.  You  have the choice of menu
  107.      driven operation or command-line operation.
  108.  
  109.  
  110.  
  111.                             COMMANDS
  112.  
  113.  
  114.           T  -  Set system TIME in the following format:
  115.  
  116.                             HH MM SS
  117.  
  118.                 where HH is a 2-digit number for the hour
  119.                       MM is a 2-digit number for the minutes
  120.                       SS is a 2-digit number for the seconds
  121.  
  122.  
  123.           D  -  Set system DATE in the following format:
  124.  
  125.                            MM DD YYYY
  126.  
  127.                 where MM is a 2-digit number for the month
  128.                       DD is a 2-digit number for the day
  129.                       YYYY is a 4-digit number for the year
  130.  
  131.  
  132.           A  -  Set alarm TIME and DATE in the following format
  133.                 after setting the alarm ACTIVE or DEACTIVE.
  134.  
  135.                          Time HH MM SS
  136.  
  137.                               and
  138.  
  139.                         Date MM DD YYYY
  140.  
  141.                 Where the abbreviations are as above.  The col-
  142.                 ons in the clock display  will flash signifying
  143.                 that the alarm is active.   Hitting a  <RETURN>
  144.                 for the alarm date will set the  alarm  for the
  145.                 current day.  There is no hundreths setting  on
  146.                 the  alarm.  That's  a bit too much to ask for!
  147.                 Hitting any key will abort the alarm.
  148.  
  149.  
  150.           C  -  Start CLOCK
  151.  
  152.                 This will start the clock up with whatever date
  153.                 and  time and  alarm settings  have  been made.
  154.                 Hitting any key will return you to the menu.
  155.  
  156.  
  157.           E  -  EXIT to MS-DOS
  158.  
  159.                 This will put away the clock and return to DOS.
  160.  
  161.  
  162.  
  163.  
  164.                        COMMAND LINE SWITCHES
  165.  
  166.  
  167.           The following switches maybe used to send information
  168.      to CLOCK.  The format for calling CLOCK is:
  169.  
  170.  
  171.                           RBCLK [-/][cdt]
  172.  
  173.  
  174.           where the switch bars are either '-' or '/'
  175.  
  176.           where the parameters are:
  177.  
  178.                'c' - start the clock with the current
  179.                      settings for the time and date
  180.                'd' - start in the set Date frame
  181.                't' - start in the set Time frame
  182.  
  183.  
  184.           Entering an illegal command or a null parameter  will
  185.      result in  CLOCK stopping.  Common  sense will explain why
  186.      the 'A' and 'E' commands are not allowed as switches.
  187.  
  188.           Note:  CLOCK's binary file is called RBCLK.COM.  This
  189.      is done to prevent conflict with MS-DOS's device CLOCK.
  190.  
  191.  
  192.  
  193.  
  194.                         NOTES AND COMMENTS
  195.  
  196.  
  197.           Please follow the above formats!   They were designed
  198.      to be the easiest  way of communicating settings to CLOCK.
  199.      Where you see a blank, like between HH MM,  place  a blank
  200.      between  rather  than any other  separator.   You  can try
  201.      others, they won't work.  If you think you forgot the for-
  202.      mat, a display will be shown for the format along with the
  203.      current settings when you change the time or date.  In the
  204.      next release we will be including incremental stepping via
  205.      the cursor keys; we're trying to keep the code size down!
  206.  
  207.  
  208.           All time settings are in 24-hour time. This will help
  209.      in not having to put in an AM or PM setting.
  210.  
  211.  
  212.           Errors in settings or attempting new formats will re-
  213.      sult in the beeper going off and lights flashing!
  214.  
  215.  
  216.           There is as much error checking done as  possible  so
  217.      it is highly unlikely that  you will  be  able to blow the
  218.      clock up.  If you find any bugs, please pass them along to
  219.      the  above address so  we can either correct them or docu-
  220.      ment them for release 1.2.  The  only currently know 'bug'
  221.      involves the use of redirected input  to CLOCK via the MS-
  222.      DOS '<' syntax.  The disadvantage lies in that possibility
  223.      exists of hanging your  system.  This,  hopefully, will be
  224.      prevented in Version 1.2.
  225.  
  226.  
  227.           Release 1.2  has  already had  some comment.  Planned
  228.      features include two different display sizes,  a  reminder
  229.      message window with a quieter alarm, a snooze control,  an
  230.      AM/PM format setting,  and maybe  even an AM/FM radio dis-
  231.      play (just  for a little fun!).  There's even talk of mak-
  232.      ing CLOCK V1.2 a process daemon splitting the display into
  233.      scrolling  regions.  There  will definitely be  cursor in-
  234.      crementing in V1.2.  We'll  add  these  and  as many other
  235.      features as possible.
  236.  
  237.  
  238.  
  239.      Have fun and remember this:
  240.  
  241.      The best software available is public domain software!
  242.  
  243.  
  244.  
  245.      The DEC Rainbow 100/190 Workstation Clock Version 1.1(13)
  246.      Copyright (c) 1985 by AV Software Designs, Ltd.
  247.  
  248.  
  249.                 DEC Rainbow Archive Package # 3
  250.