home *** CD-ROM | disk | FTP | other *** search
/ Share Gallery 1 / share_gal_1.zip / share_gal_1 / UT / UT150.ZIP / PCCLOCK.DOC next >
Text File  |  1991-04-30  |  25KB  |  471 lines
  1.                       PCCLOCK DIGITAL CLOCK USER'S GUIDE
  2.  
  3.                                  Version 2.14b
  4.  
  5.  
  6. Introduction
  7. ------------
  8.  
  9. * PCCLOCK sets your computer's date and time quickly, conveniently, and 
  10.   automatically via modem - it calls the National Institute of Standards and 
  11.   Technology's atomic clock in Boulder, Colorado.
  12.  
  13. * PCCLOCK is a also a full-featured digital clock program that displays the 
  14.   date and time in big digits in your choice of 80 colorful designs supplied 
  15.   with the program plus up to 20 designs you create yourself.
  16.  
  17. * Useful as well as fun to watch, PCCLOCK includes manual as well as automatic 
  18.   setting, seconds display, 12- and 24-hour modes, an alarm, and an optional 
  19.   Big Ben hourly chime.
  20.  
  21. * Add "PCCLOCK" (or "PCCLOCK AUTO") to your AUTOEXEC.BAT file to check the date 
  22.   and time (or set them to the NIST atomic clock) whenever you restart your PC.
  23.  
  24. * Run PCCLOCK whenever you need to set your computer's clock, or run it just to 
  25.   pass the time whenever you and your computer are not otherwise engaged.
  26.  
  27. * PCCLOCK requires a CGA, EGA, VGA, MCGA, or compatible color display.  A 
  28.   compatible 1200-bps modem is required for automatic timesetting.
  29.  
  30.  
  31. Operation
  32. ---------
  33.  
  34. Pressing the <F1> key alternately displays and erases a list of functions at 
  35. the bottom of the screen.  Functions are selected by pressing <F2>-<F10>; these 
  36. keys are active whether or not the list of functions is displayed.  When a 
  37. function is selected, instructions are displayed if further input is required.
  38.  
  39. When no other function is selected, the <Page Up>, <Page Down>, <Home>, <End>, 
  40. <Ctrl-R>, and left and right arrow keys can be used to select a clock design 
  41. just as though <F2> (Select Design) had been pressed. 
  42.  
  43. Pressing the <Esc> key when no function is selected causes the program to exit.
  44.  
  45. PCCLOCK can also be run in a non-interactive automatic timesetting mode.  If 
  46. the "AUTO" command-line option is specified, PCCLOCK calls the NIST atomic 
  47. clock, sets the date and time, and exits.  A "PCCLOCK AUTO" command can be 
  48. given at the DOS prompt or in AUTOEXEC.BAT or another batch file.
  49.  
  50.  
  51. Clock Designs
  52. -------------
  53.  
  54. The date and time are displayed using specified characters from the IBM 
  55. extended character set.  One extended character, called "Mark Char", is used to 
  56. form the big digits.  Another extended character, called "Space Char", is used 
  57. to form the surrounding box.  Separate foreground and background colors can be 
  58. specified for both extended characters.  Thus, six parameters specify a 
  59. complete design.
  60.  
  61. The clock designs are organized into five pages of 20 designs each.  Four pages 
  62. are filled with the 80 designs supplied with the program.  The fifth page is 
  63. initially blank and may be used to store up to 20 of your own designs.
  64.  
  65. When PCCLOCK is started, it either chooses a design at random or uses a 
  66. specified default design.  To select another design or to select either a 
  67. random design or a specific design as the default, press <F2> (Select Design), 
  68. and follow the displayed instructions.
  69.  
  70. To create a design of your own or to modify any of the 100 designs, first 
  71. select the design you wish to modify, then press <F3> (Modify Design).  Follow 
  72. the displayed instructions to change any or all of the design's six parameters.
  73.  
  74. The Select Design and Modify Design functions also have options to erase a 
  75. design and to restore a design's parameters to either their original values or 
  76. to the values saved during a previous run of the program.
  77.  
  78.  
  79. Setting Date and Time
  80. ---------------------
  81.  
  82. If you have a compatible 1200-bps modem, PCCLOCK can set your computer's date 
  83. and time by calling the atomic clock at the National Institute of Standards and 
  84. Technology (NIST, formerly NBS, National Bureau of Standards) in Boulder, 
  85. Colorado.  The call usually takes only a few seconds (always less than a 
  86. minute) and costs very little (13 to 24 cents from Boston with AT&T).
  87.  
  88. Before you use PCCLOCK's modem timesetting function, you should review and may 
  89. need to modify its modem timesetting configuration parameters.  Refer to 
  90. "Configuration" below for details.
  91.  
  92. To set the date and time by modem, run PCCLOCK and press <Ctrl-S>, or run 
  93. PCCLOCK with the "AUTO" command-line option.  Commands sent to your modem by 
  94. PCCLOCK, result codes returned by your modem, and data received from NIST are 
  95. displayed in a window at the top of your screen.
  96.  
  97. If the call is successfully placed and valid data is received from NIST, both 
  98. the date and time are set, the call is terminated, and the window is closed.  
  99. The date and time are adjusted for the time zone specified in your 
  100. configuration.  If Daylight Saving Time is observed in your area (as specified 
  101. in your configuration) and Daylight Saving Time is in effect (as determined 
  102. from the data from NIST), the time (and possibly the date) are adjusted 
  103. accordingly.
  104.  
  105. If the call is not successfully placed, a modem result code (e.g., "BUSY") will 
  106. be displayed.  Press <Esc> to cancel the call, and, if you wish, press <Ctrl-S> 
  107. to try again.
  108.  
  109. If the data received from NIST is not valid (e.g., because of a noisy line), an 
  110. error message will be displayed, and PCCLOCK will remain on-line until it 
  111. receives valid data, until a timeout period of 90 seconds is exceeded, or until 
  112. you press <Esc> to cancel the call.
  113.  
  114. When PCCLOCK is run with the "AUTO" option, it displays a message indicating 
  115. the success or failure of the call to NIST.  If the date and time are not set 
  116. successfully, PCCLOCK creates a file named "PCCLOCK.ERR" in the default 
  117. directory.  If the date and time are set successfully, it deletes this file.  
  118. In a batch file, the command "IF EXIST PCCLOCK.ERR . . ." can therefore be used 
  119. to determine the outcome of a preceding "PCCLOCK AUTO" command.
  120.  
  121. To set the date or time manually, press either <F7> (Set Date) or <F8> (Set 
  122. Time), and follow the displayed instructions.
  123.  
  124.  
  125. All About Your Computer's Clock(s)
  126. ----------------------------------
  127.  
  128. DOS maintains a "system date" and "system time", which can be read and set with 
  129. the DOS DATE and TIME commands.  The system date and time settings are lost 
  130. whenever your computer is powered off and must be reset each time the computer 
  131. is restarted.
  132.  
  133. Many computers have a battery-operated "permanent clock" that keeps the date 
  134. and time when the computer is turned off.  IBM PC AT, AT-compatible, and newer 
  135. computers have these clocks built-in.  Other computers may be equipped with an 
  136. add-on clock that plugs into an expansion slot or with a "slotless" clock that 
  137. plugs into a socket under a ROM chip or other socketed chip on the computer's 
  138. motherboard.
  139.  
  140. If your computer has no permanent clock, you need to set the date and time 
  141. every time you restart your computer.  You can make this less tedious by 
  142. running PCCLOCK from your AUTOEXEC.BAT file and using either its automatic or 
  143. manual timesetting functions.
  144.  
  145. If your computer does have a permanent clock, the system date and time are set 
  146. from the permanent clock when the system is restarted.  With a built-in clock, 
  147. this is done automatically.  With an add-on or slotless clock, you may need to 
  148. run a program from AUTOEXEC.BAT; refer to the documentation supplied with the 
  149. clock.  If you also run PCCLOCK from AUTOEXEC.BAT, PCCLOCK should, of course, 
  150. be run following this program.
  151.  
  152. If your computer has a built-in permanent clock, setting the date and/or time 
  153. with PCCLOCK will set the permanent clock as well as the system date and time, 
  154. regardless of the version of DOS you are using.  (Prior to DOS version 3.3, the 
  155. DOS DATE and TIME commands set only the system date and time, not the permanent 
  156. clock.)
  157.  
  158. Some add-on and slotless permanent clocks come with a device driver that sets 
  159. the permanent clock whenever the system date or time is set.  If you have such 
  160. a device driver installed, setting the date or time with PCCLOCK will also set 
  161. the permanent clock.  If not, after setting the system date and/or time with 
  162. PCCLOCK, you will need to run the program supplied with your clock to set it as 
  163. well.
  164.  
  165.  
  166. Configuration
  167. -------------
  168.  
  169. To review or modify PCCLOCK's modem timesetting parameters, press <Ctrl-C>, and 
  170. follow the displayed instructions.
  171.  
  172. +---------------+---------------------+---------------------------------------+
  173. | Parameter     | Default Value       | Possible Values                       |
  174. |===============+=====================+=======================================|
  175. | Serial Port   | COM1                | COM1, COM2, COM3, COM4                |
  176. |---------------+---------------------+---------------------------------------|
  177. | Init          | ATZ|~~ATE1M2QV1|~~  | See below.                            |
  178. |---------------+---------------------+---------------------------------------|
  179. | Dial          | ATDT1-303-494-4774| | See below.                            |
  180. |---------------+---------------------+---------------------------------------|
  181. | Hang Up       | ~~+++~~ATH|         | See below.                            |
  182. |---------------+---------------------+---------------------------------------|
  183. | Time Zone     | Eastern             | Universal, Atlantic, Eastern,         |
  184. |               |                     | Central, Mountain, Pacific, Yukon,    |
  185. |               |                     | Alaska-Hawaii, Bering                 |
  186. |---------------+---------------------+---------------------------------------|
  187. | DST Observed  | Yes                 | Yes, No                               |
  188. |---------------+---------------------+---------------------------------------|
  189. | DST in Effect | See below.          | Yes, No                               |
  190. +---------------+---------------------+---------------------------------------+
  191.  
  192. "Serial Port" specifies the port to which your modem is connected.  PCCLOCK 
  193. displays the I/O address it has determined for the port in parentheses after 
  194. "COMn".  If this address is not that for which your port is configured (your 
  195. modem is connected to COM3 or COM4, the port is not at the standard address of 
  196. 3E8h for COM3 or 2E8h for COM4, and your computer's BIOS recognizes only 2 
  197. ports), you will need to run a separate utility program to update the address 
  198. of the port before your modem can be used by PCCLOCK.  One suitable utility is 
  199. Port Finder, a shareware program that can be downloaded from CompuServe and 
  200. many BBSs.  On CompuServe, Port Finder is currently available as PF253.ZIP in 
  201. IBMCOM forum library 7.  Contact the author for assistance if required.
  202.  
  203. "Init" specifies the commands needed to initialize your modem.  "|" indicates a 
  204. carriage return character; "~" indicates a one-second delay.
  205.  
  206. "Dial" specifies the modem commands needed to dial NIST.  "|" and "~" have the 
  207. same meaning as for the "Init" parameter.  The telephone number for the NIST 
  208. atomic clock (1-303-494-4774) appears in this parameter.  If you are calling 
  209. from the 303 area code (northern and western Colorado), you will need to delete 
  210. the "303".  If you are calling from the Denver area, you may also need to 
  211. delete the "1".  If you do not have tone dialing (Touch Tone service), change 
  212. "ATDT" to "ATDP" to use pulse dialing.
  213.  
  214. "Hang Up" specifies the commands needed to place your modem "on hook" when 
  215. valid data is received from NIST or when you cancel the call by pressing <Esc>.  
  216. "|" and "~" have the same meaning as for the "Init" parameter.
  217.  
  218. The values shown for "Init", "Dial", and "Hang Up" should work for most Hayes-
  219. compatible modems.  If they do not work with your modem, consult your modem 
  220. documentation, or contact the author for assistance if required.
  221.  
  222. The "Init", "Dial", and "Hang Up" parameters can be edited using the left and 
  223. right arrow keys and the <Backspace>, <Insert>, <Delete>, <Home>, and <End> 
  224. keys.
  225.  
  226. "Time Zone" specifies an adjustment for your location to the "universal" time 
  227. (also known as UTC, GMT, or Zulu time) supplied by NIST.  A value of 
  228. "Universal" specifies no adjustment.
  229.  
  230. "DST Observed" specifies whether or not Daylight Saving Time is observed in 
  231. your location.
  232.  
  233. "DST in Effect" indicates whether or not Daylight Saving Time is currently in 
  234. effect.  If "DST Observed" is "Yes" and "Time Zone" is not "Universal", PCCLOCK 
  235. sets "DST in Effect" each time NIST is called.  This parameter is set 
  236. automatically and cannot be modified by the user.
  237.  
  238.  
  239. Polled Serial I/O Option
  240. ------------------------
  241.  
  242. A few PCCLOCK users have reported that the interrupt-driven serial I/O 
  243. mechanism built into the programming language in which PCCLOCK is written does 
  244. not work properly with their modems.  In the reported cases, the modems were 
  245. connected to COM3 or COM4, and attempting to set the date and time by modem 
  246. caused PCCLOCK to lock up.  Therefore, PCCLOCK now includes an alternative 
  247. polled serial I/O mechanism.  If PCCLOCK does not work with your modem, please 
  248. try both interrupt-driven and polled serial I/O.  To switch between the two 
  249. mechanisms, press <Ctrl-Alt-S>.  If neither mechanism works properly, please 
  250. contact the author for assistance.
  251.  
  252.  
  253. PCCLOCK.DAT
  254. -----------
  255.  
  256. PCCLOCK uses the file PCCLOCK.DAT to save configuration parameters, any 
  257. modified clock designs, and settings for 12/24-hour mode, date/time display, 
  258. chime on/off, alarm time, and alarm on/off.
  259.  
  260. PCCLOCK.DAT will be created when PCCLOCK is first run and whenever it is not 
  261. found by PCCLOCK.  With DOS versions 3.0 and later, PCCLOCK.DAT is placed in 
  262. the same directory as PCCLOCK.EXE.  With earlier DOS versions, PCCLOCK.DAT is 
  263. placed in the current directory.
  264.  
  265.  
  266. Error Messages
  267. --------------
  268.  
  269. The following two messages may be displayed in the window at the top of the 
  270. screen during modem timesetting operations:
  271.  
  272.   Invalid data received - Retrying . . .
  273.  
  274.   The preceding NIST data string was not in the correct format, and PCCLOCK is 
  275.   staying on-line until another data string is received.  Usually due to a 
  276.   noisy phone connection.
  277.  
  278.   Serial I/O error n
  279.  
  280.   PCCLOCK was unable to successfully communicate with your modem.  Possible 
  281.   causes:  PCCLOCK is configured for the wrong port, or power to the modem was 
  282.   off.  Verify that your modem is operating correctly with your other software, 
  283.   then contact the author for assistance if required.
  284.  
  285. The following two messages may be displayed at the DOS command level:
  286.  
  287.   Error:  Date and time not set
  288.  
  289.   PCCLOCK was run with the "AUTO" option but did not set your PC's 
  290.   clock/calendar.  Possible causes:  The call to NIST could not be placed due 
  291.   to a "NO ANSWER" or "BUSY" status, a valid data string was not received 
  292.   within the 90-second timeout period, or the call was cancelled by pressing 
  293.   the <Esc> key.
  294.  
  295.   Invalid video mode - PCCLOCK aborted
  296.  
  297.   The computer's display is not CGA, EGA, VGA, MCGA, or compatible, or was not 
  298.   set for 80-column by 25-line operation.
  299.  
  300.  
  301. Shareware Notice
  302. ----------------
  303.  
  304. PCCLOCK is copyrighted software distributed as shareware.  It may not be sold 
  305. without the written permission of the author.  However, you are welcome to use 
  306. a single copy of PCCLOCK on a 30-day free trial basis.  If you find PCCLOCK to 
  307. be useful or enjoyable or continue to use it beyond the trial period, you are 
  308. requested to register your copy and pay a one-time fee of $10 to support its 
  309. development.
  310.  
  311. As a registered user, you will receive a printed user's guide plus a copy of 
  312. the latest version of PCCLOCK on diskette, you will be entitled to use all 
  313. future versions of PCCLOCK at no additional charge and without reregistering, 
  314. and you will be notified by mail or electronic mail of each major upgrade of 
  315. PCCLOCK.  Registered users have the right to use a single copy of PCCLOCK and 
  316. may register additional copies or purchase pre-registered copies on diskette.
  317.  
  318. You are permitted to make multiple copies of PCCLOCK for use within a single 
  319. business or organization only if you register and pay for each copy that is 
  320. used beyond a 30-day free trial period.  Alternatively, you may purchase 
  321. additional pre-registered copies of PCCLOCK from the author.
  322.  
  323. Shareware disk vendors, user groups, computer clubs, computer stores, bulletin 
  324. board systems, and individuals are permitted to copy and distribute PCCLOCK for 
  325. others to use on the same 30-day free trial basis, provided that the program is 
  326. unmodified and is accompanied by its user's guide, except that disk vendors not 
  327. currently approved by the Association for Shareware Professionals (ASP) must 
  328. first obtain written permission from the author.  A reasonable fee may be 
  329. charged for media, copying, and shipping and handling or for transmission time.
  330.  
  331.  
  332. How to Register
  333. ---------------
  334.  
  335. To become a registered PCCLOCK user, run PCCLOCK, press <Esc> to exit, and 
  336. follow the displayed instructions to complete and print a registration form.  
  337. If a printer is not available, simply send your name and address together with 
  338. your check or money order to M. J. Sadaway, Box 128-P, South Walpole, MA 02071.  
  339. Please specify diskette size (5.25" or 3.5").
  340.  
  341.  
  342. Bypassing the Registration Reminder Screen
  343. ------------------------------------------
  344.  
  345. Registered users may bypass the registration reminder screen normally displayed 
  346. when PCCLOCK is exited.  Instructions for bypassing the screen are given in the 
  347. printed user's guide sent to registered users.
  348.  
  349.  
  350. Feedback
  351. --------
  352.  
  353. Your questions, comments, criticisms, and suggestions concerning PCCLOCK are 
  354. welcome.  Please send them to M. J. Sadaway, Box 128-P, South Walpole, MA 02071 
  355. or via CompuServe mail to [75046,2272].  Thank you.
  356.  
  357.  
  358. Support Policy
  359. --------------
  360.  
  361. Registered users of PCCLOCK are entitled to support at no additional cost for a 
  362. period of three months from the date of registration.  Within this time, the 
  363. author, when contacted by mail or CompuServe mail, will answer the user's 
  364. questions concerning the use of PCCLOCK and will attempt to correct any problem 
  365. reported by the user that causes PCCLOCK to fail to perform in the manner 
  366. described in the user's guide.  If a reported problem is due to the user's 
  367. specific hardware configuration or software environment rather than an error in 
  368. PCCLOCK, or the problem cannot otherwise by corrected by the author, the user 
  369. may request and will receive a full refund of the registration fee.
  370.  
  371.  
  372. Shareware and the ASP
  373. ---------------------
  374.  
  375. Shareware is software you can try before you buy.  You are permitted to use it, 
  376. and you are generally free to copy it for others to use, on a trial basis.  If 
  377. you find it to your liking and continue to use it, you are expected to pay for 
  378. it.  Payment is in the form of a registration fee, which entitles you to 
  379. continue to use the software, and may entitle you to other benefits.  The 
  380. length of the trial period and any restrictions on copying and distribution of 
  381. the software vary depending on the author and program.
  382.  
  383. Shareware is generally of the same high quality as other software.  Plus it has 
  384. the ultimate money-back guarantee - if you don't use it, you don't pay for it.
  385.  
  386. The ASP, or Association of Shareware Professionals, is an organization of 
  387. shareware authors and distributors that promotes the shareware concept.  ASP 
  388. members are required to abide by established standards of professionalism.  The 
  389. ASP name and logo are your assurances that an author or distributor meets these 
  390. standards.
  391.  
  392. Shareware bearing the ASP name is fully functional, not a stripped-down or demo 
  393. version, and all features of the program are described in the documentation, so 
  394. that you can fully evaluate the product before you pay for it.  All ASP 
  395. shareware includes support by the author for a minimum of three months after 
  396. user registration, and authors are required to fully refund registration fees 
  397. to users reporting problems during this period if the problems cannot be 
  398. resolved.  The ASP also helps resolve disputes between shareware users and 
  399. authors or distributors.
  400.  
  401. Look for the ASP name when choosing shareware.  And help ensure the 
  402. availability of quality software at reasonable prices by registering the 
  403. shareware programs you use.
  404.  
  405.  
  406. Revision History
  407. ----------------
  408.  
  409. +---------+------+------------------------------------------------------------+
  410. | Date    | Ver. | Summary                                                    |
  411. |=========+======+============================================================|
  412. | 1/01/91 | 1.0  | Initial release.                                           |
  413. |---------+------+------------------------------------------------------------|
  414. | 2/05/91 | 2.0  | Added timesetting by modem.                                |
  415. |---------+------+------------------------------------------------------------|
  416. | 2/16/91 | 2.01 | Changed to ignore DSR and DCD signals to work with more    |
  417. |         |      | modems.                                                    |
  418. |---------+------+------------------------------------------------------------|
  419. | 3/03/91 | 2.04 | Corrected problems with accessing COM3 and COM4.           |
  420. |         |      | Improved validation of incoming data.                      |
  421. |---------+------+------------------------------------------------------------|
  422. | 4/07/91 | 2.10 | Added "AUTO" command-line option to call NIST and exit.    |
  423. |         |      | Added functions to designate default clock design.         |
  424. |         |      | Added functions to erase and restore clock designs.        |
  425. |         |      | Eliminated need to press <Enter> to save modified clock    |
  426. |         |      | designs.                                                   |
  427. |         |      | Eliminated need for Port Finder in all but unusual cases.  |
  428. |         |      | Separated modem initialization and dial commands.          |
  429. |         |      | Improved default modem initialization commands.            |
  430. |         |      | Corrected problem with "Universal" time zone.              |
  431. |         |      | Corrected error recognizing first day of DST.              |
  432. |---------+------+------------------------------------------------------------|
  433. | 4/09/91 | 2.11 | Made "DST in Effect" parameter display-only.               |
  434. |---------+------+------------------------------------------------------------|
  435. | 4/15/91 | 2.12 | Corrected problem with "AUTO" option.                      |
  436. |---------+------+------------------------------------------------------------|
  437. | 4/18/91 | 2.13 | Added option to suppress registration reminder screen.     |
  438. |         |      | (Available to registered users only.)                      |
  439. |---------+------+------------------------------------------------------------|
  440. | 4/30/91 | 2.14 | Added option to use polled rather than interrupt-driven    |
  441. |         |      | serial I/O.                                                |
  442. +---------+------+------------------------------------------------------------+
  443.  
  444.               _______ 
  445.          ____|__     |  (R)                     Copyright (c) 1991
  446.       --|       |    |------------------
  447.         |   ____|__  |  Association of          Michael J. Sadaway
  448.         |__|   o   |    Professionals           South Walpole, MA 02071
  449.       -----|   |   |--------------------
  450.            |___|___|    MEMBER                  CompuServe [75046,2272]
  451.  
  452. This program is produced by a member of the Association of Shareware 
  453. Professionals (ASP).  ASP wants to make sure that the shareware principle works 
  454. for you.  If you are unable to resolve a shareware-related problem with an ASP 
  455. member by contacting the member directly, ASP may be able to help.  The ASP 
  456. Ombudsman can help you resolve a dispute or problem with an ASP member, but 
  457. does not provide technical support for members' products.  Please write to the 
  458. ASP Ombudsman at 545 Grover Road, Muskegon, MI 49442, or send a message via 
  459. CompuServe Mail to ASP Ombudsman [70007,3536].
  460.  
  461.  
  462.                                   Disclaimer
  463.                                   ----------
  464.  
  465. The author disclaims all warranties, expressed or implied, including but not 
  466. limited to implied warranties of merchantability or fitness for a particular 
  467. purpose, with respect to PCCLOCK and the accompanying documentation.  In no 
  468. event shall the author be liable for any damages, direct or consequential, 
  469. arising out of the use of or inability to use this product, even if the author 
  470. has been advised of the possibility of such damages.
  471.