PCCLOCK DIGITAL CLOCK USER'S GUIDE Version 4.3 Copyright (c) 1991-1997 M. J. Sadaway. All rights reserved. Contents -------- Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 Getting Started . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 Basic Operation . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 Keyboard Functions . . . . . . . . . . . . . . . . . . . . . . . . . . 5 Command-Line Switches . . . . . . . . . . . . . . . . . . . . . . . . 6 Clock Designs . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 Setting Date and Time . . . . . . . . . . . . . . . . . . . . . . . 11 Statistics and Log File . . . . . . . . . . . . . . . . . . . . . . 13 Time Services . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 Common Problems and Solutions . . . . . . . . . . . . . . . . . . . 14 Error Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . 16 PCCLOCK Files . . . . . . . . . . . . . . . . . . . . . . . . . . . 19 Shareware Notice . . . . . . . . . . . . . . . . . . . . . . . . . . 20 How to Register . . . . . . . . . . . . . . . . . . . . . . . . . . 21 Bypassing the Registration Reminders . . . . . . . . . . . . . . . . 21 Support Policy . . . . . . . . . . . . . . . . . . . . . . . . . . . 22 Feedback . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22 Shareware and the ASP . . . . . . . . . . . . . . . . . . . . . . . 22 Keyboard Functions (Table 1) . . . . . . . . . . . . . . . . . . . . . 4 Command-Line Switches (Table 2) . . . . . . . . . . . . . . . . . . . 5 Configuration Parameters (Table 3) . . . . . . . . . . . . . . . . . . 8 Modem Dialing Commands (Table 4) . . . . . . . . . . . . . . . . . . 10 Exit Codes (Table 5) . . . . . . . . . . . . . . . . . . . . . . . . 12 Call Statistics (Table 6) . . . . . . . . . . . . . . . . . . . . . 13 Radio and Telephone Time Announcements (Table 7) . . . . . . . . . . 14 Files Installed or Modified by SETUP (Table 8) . . . . . . . . . . . 19 PCCLOCK File Descriptions (Table 9) . . . . . . . . . . . . . . . . 20 Introduction ------------ * PCCLOCK can set your PC's clock to the exact time by modem, by calling the NIST (National Institute of Standards and Technology) atomic clock in Boulder, Colorado; the USNO (U.S. Naval Observatory) atomic clock in Washington, D.C., or Colorado Springs, Colorado**; or the NRC (National Research Council) atomic clock in Ottawa or Toronto, Ontario. ____________________ ** At the time this version of PCCLOCK was released, the USNO Colorado Springs service was not yet modem-accessible. Page 1 * If you're a CompuServe member, PCCLOCK can also set your PC's clock to the nearest minute, by calling a CompuServe access number (usually a local call vs. long-distance for the atomic clocks). * PCCLOCK can display the date and time in big digits, in your choice of up to 80 designs supplied with the program or up to 20 designs you create yourself. * PCCLOCK can set your clock on request or can be run from AUTOEXEC.BAT to set your clock every n days or every time you restart your PC. * PCCLOCK can also be run to display the date and time whenever you and your computer are not otherwise engaged. * PCCLOCK also features manual setting, seconds display, 12- and 24-hour modes, alarm, optional ticking sound, and optional Big Ben chime. * PCCLOCK works with almost any modem** and runs under DOS (version 4.0 or later) or as a DOS application under Windows 95, Windows 3.1, or OS/2. Getting Started --------------- Although detailed instructions follow, you probably won't need (or want) to read all of them before using PCCLOCK. To use PCCLOCK now, run the SETUP program and follow the on-screen instructions. SETUP will copy the necessary files to your hard disk and install PCCLOCK to run under DOS, Windows, or OS/2. Next, run PCCLOCK, press or (Configure), and follow the on-screen instructions to configure the program for your modem and geographic location. To set the date and time, press or (Set by Modem). If you like, try the other function keys, press to exit PCCLOCK, then type "pcclock /?" at the DOS prompt to review the program's command-line switches. If you have problems, see "Common Problems and Solutions" below. Read further if you still have problems or questions. Review the rest of the user's guide if you want to be sure you're familiar with all of PCCLOCK's features. If you have problems or questions and can't find the answers here, whether you're just trying the program or you're a registered user, please let me know (see "Feedback"), and I'll be happy to help. ____________________ ** PCCLOCK does not work with software-based modems that depend on Windows device drivers, such as the U.S. Robotics Sportster WinModem and other manufacturers' modems using RPI (Rockwell Protocol Interface) technology. These modems generally work only with Windows applications and not with DOS applications like PCCLOCK. Page 2 Installation ------------ If you have a registered copy of PCCLOCK and an unregistered copy with the same version number is already installed on your system, it is not necessary to reinstall the program. If you have a registered copy of a newer version, follow these instructions to install it on your system. Then, in either case, mark PCCLOCK as registered by following the instructions under "Bypassing the Registration Reminders" below. To install PCCLOCK for the first time or to replace an earlier version of the program, run PCCLOCK's SETUP program, and follow the on-screen instructions. There are many ways to run SETUP, depending on which operating system (Windows 95, Windows 3.1, OS/2, or DOS) you're using: 1. Double-click PCCLOCK's SETUP.EXE file, using My Computer or Explorer in Windows 95, File Manager in Windows 3.1, or a drive object in OS/2. 2. Enter "a:setup", "b:setup", or ":\\setup", as appropriate, after selecting Run from the Start menu in Windows 95, after selecting Run from the File menu in Program Manager or File Manager in Windows 3.1, at an OS/2 command prompt, or at a DOS prompt. 3. Use Add/Remove Programs in Windows 95's Control Panel. SETUP selectively installs only those files appropriate to the operating system from which it is run, as described in "PCCLOCK Files". PCCLOCK uses file PCCLOCK.DAT to save configuration parameters, modified clock designs, current settings, and other data, and it uses file PCCLOCK.LOG to record the results of calls to time services. If these files are not present (e.g., when you first install PCCLOCK), PCCLOCK creates them in the directory from which PCCLOCK.EXE was run. If you've run a previous version of PCCLOCK on your system and you install this version in the same directory, it will automatically upgrade your existing PCCLOCK.DAT and PCCLOCK.LOG files and continue to use the existing configuration, clock designs, and other settings. If this version replaces a registered copy of a previous version in the same directory, it will also be marked as registered. If you install this version in a different directory, you will need to reconfigure the program; see "Configuration" below for instructions. If this version replaces a registered copy of a previous version in a different directory, you will need to mark the new version as registered; see the printed user's guide for the previous version for instructions. Although PCCLOCK can be run from a CD-ROM or write-protected diskette for trial use, it will be unable to create or update PCCLOCK.DAT and PCCLOCK.LOG, and it will display error messages to this effect. For normal operation, PCCLOCK should be installed on your hard disk. Page 3 Basic Operation --------------- Operating PCCLOCK is fairly straightforward. Most functions are selected by pressing the function keys, -, whose functions are normally displayed at the bottom of the screen. (On systems with 10 function keys, and are used instead of and .) Other functions are selected with command-line switches, whose functions can be displayed by using the "help" switch "/?" (the DOS command "pcclock /?"). +--------+--------+----------------------------------------------------+ | Key | Label | Description | |========+========+====================================================| | F1 | Menu | Alternately displays and erases a list of keys and | | | On/Off | associated functions at the bottom of the screen. | |--------+--------+----------------------------------------------------| | F2 | Change | Allows a clock design to be selected as the cur- | | | Design | rent design, and allows the modification of exist- | | | | ing designs and the creation of new designs. | |--------+--------+----------------------------------------------------| | F3 | 12/24 | Switches between 12- and 24-hour modes of time | | | Hour | display. | |--------+--------+----------------------------------------------------| | F4 | Date/ | Switches between display of time alone, date | | | Time | alone, and alternating date and time. | |--------+--------+----------------------------------------------------| | F5 | Chime | Alternately enables and disables chiming every | | | On/Off | quarter hour. | |--------+--------+----------------------------------------------------| | F6 | Tick | Alternately enables and disables ticking sounds | | | On/Off | that help synchronize clocks and watches to your | | | | computer's clock. | |--------+--------+----------------------------------------------------| | F7 | Set | Displays the current date, and allows a new date | | | Date | to be entered through the keyboard. | |--------+--------+----------------------------------------------------| | F8 | Set | Displays the current time, and allows a new time | | | Time | to be entered through the keyboard. | |--------+--------+----------------------------------------------------| | F9 | Set | Displays the current alarm setting, and allows a | | | Alarm | new alarm time to be entered. | |--------+--------+----------------------------------------------------| | F10 | Alarm | Alternately enables and disables the alarm from | | | On/Off | ringing at the set time. Also silences the alarm | | | | if ringing. | |--------+--------+----------------------------------------------------| | F11 or | Con- | Displays and allows modification of configuration | | Ctrl-C | figure | parameters used when calling time services. | |--------+--------+----------------------------------------------------| | F12 or | Set by | Sets date and time by calling the NIST, USNO, NRC, | | Ctrl-S | Modem | or CIS time services. | +--------+--------+----------------------------------------------------+ Table 1. Keyboard Functions Page 4 +----------+-----------+-----------------------------------------------+ | Switch | Alias | Function | |==========+===========+===============================================| | /A | AUTO | Sets clock by modem, then exits. | |----------+-----------+-----------------------------------------------| | /An | AUTO:n | Sets clock by modem if not set within n (1- | | | | 365) days, then exits. | |----------+-----------+-----------------------------------------------| | /Q, /Qn | QUICK, | Like /A and /An, except clock display and | | | QUICK:n | modem dialog not shown. | |----------+-----------+-----------------------------------------------| | /C | COLOR, | Configures to use 16 colors (for color | | | COLOUR | display). | |----------+-----------+-----------------------------------------------| | /G | GRAY, | Configures to use 4 gray levels (for gray- | | | GREY | scale display). | |----------+-----------+-----------------------------------------------| | /M | MONO | Configures to use black, white, and bright | | | | white only (for monochrome display). | |----------+-----------+-----------------------------------------------| | /Cn, | COLOR:n, | Configures for color, grayscale, or mono- | | /Gn, | COLOUR:n, | chrome display; selects clock design Cn (1- | | /Mn | GRAY:n, | 100), Gn (1-40), or Mn (1-20) as default. | | | GREY:n, | | | | MONO:n | | |----------+-----------+-----------------------------------------------| | /Fn | FKEYS:n | Configures to use n (10 or 12) function keys. | |----------+-----------+-----------------------------------------------| | /? or /H | HELP | Displays summary of command-line switches, | | | | then exits. (Any other switches are | | | | ignored.) | +----------+-----------+-----------------------------------------------+ Table 2. Command-Line Switches Notes: 1. The words in the "Alias" column may be used interchangeably with the single characters in the "Switch" column. 2. Either upper or lower case may be used. 3. Any switch (word or single character) may be preceded by "/", "-" or " ". 4. n may be preceded by ":" or "=". 5. The configuration switches (/C, /G, /M, and /F) need to be specified only once. The settings of these switches are saved in the configuration file, PCCLOCK.DAT. Keyboard Functions ------------------ To perform a function, press the associated key, -, , or , as shown in Table 1, then follow any on-screen Page 5 instructions. These keys are active whether the menu at the the bottom of the screen is on or off. Pressing the key cancels the selected function, displays the registration reminder screen, or exits PCCLOCK. When no other function is selected, PCCLOCK responds to the , , left and right arrow, and other keys as though (Change Design) had been pressed, except that instructions for selecting a design are not displayed. Command-Line Switches --------------------- The switches shown in Table 2 can be specified as part of the DOS command used to run PCCLOCK. The syntax of the switches is flexible, to accommodate the style you prefer. The commands "pcclock /A:7", "pcclock -a7", "pcclock A7", "pcclock auto:7", "PCCLOCK AUTO=7", and even "PCClock /Auto7" are equivalent. Please see "Setting Date and Time" for a full description of the /A (AUTO) and /Q (QUICK) switches. See "Configuration" for full descriptions of the /C, /G, /M, and /F (COLOR, COLOUR, GRAY, GREY, MONO, and FKEYS) switches. Clock Designs ------------- PCCLOCK displays the date and time using specified characters from the IBM extended character set. One extended character, called "Mark Char", is used to form the big digits. Another extended character, called "Space Char", is used to form the surrounding box. Separate foreground and background colors can be specified for both extended characters. Thus, six parameters specify a complete design. The clock designs are organized into pages of 20 designs each. When PCCLOCK is configured for a color display, five pages are available. Four pages are filled with 80 supplied designs. The fifth page is initially blank and may be used to store up to 20 of your own designs. For a grayscale display, two pages of designs are available. One page contains 20 supplied designs; the other is initially blank. For a monochrome display, only one page is available, with ten supplied designs and ten initially blank. When PCCLOCK is started, it uses either the current default clock design or chooses a clock design at random. When PCCLOCK is first installed, it is configured to use a specific default design. To select another specific default design or to select a random default design, press (Change Design), and follow the on-screen instructions. To create a design of your own or to modify any of the existing designs, press (Change Design), select the design you want to modify, then Page 6 press . Follow the on-screen instructions to change any or all of the design's six parameters. The Change Design function also has options to erase a design and to restore a design's parameters to either their original values or to the values saved during a previous run of the program. Configuration ------------- If you want to use a time service other than NIST, you'll need to select it. If you don't live in the Eastern time zone, you'll need to configure PCCLOCK for your location. If your modem isn't connected to serial port COM1, you'll need to change the port setting. And, depending on your modem, you may need to change the commands PCCLOCK uses to initialize it, by selecting its make and/or type from PCCLOCK's list or possibly by entering appropriate "custom" commands. If you want to get the time from CompuServe, you'll need to change the modem commands PCCLOCK uses to dial your local CompuServe network access number. If you want to use another time service and live in the same area code or city, you may need to change the modem commands PCCLOCK uses to dial the time service's phone number. In a few cases, you may need to configure PCCLOCK for the type of display attached to your computer or the number of function keys on your keyboard. More frequently changed configuration parameters, shown in Table 3, are accessed by pressing or (Configure) and set by following the on-screen instructions. Less frequently changed parameters are set with command-line switches, shown in Table 2. "Time Service" specifies whether a NIST, USNO, or NRC atomic clock or whether CompuServe (CIS) is called to obtain the date and time. For USNO, it specifies whether the Washington or Colorado Springs number is called; for NRC, it specifies whether the Ottawa or Toronto number is called. For NIST and CIS, it specifies the maximum line speed at which PCCLOCK will attempt to connect to the service; the actual speed is negotiated by the modems. If any service other than CompuServe is a local call, select that service, and change the "Dial" parameter, as described below. If you are a CompuServe member and want to obtain the time to the nearest minute, select CIS, and change the "Dial" parameter to call your local CompuServe network access number. Otherwise, select one of the other services based on your location. "Time Zone" specifies an adjustment for your location to the time supplied by the time service. Values for time zones in the U.S. and Canada are predefined; the values shown in parentheses are the corresponding adjustments to "universal" time (also known as UTC, GMT, Greenwich Mean Time, Greenwich Civil Time, Z time, or Zulu time). Outside these time zones, select the value "Universal", and set the Page 7 "UTC Offset" parameter. +---------------+------------------------------------------------------+ | Parameter | Possible Values (* = Default) | |===============+======================================================| | Time Service | NIST, Boulder, {9600|4800|2400|1200*|300} bps; USNO, | | | Washington, 1200 bps; USNO, Colorado Springs, 1200 | | | bps; NRC, Ottawa, 300 bps; NRC, Toronto, 300 bps; | | | CIS, local, {28800|14400|9600|4800|2400|1200|300} | | | bps | |---------------+------------------------------------------------------| | Time Zone | Newfoundland (-3:30), Atlantic (-4:00), Eastern | | | (-5:00)*, Central (-6:00), Mountain (-7:00), Pacific | | | (-8:00), Alaska (-9:00), Hawaii-Aleutian (-10:00), | | | Universal | |---------------+------------------------------------------------------| | DST Observed | Yes*, No | |---------------+------------------------------------------------------| | UTC Offset | +0:00*, -13:00 to +11:00 | |---------------+------------------------------------------------------| | Serial Port | COM1 (3F8h, IRQ4)*, COM2 (2F8h, IRQ3), | | | COM3 (3E8h, IRQ4), COM4 (2E8h, IRQ3), | | | COM1 (3F8h, polled), COM2 (2F8h, polled), | | | COM3 (3E8h, polled), COM4 (2E8h, polled) | |---------------+------------------------------------------------------| | Modem Type | Hayes-compatible 1200+, Hayes-compatible 2400+, | | | Rockwell-based 9600+ (default)*, AT&T 9600+ to ZyXEL | | | 9600+, Custom | |---------------+------------------------------------------------------| | Init | ^M~AT&FN&C1&D2&K&Q\N%C^M~*, other (See text.) | |---------------+------------------------------------------------------| | Dial (NIST) | ATDT1-303-494-4774^M*, other (See text.) | |---------------+------------------------------------------------------| | Dial (USNO-W) | ATDT1-202-762-1594^M*, other (See text.) | |---------------+------------------------------------------------------| | Dial (USNO-C) | ATDT1-719-567-6743^M*, other (See text.) | |---------------+------------------------------------------------------| | Dial (NRC-O) | ATDT1-613-745-3900^M*, other (See text.) | |---------------+------------------------------------------------------| | Dial (NRC-T) | ATDT1-416-445-9408^M*, other (See text.) | |---------------+------------------------------------------------------| | Dial (CIS) | ATDT1-???-???-????^M*, other (See text.) | |---------------+------------------------------------------------------| | Term | ~~+++~~ATH^M~~*, other (See text.) | +---------------+------------------------------------------------------+ Table 3. Configuration Parameters "DST Observed" specifies whether or not Daylight Saving Time (DST) is observed in your location. PCCLOCK is able to automatically adjust for DST only if DST is observed between the first Sunday in April and the last Sunday in October, as it is in most of the U.S. and Canada. When "Time Zone" is set to "Universal", this parameter is not accessible, and "UTC Offset" must be adjusted to account for time seasons as needed. Page 8 "UTC Offset" specifies an adjustment to the time supplied by the time service for locations outside the U.S. and Canada. The value specified can be zero, positive, or negative, and can be given in hours, minutes, or hours and minutes. This parameter is accessible only when "Time Zone" is set to "Universal". "Serial Port" specifies the port to which your modem is connected and the I/O method PCCLOCK uses to communicate with it. Ports COM1 through COM4 are listed twice, first with the standard I/O addresses and IRQ settings, then with the standard I/O addresses and the "polled" option (in parentheses). Select the value with the I/O address and IRQ setting corresponding to your hardware configuration. If your modem uses a nonstandard IRQ setting, select a "polled" value. If your modem uses a standard IRQ setting, but errors occur when PCCLOCK uses it, try selecting the corresponding "polled" value. Selecting a value with an IRQ setting causes PCCLOCK to use an "interrupt-driven" I/O method; selecting a value with the "polled" option causes PCCLOCK to use a "polled" I/O method. Neither method is compatible with all serial ports and modems. If neither method works correctly on your system, please contact the author for assistance. "Modem Type" specifies the type, or manufacturer and type, of your modem and controls the commands PCCLOCK uses to initialize the modem at the start of each call to a time service. If you have a 1200-bps modem, select "Hayes-compatible 1200+". If you have a 2400-bps modem, select "Hayes-compatible 2400+". If you have a 9600-bps, 14400-bps, 28800-bps or faster modem, select the "AT&T 9600+" through "ZyXEL 9600+" setting corresponding to the manufacturer of your modem. If your modem's manufacturer isn't listed, select "Rockwell-based 9600+ (default)", which causes PCCLOCK to use the correct commands for most current modems based on the popular Rockwell chipsets. If none of these settings works with your modem, set "Modem Type" to "Custom", and set the "Init" parameter as described below, or contact the author for assistance. "Init" specifies the commands needed to initialize your modem and is set automatically when "Modem Type" is set to other than "Custom". When "Modem Type" is set to "Custom", "Init" should be set to the appropriate commands to initialize your modem to return result codes in words rather than numbers and to disable error correction, data compression, and flow control. Without these commands, PCCLOCK may be unable to recognize your modem's responses, and your modem may be unable to establish connections with one or more of the time services. If the value set by "Modem Type" doesn't work with your modem, please consult your modem manual, or contact the author for assistance. "Dial" specifies the modem commands needed to call the selected time service. Different commands are used for each time service; the commands for the service specified by the "Time Service" parameter are accessible. Depending on your location and the service selected, you may need to delete the area code and/or "1" prefix from the telephone number. If you do not have tone dialing (Touch Tone service), change "ATDT" to "ATDP" to use pulse dialing. Page 9 When "Time Service" is "CIS", "Dial" must be modified to dial a CompuServe network access number in the same time zone and time season. To find access numbers in your area, log on to CompuServe and GO PHONES. Under certain circumstances, such as calling outside a local telephone network or using a special long distance service, you may need to use additional modem commands. Table 4 shows commands that can be used (between the "ATD" and the "^M") in the "Dial" parameter with most Hayes-compatible modems. Some modems have additional commands that can be used while dialing; check your modem documentation for more information. +--------------+-------------------------------------------------------+ | Command(s) | Effect | |==============+=======================================================| | 0 to 9, #, | Cause the modem to dial the specified digits. | | and * | | |--------------+-------------------------------------------------------| | space, (, ), | These characters are ignored by the modem and are | | and - | used only to increase readability. Example: | | | "ATDT 1 (202) 762-1594^M" has the same effect as | | | "ATDT12027621594^M". | |--------------+-------------------------------------------------------| | T | Switches modem to tone dialing. Use if you have | | | Touch Tone service. Example: "ATDT1-303-494-4774^M" | | | (the default "Dial" command) calls NIST long distance | | | using tone dialing. | |--------------+-------------------------------------------------------| | P | Switches modem to pulse dialing. Use if you do not | | | have Touch Tone service. Example: "ATDP1-303-494- | | | 4774^M" calls NIST using pulse dialing. | |--------------+-------------------------------------------------------| | W | Causes the modem to wait for another dialtone. If no | | | dialtone is detected within a specified period (5 | | | seconds for most modems), the modem hangs up and a | | | "NO DIALTONE" result code is displayed. Example: | | | "ATDT303-494-4774W33^M" calls NIST using a long | | | distance service that requires dialing the called | | | number, waiting for another dialtone, then dialing a | | | special code. | |--------------+-------------------------------------------------------| | , | A comma causes the modem to wait for a specified | | | period (2 seconds for most modems) before continuing | | | to dial. Example: "ATDT9,762-1594^M" calls USNO | | | from the Washington area, first dialing "9" then | | | waiting briefly to dial outside a local telephone | | | network. | +--------------+-------------------------------------------------------+ Table 4. Modem Dialing Commands "Term" specifies the commands PCCLOCK uses to hang up your modem (place it "on hook") after calling the time service and when you cancel a call by pressing . The default commands should work with virtually all Hayes-compatible modems. If they do not work with your Page 10 modem, please check you modem manual, or contact the author for assistance. Certain characters within the values of "Init", "Dial", and "Term" are interpreted by PCCLOCK rather than sent to the modem. "^M", "^m", and "|" (vertical bar) each cause PCCLOCK to send a carriage return character ( key) to the modem. "^" (caret) causes PCCLOCK to interpret the next character as a control character. "^X" (or "^x") sends a control-X character to the modem, where "X" is "A" to "Z", "[", "\", "]", "^", or "_". "~" (tilde) causes PCCLOCK to delay one second before continuing to send commands to the modem. "{" (left brace) causes PCCLOCK to send a standard 200-ms break signal. Command-line switches (Table 2) are used to set less frequently changed configuration parameters. These switches are "sticky" and need to be specified only once, not every time you run PCCLOCK, except if your hardware configuration changes. Configuration switch settings are saved in file PCCLOCK.DAT. The /C, /G, and /M (COLOR, COLOUR, GRAY, GREY, and MONO) switches configure PCCLOCK for the type of display attached to your computer. When PCCLOCK is run for the first time on your system, it automatically configures itself for a color or monochrome display, whichever is present, as though either the /C or /M switch was specified. If you have a grayscale display (a monochrome display capable of displaying at least 16 shades of gray), you may want to use the /G switch, which gives you a larger set of clock designs. The /Fn (FKEYS:n) switch configures PCCLOCK to use n (10 or 12) function keys, i.e., indicates whether and must be used for the Configure and Set by Modem functions or whether and are available. When PCCLOCK is run for the first time on your system, it sets this switch automatically, but may set it incorrectly on some computers (especially laptops) that report the wrong keyboard type. Setting Date and Time --------------------- To set the date and time by modem, run PCCLOCK and press or (Set by Modem), or run PCCLOCK with the /A (AUTO) or /Q (QUICK) command-line switch. When you use the /Q (QUICK) switch, PCCLOCK displays messages indicating the progress and results of calling the time service without bringing up the clock display or showing the modem dialog. Otherwise, PCCLOCK displays the commands sent to your modem, result codes returned by the modem, data received from the time service, and any error messages in a window at the top of your screen. If the call is successfully placed and valid data is received, both the date and time are set, and the call is terminated. The date and time are adjusted for the time zone specified in your configuration. If Daylight Saving Time is observed in your area (as specified in your configuration) and Daylight Saving Time is in effect, the time (and possibly the date) are adjusted accordingly. Page 11 If the call is not successful, PCCLOCK displays messages indicating the reason for the failure. In most cases, PCCLOCK will retry the call after a 30-second delay (or when you press ), until a maximum number of retries is reached (nine for the NRC time services, 14 for the others). The /A (AUTO) and /Q (QUICK) switches cause PCCLOCK to run in a non- interactive mode. When these switches are specified without a number of days, PCCLOCK calls the atomic clock, sets the date and time, and exits. When a number of days is specified, PCCLOCK calls the atomic clock only if at least that number of days has elapsed since the last call. PCCLOCK is often run with the /A (AUTO) or /Q (QUICK) switch from the AUTOEXEC.BAT file. To set the date and time every time you restart your computer, add the command "c:\pcclock\pcclock /a" or "c:\pcclock\pcclock /q" to AUTOEXEC.BAT, replacing "c:\pcclock\", if necessary, with the correct drive and directory. In general, this command should be placed near the end of AUTOEXEC.BAT. If AUTOEXEC.BAT contains a "win" command to start Windows, place the command to run PCCLOCK prior to the "win" command. To set the date and time periodically, use /An (AUTO:n) or /Qn (QUICK:n). For example, assuming you restart your computer at least once a day, you can set your clock once a week by adding the command "c:\pcclock\pcclock /a7" or "c:\pcclock\pcclock /q7") to AUTOEXEC.BAT. +-----------+---------------------------------------------------------+ | Exit Code | Corresponding Error Message | |===========+=========================================================| | 0 | None | |-----------+---------------------------------------------------------| | 1 | Internal error - PCCLOCK aborted | |-----------+---------------------------------------------------------| | 2 | Error :\PCCLOCK.{DAT|LOG} - | | | | |-----------+---------------------------------------------------------| | 3 | Invalid switch - Type "pcclock /?" for help | |-----------+---------------------------------------------------------| | 4 | Date and time not set - Call not due for m more day(s) | |-----------+---------------------------------------------------------| | 5 | Date and time not set - Call canceled by operator | |-----------+---------------------------------------------------------| | 6 | Date and time not set - Serial I/O error n | |-----------+---------------------------------------------------------| | 7 | Date and time not set - Response timeout | |-----------+---------------------------------------------------------| | 8 | No connection | |-----------+---------------------------------------------------------| | 9 | CIS node not in same time zone and season | |-----------+---------------------------------------------------------| | 10 | Internal error n | |-----------+---------------------------------------------------------| | 11 | Invalid video mode | +-----------+---------------------------------------------------------+ Table 5. Exit Codes Page 12 When /A (AUTO) or /Q (QUICK) is used, PCCLOCK displays a message indicating the success or failure of the call to the time service. It also sets the exit code to zero if the call is successful and to a nonzero value otherwise, so that the command "IF ERRORLEVEL . . ." can be used in a batch file to test the outcome. Possible exit codes are listed in Table 5; see "Error Messages" for detailed explanations. To set the date or time manually, press either (Set Date) or (Set Time), and follow the displayed instructions. Statistics and Log File ----------------------- After a successful call to a time service, PCCLOCK writes call statistics to a log file, PCCLOCK.LOG, and, unless the /Q (QUICK) switch was used, displays call statistics in a window at the bottom of the screen. Call statistics are described in Table 6. +-------------+--------------------------------------------------------+ | Statistic | Meaning | |=============+========================================================| | Clock set | Date and time from time service, adjusted to local | | to | time | |-------------+--------------------------------------------------------| | Was | Date and time immediately prior to setting | |-------------+--------------------------------------------------------| | Adjusted by | Adjustment to computer's clock | |-------------+--------------------------------------------------------| | Last set | Date and time set by previous call to a time service | |-------------+--------------------------------------------------------| | Interval | Period since clock last set by calling a time service | |-------------+--------------------------------------------------------| | Performance | Time gained (+) or lost (-) by computer's clock since | | | previous call to a time service, in seconds/day | +-------------+--------------------------------------------------------+ Table 6. Call Statistics "Last set", "Interval", and "Performance" are all shown as "n/a" (not applicable) if PCCLOCK has not previously set the clock by calling a time service. "Performance" is also shown as "n/a" in other cases when its value would not be meaningful: when the time service called is CIS, when "Interval" is less than four hours, and when "Adjusted by" is greater than 1/2 hour. A header at the start of the log file shows the last time service called, the date and time of the call, and the outcome (success or failure and reason for failure). The remainder of the log file lists successful calls and, for each call, the time service called and the "Clock set to", "Adjusted by", and "Performance" statistics as described above. Page 13 Time Services ------------- The atomic-clock-based time services accessed by PCCLOCK are operated by the National Institute of Standards and Technology (NIST, formerly NBS, National Bureau of Standards) in Boulder, Colorado; the U.S. Naval Observatory (USNO) in Washington, D.C., and Colorado Springs, Colorado; and the National Research Council (NRC) in Ottawa, Ontario. At the time this version of PCCLOCK was released, the USNO Colorado Springs time service, which USNO had indicated would be modem-accessible about February 1997, was not yet online. Telephone voice announcements from this service were already available. These agencies provide national time and frequency standards for the U.S. and Canada and contribute to the International Atomic Time Scale (TAI) coordinated by the International Bureau of Weights and Measures (BIPM) in Paris. Although the signal from NIST, USNO, or NRC arrives at your modem within a few milliseconds of the exact time, the accuracy with which your computer's clock can be set is limited by the fact that it ticks only about once every 55 milliseconds and can only be set to the nearest tick. And, although it can be set to the nearest 55 ms, your computer's clock's accuracy is most affected by its tendency to gain or loose time. However, by using PCCLOCK to set your computer's clock regularly, you can ensure that it will be accurate enough for all but the most demanding applications. In addition to operating the time services used by PCCLOCK, NIST and USNO broadcast voice announcements of the time via shortwave radio, and NIST, USNO, and NRC provide voice announcements of the time by telephone (Table 7). +--------+------------------+-----------------------------------+ | Agency | Radio Station(s) | Telephone Numbers | |========+==================+===================================| | NIST | WWV (Colorado) | (303) 499-7111 (WWV) | | | WWVH (Hawaii) | (808) 335-4363 (WWVH) | |--------+------------------+-----------------------------------| | USNO | n/a | (202) 762-1401 (Washington #1) | | | | (202) 762-1069 (Washington #2) | | | | (719) 567-6742 (Colorado Springs) | | | | (900) 410-TIME (50 cents/call) | |--------+------------------+-----------------------------------| | NRC | CHU | (613) 745-1576 (English) | | | | (613) 745-9426 (French) | +--------+------------------+-----------------------------------+ Table 7. Radio and Telephone Time Announcements Common Problems and Solutions ----------------------------- * Problem: Unable to set clock by modem. No modem commands or responses appear in the box at the top of the screen, "garbage" Page 14 appears in the box at the top of the screen, a "Response timeout" error occurs, and/or PCCLOCK "freezes". Possible Solutions: 1. Verify that PCCLOCK's "Serial Port" configuration parameter is set correctly: a. First, try setting "Serial Port" to "COMn (xxxh, IRQx)", where "COMn" is the serial port used by your modem. ("xxxh" and "IRQx" must match your modem's I/O address and IRQ setting.) b. If this setting doesn't work, or if your modem uses a nonstandard IRQ setting, try changing "Serial Port" from "COMn (xxxh, IRQx)" to "COMn (xxxh, polled)". This causes PCCLOCK to use its "polled" serial I/O method rather than its "interrupt-driven" method. The polled method may be more compatible with your system. Refer to "Serial Port" under "Configuration" above for details. * Problem: Unable to set clock by modem. Modem commands and responses appear in the box at the top of the screen. The modem either responds "ERROR" or accepts the commands but fails to successfully connect to the time service. A "No connection" or "Response timeout" error occurs. Possible Solutions: 1. Verify that PCCLOCK's "Modem Type" or "Init" configuration parameter is set correctly for your modem. Without the proper initialization commands, many high-speed modems are unable to establish connections with the lower-speed modems used by the NIST, USNO, and NRC time services. 2. If you've previously upgraded from PCCLOCK version 4.x to PCCLOCK version 4.y, verify that "Modem Type" is still set correctly. Previous versions of PCCLOCK sometimes incorrectly modified the "Modem Type" setting saved by earlier versions of the program. Refer to "Modem Type" and "Init" under "Configuration" above for details. * Problem: After installing a registered copy of PCCLOCK, registration reminder messages (e.g., "DAY N OF 30-DAY FREE TRIAL") continue to appear when starting the program and the registration reminder screen continues to appear when exiting the program. Solution: Mark PCCLOCK as registered by following the instructions under "Bypassing the Registration Reminders" that appear only in the printed user's guide included with the registered copy. * Problem: Unable to set clock using a U.S. Robotics Sportster WinModem or other software-based modem requiring a Windows device driver. Solution: None. These modems are not compatible with DOS applications like PCCLOCK. Page 15 Error Messages -------------- CIS node not in same time zone and season The CompuServe node (access number) called did not provide the time for the time zone and season specified in your configuration. Choose another access number, or correct "Time Zone" and/or "DST Observed". Colorado Springs service may not yet be online The USNO's new Colorado Springs time service was selected, but PCCLOCK has not yet called this service successfully. PCCLOCK will call the service, but the call will be unanswered if the service is not yet operational. PCCLOCK will no longer display this message once a successful call has been completed. At the time this version of PCCLOCK was released, the USNO Colorado Springs time service, which USNO had indicated would be modem-accessible about February 1997, was not yet online. Date and time not set - Call canceled by operator PCCLOCK was run with the /A (AUTO) or /Q (QUICK) switch, and the operator canceled the call by pressing . Date and time not set - Call not due for m more day(s) PCCLOCK was run with the /An (AUTO:n) or /Qn (QUICK:n) switch, and fewer than n days have elapsed since the last successful call to a time service. If you continue to run PCCLOCK with the same switch each day, PCCLOCK will set your clock in m more days. Date and time not set - CIS node not in same time zone and season See "CIS node not in same time zone and season". Date and time not set - Internal error n An error occurred in the procedure PCCLOCK uses to communicate with the time service. PCCLOCK will retry the call up to 9 times for the NRC service, 14 times for the other time services. If this error occurs, please contact the author for assistance. Date and time not set - No connection PCCLOCK was unable to establish a connection to the time service because it received a busy signal or similar response (i.e., "BUSY", "ERROR", "NO ANSWER", "NO CARRIER", "NO DIALTONE", "NO DIAL TONE", or "VOICE") from your modem. PCCLOCK will retry the call up to 9 times for the NRC service, 14 times for the other time services. If this message is preceded by an "ERROR" response from your modem, correct the "Modem Type" or "Init" configuration parameter (see "Configuration" above). Page 16 Date and time not set - Response timeout PCCLOCK did not receive an initial response from your modem within five seconds, was unable to connect to the time service within 60 seconds, or was unable to complete the call to the time service within 60 seconds after connecting. PCCLOCK will retry the call up to 9 times for the NRC service, 14 times for the other time services. Make sure the power to your modem is on and that the "Serial Port" and "Modem Type" or "Init" configuration parameters are set correctly (see "Configuration" above). Date and time not set - Serial I/O error n PCCLOCK was unable to communicate successfully with your modem. PCCLOCK will retry the call up to 9 times for the NRC service, 14 times for the other time services. Try both interrupt-driven and polled serial I/O (see "Configuration" above), and verify that your modem is operating correctly with your other software. Contact the author for assistance if required. Error :\PCCLOCK.{DAT|LOG} - PCCLOCK was unable to access its configuration (.DAT) or log (.LOG) file, which are located on the same drive and in the same directory as file PCCLOCK.EXE. is replaced by "reading", "creating", or "writing". indicates the probable cause of the error. If PCCLOCK is run from diskette, the diskette should remain in the drive and should not be write-protected while PCCLOCK is running. If PCCLOCK is run from CD-ROM, it will not be able to write either of these files, and should therefore be installed on your hard disk for other than trial use. Internal error n See "Date and time not set - Internal error n". Internal error n - PCCLOCK aborted PCCLOCK detected an error in the internal structure of the PCCLOCK.EXE file, which may be corrupted. Try reinstalling PCCLOCK from diskette or from the .ZIP file. If the error persists, please contact the author. Internal error - PCCLOCK.DAT not updated An error occurred in the procedure PCCLOCK uses to update the configuration file, PCCLOCK.DAT. Please contact the author for assistance. Invalid data received - Retrying . . . A data string received from the time service was not in the correct format, and PCCLOCK is staying online until another data string is received. If this error is intermittent, the cause may be a noisy phone line. If it occurs repeatedly, verify that the "Modem Type" or "Init" configuration parameter is set correctly (see "Configuration" above). Page 17 Invalid switch - Type "pcclock /?" for help One or more switches in the DOS command used to run PCCLOCK were not in the correct format. See "Command-Line Switches" above, or enter "pcclock /?" at the DOS prompt for instructions. Invalid video mode - PCCLOCK aborted Your computer's display was not set for 80-column operation; PCCLOCK cannot operate in 40-column modes. Use the DOS MODE command to select an 80-column display mode, then rerun PCCLOCK. No connection See "Date and time not set - No connection". Printer offline or out of paper. PCCLOCK was unable to print a registration/order form. If your printer is connected to parallel port LPT1, ready the printer and try again. Otherwise, refer to "How to Register" below. Response timeout See "Date and time not set - Response timeout". Serial I/O error n See "Date and time not set - Serial I/O error n". UTC Offset must be between -13:00 and +11:00. The "UTC Offset" configuration parameter cannot be used to adjust the time received from the time service over more than a 24-hour range. UTC Offset not in correct format. The "UTC Offset" configuration parameter must be entered as a number of hours, as a number of hours followed by a colon followed by a number of minutes, or as a colon followed by a number of minutes, optionally preceded by a plus or minus sign. Page 18 PCCLOCK Files ------------- The files installed on your hard disk or modified by PCCLOCK's SETUP utility are listed in Table 8 and described in Table 9. +-----------+----------------------------------------------------------+ | Operating | | | System | Files Installed or Modified by SETUP | |===========+==========================================================| | Windows | C:\Pcclock\Pcclock.exe | | 95 | C:\Pcclock\Usrguide.wri | | | C:\Pcclock\Whatsnew.wri | | | C:\Pcclock\Pcclock.ico | | | C:\Pcclock\PC Clock 4.3.pif | | | C:\Pcclock\PC Clock Log.pif | | | C:\Pcclock\PC Clock User's Guide.pif | | | C:\WINDOWS\Start menu\Programs\PC Clock\PC Clock 4.3.pif | | | C:\WINDOWS\Start menu\Programs\PC Clock\PC Clock Log.pif | | | C:\WINDOWS\Start menu\Programs\PC Clock\PC Clock User's | | | Guide.pif | | | C:\WINDOWS\Start menu\Programs\PC Clock\PC Clock What's | | | New.pif | |-----------+----------------------------------------------------------| | Windows | C:\PCCLOCK\PCCLOCK.EXE | | 3.x | C:\PCCLOCK\USRGUIDE.WRI | | | C:\PCCLOCK\WHATSNEW.WRI | | | C:\PCCLOCK\PCCLOCK.GRP | | | C:\PCCLOCK\PCCLOCK.ICO | | | C:\PCCLOCK\PCCLOCK.PIF | | | C:\WINDOWS\PROGMAN.INI | |-----------+----------------------------------------------------------| | OS/2 | C:\PCCLOCK\PCCLOCK.EXE | | | C:\PCCLOCK\USRGUIDE.TXT | | | C:\PCCLOCK\WHATSNEW.TXT | | | C:\PCCLOCK\PCCLOCK.ICO | |-----------+----------------------------------------------------------| | DOS | C:\PCCLOCK\PCCLOCK.EXE | | | C:\PCCLOCK\USRGUIDE.TXT | | | C:\PCCLOCK\WHATSNEW.TXT | | | C:\AUTOEXEC.BAT | +-----------+----------------------------------------------------------+ Table 8. Files Installed or Modified by SETUP Note: "C:" is replaced by the actual hard disk drive letter, "\PCCLOCK" is replaced by the actual target directory, and "\WINDOWS" is replaced by the actual Windows directory, as needed. Page 19 +------------------------------+--------------------------------------+ | File | Description | |==============================+======================================| | AUTOEXEC.BAT | System startup batch file with | | | C:\PCCLOCK added to PATH | |------------------------------+--------------------------------------| | Pcclock.exe or PCCLOCK.EXE | PCCLOCK program | |------------------------------+--------------------------------------| | PCCLOCK.GRP | Windows program group for PCCLOCK | |------------------------------+--------------------------------------| | Pcclock.ico or PCCLOCK.ICO | Windows icon for PCCLOCK | |------------------------------+--------------------------------------| | PCCLOCK.PIF | Windows 3.x program information file | |------------------------------+--------------------------------------| | PROGMAN.INI | Windows 3.x Program Manager | | | configuration data with PCCLOCK | | | program group added | |------------------------------+--------------------------------------| | PC Clock 4.3.pif | Windows 95 shortcut to Pcclock.exe | |------------------------------+--------------------------------------| | PC Clock Log.pif | Windows 95 shortcut to Pcclock.log | |------------------------------+--------------------------------------| | PC Clock User's Guide.pif | Windows 95 shortcut to Usrguide.wri | |------------------------------+--------------------------------------| | PC Clock What's New.pif | Windows 95 shortcut to Whatsnew.wri | |------------------------------+--------------------------------------| | USRGUIDE.TXT | User's guide in ASCII text format | |------------------------------+--------------------------------------| | Usrguide.wri or USRGUIDE.WRI | User's guide in Windows Write format | |------------------------------+--------------------------------------| | WHATSNEW.TXT | What's new in ASCII text format | |------------------------------+--------------------------------------| | Whatsnew.wri or WHATSNEW.WRI | What's new in Windows Write format | +------------------------------+--------------------------------------+ Table 9. PCCLOCK File Descriptions Shareware Notice ---------------- PCCLOCK is copyrighted software distributed as shareware and may not be sold without the written permission of the author. However, you are welcome to use this copy of PCCLOCK on a 30-day free trial basis. If you continue to use PCCLOCK beyond 30 days, you are required to register your copy and pay a one-time fee of $20 (plus shipping and handling) to support its development. When you register, you will receive a printed user's guide plus a copy of the latest version of PCCLOCK on diskette, and you will be entitled to use all future versions of PCCLOCK at no additional charge and without reregistering. Registered users have the right to use a single copy of PCCLOCK and may register additional copies or purchase pre-registered copies on diskette. Page 20 You are permitted to make multiple copies of PCCLOCK for use within a single business or organization only if you register and pay for each copy that is used beyond a 30-day free trial period. Shareware disk and CD-ROM vendors, user groups, computer clubs, computer stores, bulletin board systems, and individuals are permitted to copy and distribute PCCLOCK for others to use on the same 30-day free trial basis, provided that the program is unmodified and all necessary files are included. A reasonable fee may be charged for media, copying, and shipping and handling or for transmission time. When you give copies of PCCLOCK to friends and associates, please copy the original diskette or .ZIP file rather than the installed files. When you upload PCCLOCK to a BBS or an online service, please use the original .ZIP file. If possible, please use the filename PCCLK430.ZIP if eight-character names are permitted or the filename PCK430.ZIP if only six-character names are permitted. If the BBS or online service area requires filenames without version numbers, please use the filename PCCLOCK.ZIP if eight-character names are permitted or the filename PCCLCK.ZIP if only six-character names are permitted. How to Register --------------- To order one or more registered copies of PCCLOCK, run PCCLOCK, press to exit to the registration reminder screen, then follow the displayed instructions. If you would like to register by mail and no printer is available or your printer is not connected to parallel port LPT1, you can register directly with the author by sending your name and address together with your payment of $20 per copy to: M. J. Sadaway, P. O. Box 128-P, South Walpole, MA 02071. Please specify diskette size (3.5" or 5.25"). For direct orders, shipping and handling are free. Payment must be by cash, check, money order, or postal money order, and in U.S. dollars. Checks must be drawn on a U.S. bank. Bypassing the Registration Reminders ------------------------------------ Registered users may mark installed copies of PCCLOCK as registered, in order to bypass the registration reminder messages (e.g., "DAY n OF 30- DAY FREE TRIAL") displayed when an unregistered copy of PCCLOCK is started and the the registration reminder screen displayed when an unregistered copy is exited. They may also personalize PCCLOCK to display the name of the registered user. Instructions for doing this are given only in the printed user's guide included with registered copies of the program. If this version of PCCLOCK replaces a registered copy of a previous version in the same directory, it will also be marked as registered. If this version replaces a registered copy of a previous version in a different directory, it can be marked as registered by following the Page 21 instructions for the printed user's guide for the previous version of the program. If a registered copy of PCCLOCK is moved to another disk or computer, it is automatically marked as unregistered. Support Policy -------------- Registered users of PCCLOCK are entitled to support at no additional cost for a minimum of three months from the date of registration. Within this time, the author, when contacted via mail or e-mail, will answer the user's questions concerning the use of PCCLOCK and will attempt to correct any problem reported by the user that causes PCCLOCK to fail to perform in the manner described in the user's guide. If a reported problem is due to the user's specific hardware configuration or software environment rather than an error in PCCLOCK, or the problem cannot otherwise be corrected by the author, the user may request and will receive a full refund of the registration fee. Feedback -------- Your questions, comments, criticisms, and suggestions concerning PCCLOCK are welcome. Please send them to M. J. Sadaway, P. O. Box 128-P, South Walpole, MA 02071, via CompuServe mail to 75046,2272, or via Internet mail to 75046.2272@compuserve.com. Shareware and the ASP --------------------- Shareware is software you can try before you buy. You are permitted to use it, and you are generally free to copy it for others to use, on a trial basis. If you find it to your liking and continue to use it, you are expected to pay for it. Payment is in the form of a registration fee, which entitles you to continue to use the software, and may entitle you to other benefits. The length of the trial period and any restrictions on copying and distribution of the software vary depending on the author and program. Many shareware programs perform unique functions not available in retail software at any price; others are similar to retail programs but usually cost considerably less. Shareware is generally of the same high quality as retail software, and many shareware authors offer technical support more responsive than the big software companies. Plus, shareware has a better than money-back guarantee - if you don't use it, you don't pay for it. The ASP, or Association of Shareware Professionals, is an organization of shareware authors and distributors that promotes the shareware concept. ASP members are required to abide by established standards of professionalism, and the ASP name and logo are your assurances that an author or distributor meets these standards. Page 22 All ASP shareware includes support by the author for a minimum of three months after user registration, and authors are required to fully refund registration fees to users reporting problems during this period if the problems cannot be resolved. The ASP also helps resolve disputes between shareware users and authors or distributors. Look for the ASP name when choosing shareware. And help ensure the availability of quality software at reasonable prices by registering the shareware programs you use. _______ ____|__ | (R) Michael J. Sadaway --| | |---------------- P. O. Box 128-P | ____|__ | Association of South Walpole, MA 02071 | | |_| Shareware |__| o. | Professionals CompuServe: 75046,2272 -----| | |------------------ Internet: 75046.2272@compuserve.com |___|___| MEMBER This program is produced by a member of the Association of Shareware Professionals (ASP). ASP wants to make sure that the shareware principle works for you. If you are unable to resolve a shareware- related problem with an ASP member by contacting the member directly, ASP may be able to help. The ASP Ombudsman can help you resolve a dispute or problem with an ASP member, but does not provide technical support for members' products. Please write to the ASP Ombudsman at Association of Shareware Professionals, 545 Grover Rd., Muskegon, MI 49442, fax (616) 788-2765, or send a message via CompuServe Mail to ASP Ombudsman 70007,3536 or Internet mail to 70007.3536@compuserve.com. Disclaimer ---------- The author disclaims all warranties, expressed or implied, including but not limited to implied warranties of merchantability or fitness for a particular purpose, with respect to PCCLOCK and the accompanying documentation. In no event shall the author be liable for any damages, direct or consequential, arising out of the use of or inability to use this product, even if the author has been advised of the possibility of such damages. Page 23