Dec 272017
 
PCCLOCK v3.03 - Sets your PC's date and time by modem to NIST or USNO atomic clock.

Full Description of File


PCCLOCK v3.03 - Sets your PC's date and
time by modem to NIST or USNO atomic clock.
Displays the date and time in big digits in
your choice of built-in designs or ones you
create yourself. Has 6-digit, 12- or 24-hour
display, manual setting option, chime, and
alarm. Supports 300- to 14.4k-bps modems.
"AUTO:n" option can set time every n days
through AUTOEXEC.BAT. And Boardwatch Magazine
called it "charming from front to back."


File PCCLK303.ZIP from The Programmer’s Corner in
Category Communications
PCCLOCK v3.03 – Sets your PC’s date and time by modem to NIST or USNO atomic clock.
File Name File Size Zip Size Zip Type
FILE_ID.DIZ 447 317 deflated
PCCLOCK.DOC 58585 16103 deflated
PCCLOCK.EXE 116006 64204 deflated

Download File PCCLK303.ZIP Here

Contents of the PCCLOCK.DOC file


PCCLOCK DIGITAL CLOCK USER'S GUIDE

Version 3.03

Copyright (c) 1991, 1993 M. J. Sadaway.
All rights reserved.


Introduction
------------

* PCCLOCK accurately sets your PC's date and time by modem, by
calling either the NIST (National Institute of Standards and
Technology) atomic clock in Boulder, Colorado, or the USNO
(U.S. Naval Observatory) atomic clock in Washington, D.C.

* PCCLOCK also displays the date and time in big digits in your
choice of up to 80 designs supplied with the program plus 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, and optional Big Ben chime.

* PCCLOCK works with almost any modem and with DOS version 2.1 or
later.


Getting Started
---------------

Although detailed instructions follow, you probably won't need
(or want) to read them before using PCCLOCK. To use PCCLOCK now,
copy file PCCLOCK.EXE to the desired directory on your hard disk.
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.

Read further if you have problems or questions, and review the
rest of the user's guide if you want to be sure you're familiar
with all of PCCLOCK's features. Finally, please take a look at
"Special Discounts for Registered Users".

If you do 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.

Page 1
Installation
------------

When installing PCCLOCK for the first time, copy file PCCLOCK.EXE
to the desired directory on your hard disk. When upgrading from
a previous version, replace PCCLOCK.EXE with the new version.

PCCLOCK uses file PCCLOCK.DAT to save configuration parameters,
modified clock designs, current settings, and other data. If
this file is not present (as when you run PCCLOCK the first
time), PCCLOCK tries to create it in the same directory from
which PCCLOCK.EXE was run. (When using DOS versions earlier than
3.0, PCCLOCK.DAT is placed in the root directory of the current
drive.)

Although PCCLOCK can be run from CD-ROM or a write-protected
diskette, it may be unable to create or update PCCLOCK.DAT. For
normal operation, PCCLOCK.EXE should be copied to your hard disk.

If you've previously run PCCLOCK on your system and you install
version 3.03 in the same directory, the program will automatically
upgrade your existing PCCLOCK.DAT file and continue to use the
existing configuration, clock designs, and other settings.

Only PCCLOCK.EXE and PCCLOCK.DAT are needed in order to run
PCCLOCK. The accompanying files PCCLOCK.DOC, which contains this
user's guide, and PCCLK303.ZIP, which contains another copy of
PCCLOCK in compressed form, may be omitted from your hard disk.
Please include PCCLOCK.DOC when you give copies of PCCLOCK to
friends and associates, and please use PCCLK303.ZIP when you
upload PCCLOCK to BBSs.


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 /?").


Keyboard Functions
------------------

To perform a function, press the associated key, -,
, or , as shown in Table 1, then follow any on-
screen instructions. These keys are active whether the labels at
the bottom of the screen are on or off.

Pressing the key cancels the selected function, displays
the registration reminder screen, or exits PCCLOCK and returns to
DOS.


Page 2
When no other function is selected, PCCLOCK responds to the Up>, , left and right arrow, and other keys as though
(Select Design) had been pressed, except that instructions
for selecting designs are not displayed.

+--------+--------+---------------------------------------------+
| Key | Label | Description |
|========+========+=============================================|
| F1 | F Keys | Alternately displays and erases list of |
| | On/Off | keys and associated functions at bottom of |
| | | screen. |
|--------+--------+---------------------------------------------|
| F2 | Select | Displays 20 clock design "swatches", and |
| | Design | allows any design to be selected as the |
| | | current design. |
|--------+--------+---------------------------------------------|
| F3 | Modify | Displays and allows modification of the |
| | Design | parameters defining the current clock |
| | | design. |
|--------+--------+---------------------------------------------|
| F4 | 12/24 | Switches between 12- and 24-hour modes of |
| | Hour | time display. |
|--------+--------+---------------------------------------------|
| F5 | Date/ | Switches between display of time alone, |
| | Time | date alone, and alternating date and time. |
|--------+--------+---------------------------------------------|
| F6 | Chime | Alternately enables and disables chiming |
| | On/Off | every quarter hour. |
|--------+--------+---------------------------------------------|
| F7 | Set | Displays current date, and allows new date |
| | Date | to be entered through keyboard. |
|--------+--------+---------------------------------------------|
| F8 | Set | Displays current time, and allows new time |
| | Time | to be entered through keyboard. |
|--------+--------+---------------------------------------------|
| F9 | Set | Displays current alarm setting, and allows |
| | Alarm | new alarm time to be entered. |
|--------+--------+---------------------------------------------|
| F10 | Alarm | Alternately enables and disables alarm from |
| | On/Off | ringing at the set time. Also silences |
| | | alarm if ringing. |
|--------+--------+---------------------------------------------|
| F11 or | Con- | Displays and allows modification of |
| Ctrl-C | figure | configuration parameters used when calling |
| | | atomic clocks. |
|--------+--------+---------------------------------------------|
| F12 or | Set by | Sets date and time by calling NIST or USNO |
| Ctrl-S | Modem | atomic clock. |
+--------+--------+---------------------------------------------+

Table 1. Keyboard Functions







Page 3
Command-Line Switches
---------------------

The switches shown in Table 2 can be specified as part of the DOS
command used to run PCCLOCK.

+----------+-----------------+----------------------------------+
| Switch | Alias | Function |
+==========+=================+==================================+
| /A | AUTO | Sets date and time to atomic |
| | | clock, then exits. |
|----------+-----------------+----------------------------------|
| /An | AUTO:n | Sets date and time to atomic |
| | | clock if not set for n (1-365) |
| | | days. |
|----------+-----------------+----------------------------------|
| /C | COLOR, COLOUR | Configures to use 16 colors (for |
| | | color display). |
|----------+-----------------+----------------------------------|
| /G | GRAY, GREY | Configures to use 4 gray levels |
| | | (for grayscale display). |
|----------+-----------------+----------------------------------|
| /M | MONO | Configures to use black, white, |
| | | and bright white only (for |
| | | monochrome display). |
|----------+-----------------+----------------------------------|
| /Cn, | COLOR:n, | Configures for color, grayscale, |
| /Gn, | COLOUR:n, | or monochrome display; selects |
| /Mn | GRAY:n, GREY:n, | clock design Cn (1-100), Gn |
| | MONO:n | (1-40), or Mn (1-20) as default. |
|----------+-----------------+----------------------------------|
| /Sn | SPEED:n | Configures DTE speed for non- |
| | | standard modems to n (300-56000) |
| | | bps. |
|----------+-----------------+----------------------------------|
| /I | INT | Configures to use interrupt- |
| | | driven serial I/O. |
|----------+-----------------+----------------------------------|
| /P | POLLED | Configures to use polled serial |
| | | I/O. |
|----------+-----------------+----------------------------------|
| /? 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 " ".

Page 4
4. n may be preceded by ":" or "=".

5. The configuration switches (/C, /G, /M, /S, /I, and /P) need
to be specified only once. The settings of these switches is
saved in the configuration file, PCCLOCK.DAT.

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) switch. See "Configuration" for full descriptions of
the /C, /G, /M, /S, /I, and /P (COLOR, COLOUR, GRAY, GREY, MONO,
SPEED, INT, and POLLED) 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 either chooses a design at random or
uses a specified default design. To select another design or to
select either a random design or a specific design as the
default, press (Select Design), and follow the on-screen
instructions.

To create a design of your own or to modify any of the existing
designs, first select the design you wish to modify, then press
(Modify Design). Follow the displayed instructions to
change any or all of the design's six parameters.

The Select Design and Modify Design functions also have 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.




Page 5
Configuration
-------------

Unless you live in the Eastern time zone, you'll need to
configure PCCLOCK for your location. If you live in the Boulder
or Washington area, you'll want to select the time service near
you, and you may need to change the modem commands PCCLOCK uses
to dial the NIST or USNO phone number.

If your modem is not 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.

In some cases, you may also need to configure PCCLOCK for the
type of display attached to your computer. Finally, you may need
to change the speed at which or method by which PCCLOCK
communicates with your modem.

More frequently changed configuration parameters, shown in Table
3, are accessed by pressing or (Configure) and set

+--------------+---------------------+--------------------------+
| Parameter | Default Value | Possible Values |
|==============+=====================+==========================|
| Serial Port | COM1 | COM1 to COM4 or COM8 |
|--------------+---------------------+--------------------------|
| Init | ATZ|~~ATE1M1QV1|~~ | ATZ|~~ATE1M1QV1|~~ (for |
| | | most 300- and 1200-bps |
| | | modems), AT&F|~ (for |
| | | most 2400-bps modems), |
| | | AT&FNS37=5\N1%C|~ or |
| | | AT&FNS37=5&Q|~ (for most |
| | | 9600-bps and faster |
| | | modems), custom (for |
| | | other modems) |
|--------------+---------------------+--------------------------|
| Dial (NIST) | ATDT1-303-494-4774| | See text. |
|--------------+---------------------+--------------------------|
| Dial (USNO) | ATDT1-202-653-0351| | See text. |
|--------------+---------------------+--------------------------|
| Hang Up | ~~+++~~ATH|~~ | See text. |
|--------------+---------------------+--------------------------|
| Time Zone | Eastern | Newfoundland, Atlantic, |
| | | Eastern, Central, |
| | | Mountain, Pacific, |
| | | Alaska, Hawaii- |
| | | Aleutian, Universal |
|--------------+---------------------+--------------------------|
| DST Observed | Yes | Yes, No |
|--------------+---------------------+--------------------------|
| UTC Offset | +0:00 | -13:00 to +11:00 |
|--------------+---------------------+--------------------------|
| Service | NIST | NIST or USNO |
+--------------+---------------------+--------------------------+

Table 3. Configuration Parameters


Page 6
by following the on-screen instructions. Less frequently changed
parameters are set with command-line switches, shown in Table 2.

The "Serial Port" parameter specifies the port to which your
modem is connected. On most (ISA bus) computers, ports COM1
through COM4 are listed, and COM3 and COM4 are repeated with both
standard I/O addresses (3E8h, 2E8h) and alternate I/O addresses
(3E0h, 2E0h, 338h, 238h) shown in parentheses. On Micro Channel
(MCA bus) computers, ports COM1 through COM8 are listed with
standard I/O addresses. Be sure to select the port setting with
the I/O address corresponding to your hardware configuration.

The "Init", "Dial", and "Hang Up" parameters specify the commands
PCCLOCK uses to communicate with your modem. The predefined
values should should work for most Hayes-compatible modems. If
they do not work with your modem, consult your modem
documentation, or contact the author for assistance if required.

Certain characters within the values of "Init", "Dial", and "Hang
Up" are interpreted by PCCLOCK rather than sent to the modem.
"|" (vertical bar) causes PCCLOCK to send a carriage return
character to the modem. "~" (tilde) causes PCCLOCK to delay one
second before continuing to send commands to the modem. When
polled serial I/O is used (see /I and /P switches below), "{"
(left brace) sends a break signal to the modem.

"Init" specifies the commands needed to initialize your modem.
Commands for the majority of 1200-bps, 2400-bps, and 9600- or
14400-bps modems can be selected by pressing through
. The commands selected by and force most
9600-bps and faster modems to operate at the 1200-bps maximum
speed of the NIST and USNO systems, without error correction and
without data compression. Without these commands, many high-
speed modems are unable to establish connections with NIST and
USNO, because the modems fail to automatically "fall back" to
1200 bps. If your modem does not accept them, try using the
commands selected by or . If you are still unable
to connect to NIST or USNO, check your modem manual, or contact
the author for assistance.

"Dial" specifies the modem commands needed to call either the
NIST or USNO atomic clock. Different commands are used for each;
the commands for the atomic clock specified by the "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. 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
"|" in the "Dial" parameter with most Hayes-compatible modems.
Some modems have additional commands that can be used while
dialing; check your modem documentation.




Page 7
"Hang Up" specifies the commands PCCLOCK uses to place your modem
"on hook" after calling NIST or USNO and when you cancel a call
by pressing .

"Time Zone" specifies an adjustment for your location to the
"universal" time (also known as UTC, GMT, or Zulu time) supplied
by NIST or USNO. Values for time zones in the United States and
Canada are predefined. Outside these areas, select the value
"Universal", and set the "UTC Offset" parameter.

"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 it is observed between the
first Sunday in April and the last Sunday in October. Therefore,
this parameter is not accessible when "Time Zone" is set to
"Universal".

+--------------+------------------------------------------------+
| Command(s) | Effect |
|==============+================================================|
| 0 to 9, #, | Causes the modem to dial the specified digit. |
| and * | |
|--------------+------------------------------------------------|
| space, (, ), | These characters are ignored by the modem, but |
| and - | may be used to increase readability of the |
| | command. Example: "ATDT 1 (202) 653-0351|" |
| | has the same effect as "ATDT12026530351|". |
|--------------+------------------------------------------------|
| T | Switches modem to tone dialing. Use if you |
| | have Touch Tone service. Example: "ATDT1- |
| | 303-494-4774|" (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-653-0351|" calls USNO from within the |
| | 202 area code 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|" |
| | 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 speci- |
| | fied period (2 seconds for most modems) before |
| | continuing to dial. Example: "ATDT9,653- |
| | 0351|" calls USNO from the Washington area, |
| | first dialing "9" then waiting briefly to dial |
| | outside a local telephone network. |
+--------------+------------------------------------------------+

Table 4. Modem Dialing Commands

Page 8
"UTC Offset" specifies an adjustment to the time supplied by NIST
or USNO 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".

The "Service" parameter specifies whether the NIST or USNO atomic
clock is called to obtain the date and time. If either service
is a local call, select that service (and change the "Dial"
parameter), to save telephone charges. If both are long-distance
calls, NIST is recommended, as the NIST lines are seldom all
"busy".

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 /Sn (SPEED) switch should be used only if you have a 300-bps
modem or if you have a nonstandard modem that requires a fixed
DTE (PC-to-modem) speed other than the default of 1200 bps. The
NIST system is limited to 300 or 1200 bps, and the USNO system is
limited to 1200 bps. If you have a 300-bps modem, configure
PCCLOCK to use this speed by specifying the switch "/S300", and
set the "Service" parameter to "NIST". If you have a nonstandard
modem that requires a fixed DTE speed other than 1200 bps,
configure PCCLOCK to use the required speed using this switch.

The /I and /P (INT and POLLED) switches specify which of two
methods PCCLOCK uses to communicate with your modem. /I or INT
selects the "interrupt-driven" method; /P or POLLED selects the
"polled" method. See note below for details.


Important Note
--------------

Some PCCLOCK users have reported that the interrupt-driven
serial I/O mechanism, built into the programming language in
which PCCLOCK is written, does not work properly with their
modems. Therefore, PCCLOCK includes an alternative polled
serial I/O mechanism. If interrupt-driven serial I/O does
not work with your modem, please try polled serial I/O. If
neither works properly, please contact the author for
assistance.


Page 9
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 or AUTO
command-line switch. Commands sent to your modem by PCCLOCK,
result codes returned by the modem, and data received from NIST
or USNO are displayed 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, the call is terminated, and the
window is closed. 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.

If the call is not successfully placed, a modem result code (for
example, "BUSY") will be displayed. Press to cancel the
call, and, if you wish, press or to try again.

If the data received from NIST or USNO is not valid, an error
message will be displayed, and PCCLOCK will remain online until
it receives valid data, until a timeout period of 90 seconds is
exceeded, or until you press to cancel the call.

The /A or AUTO switch causes PCCLOCK to run in a non-interactive
automatic timesetting mode. When this switch is 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 or AUTO switch from the
AUTOEXEC.BAT file. To set the date and time every time you
restart your computer, add the command "pcclock /a" to
AUTOEXEC.BAT. Assuming you restart your computer at least once a
day, you can set your clock once a week by adding the command
"pcclock /a:7" to AUTOEXEC.BAT.

When /A or AUTO is used, PCCLOCK displays a message indicating
the success or failure of the call to NIST or USNO. 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" below for detailed
explanations.

To set the date or time manually, press either (Set Date) or
(Set Time), and follow the displayed instructions.


About the Atomic Clocks
-----------------------

The time services accessed by PCCLOCK are operated by the
National Institute of Standards and Technology (NIST, formerly

Page 10
NBS, National Bureau of Standards) in Boulder, Colorado, and the
U.S. Naval Observatory (USNO) in Washington, D.C. The NIST
service is directly synchronized to UTC(NIST), the primary time
and frequency standard for the United States. The USNO service
is synchronized to the USNO Master Clock, which is itself
synchronized to UTC(NIST).

Both the NIST and USNO services operate at a speed of 1200 bps;
the NIST service also operates at 300 bps. If you have a 2400-
bps or faster modem, it will connect with NIST or USNO at 1200
bps. If you have a 300-bps modem, you must use the NIST service,
and your modem will connect at 300 bps.

Although the signal from NIST or USNO arrives at your modem
within a few milliseconds of the correct 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, its 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.

Calls to either NIST or USNO usually take only a few seconds
and always take less than a minute. Calling either service long-
distance costs very little (13 to 24 cents from Boston using
AT&T). The cost of calling both services long-distance from a
given location is generally the same, but you may want to check
with your long-distance carrier or call both services at the same
time of day and check your bill.

+-----------+---------------------------------------------------+
| Exit Code | Corresponding Error Message |
|===========+===================================================|
| 0 | None |
|-----------+---------------------------------------------------|
| 1 | Internal error - PCCLOCK aborted |
|-----------+---------------------------------------------------|
| 2 | Error :\PCCLOCK.DAT - |
| | |
|-----------+---------------------------------------------------|
| 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 cancelled by |
| | operator |
|-----------+---------------------------------------------------|
| 6 | Date and time not set - Serial I/O error n |
|-----------+---------------------------------------------------|
| 7 | Date and time not set - Response timeout |
+-----------+---------------------------------------------------+

Table 5. Exit Codes



Page 11
About Your Computer's Clock(s)
------------------------------

DOS maintains a "system date" and "system time", which can be
read and set with the DOS DATE and TIME commands. The system
date and time settings are lost whenever your computer is powered
off and must be reset each time the computer is restarted.

Most computers have a battery-operated "permanent clock" that
keeps the date and time when the computer is turned off. IBM PC
AT, AT-compatible, and newer computers have these clocks built-
in. Other computers may be equipped with an add-on clock that
plugs into an expansion slot or with a "slotless" clock that
plugs into a socket under a ROM chip or other socketed chip on
the computer's motherboard.

If your computer has no permanent clock, you need to set the date
and time every time you restart your computer. You can make this
less tedious by running PCCLOCK from your AUTOEXEC.BAT file and
using either its automatic or manual timesetting functions.

If your computer does have a permanent clock, the system date and
time are set from the permanent clock when the system is
restarted. With a built-in clock, this is done automatically.
With an add-on or slotless clock, you may need to run a program
from AUTOEXEC.BAT; refer to the documentation supplied with the
clock. If you also run PCCLOCK from AUTOEXEC.BAT, PCCLOCK
should, of course, be run following this program.

If your computer has a built-in permanent clock, setting the date
and/or time with PCCLOCK will set the permanent clock as well as
the system date and time, regardless of the version of DOS you
are using. (Prior to DOS version 3.3, the DOS DATE and TIME
commands set only the system date and time, not the permanent
clock.)

Some add-on and slotless permanent clocks come with a device
driver that sets the permanent clock whenever the system date or
time is set. If you have such a device driver installed, setting
the date or time with PCCLOCK will also set the permanent clock.
If not, after setting the system date and/or time with PCCLOCK,
you will need to run the program supplied with your clock to set
it as well.


Notes for NetWare and Windows Users
-----------------------------------

Novell NetWare users can set their file server's date and time to
the NIST or USNO atomic clock by using PCCLOCK in conjunction
with S2S, a free utility written by PCCLOCK user and network
administrator Barry Brevik. First PCCLOCK is run on a
workstation, then S2S is used to set the file server's clock to
the workstation's clock. S2S can be downloaded from CompuServe's
NOVUSER forum library 1 as file S2S100.ZIP or from ZiffNet's
UTILFORUM library 15 as S2S.ZIP. For further information on S2S
and other NetWare utilities, contact Barry at 711 Calle Cardo,

Page 12
Thousand Oaks, CA 91360, by CompuServe mail to 70132,2277, or by
Internet mail to [email protected]

Although PCCLOCK is not designed to run under Microsoft Windows,
many Windows users run PCCLOCK under Windows successfully. For
best results, run PCCLOCK full-screen. When run in a window,
errors often occur when using polled serial I/O (/P or POLLED
switch). When run in the background, the time display often
lags, and the chime and alarm are unreliable, regardless of the
background priority.


Error Messages
--------------

Date and time not set - Call cancelled by operator

PCCLOCK was run with the /A (AUTO) switch, and the operator
cancelled the call to NIST or USNO by pressing .

Date and time not set - Call not due for m more day(s)

PCCLOCK was run with the /An (AUTO:n) switch, and n days have
not elapsed since the last successful call to NIST or USNO. If
you continue to run PCCLOCK with the same /An switch each day,
PCCLOCK will set your clock in m more days.

Date and time not set - Response timeout

PCCLOCK did not receive an initial response from your modem
within one second or did not receive valid data from NIST or
USNO within 90 seconds. If PCCLOCK received a "BUSY" response,
try again later. If "NO ANSWER", check the "Dial"
configuration parameter. Otherwise, make sure the power to
your modem is on, and verify that the "Serial Port" and "Init"
configuration parameters are set correctly (see "Configuration"
above).

Date and time not set - Serial I/O error n

PCCLOCK was unable to successfully communicate with your modem.
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 -

PCCLOCK was unable to read its configuration file upon start-up
or create and/or write it upon exiting. 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.




Page 13
Internal error - PCCLOCK aborted

PCCLOCK detected an error in the internal structure of the
PCCLOCK.EXE file, which may be corrupted. Try reinstalling
PCCLOCK.EXE from diskette or from the .ZIP file. If the error
persists, please contact the author.

Invalid data received - Retrying . . .

The preceding NIST data string was not in the correct format,
and PCCLOCK is staying on-line until another data string is
received. Usually due to a noisy phone connection. Possibly
due to incorrect modem "Init" commands (see "Configuration
above).

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 can not operate in 40-column modes. Use the DOS MODE
command to select an 80-column display mode, then rerun
PCCLOCK.

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 NIST or USNO 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 14
Revision History
----------------

New features implemented in PCCLOCK version 3.0 include:

1. Option to call USNO rather than NIST clock.

2. /An (AUTO:n) switch to set clock every n days.

3. Chimes every 15 minutes as well as on the hour.

4. and aliases for and .

5. Addition of Newfoundland time zone and replacement of Yukon,
Alaska-Hawaii, and Bering time zones with Alaska and Hawaii-
Aleutian time zones.

6. Support for "UTC Offset" in hours and minutes as well as
whole hours.

7. Support for MDA and Hercules displays, including monochrome- and
grayscale-specific clock designs and /C, /G, and /M switches.

8. Improved color clock designs.

9. Support for alternate COM3 and COM4 addresses, and for COM5-8
on MCA-bus machines.

10. Support for 300-baud, Telebit, and other atypical modems:

a. /Sn (SPEED:n) switch to set PC-to-modem line speed.

b. Ability to call NIST at 300 as well as 1200 bps.

c. Output of embedded blanks in modem commands.

d. "{" in modem commands to send break signal.

11. /? (HELP) switch to display summary of command-line switches.

12. Single-character switches and optional "/" and "-" prefixes.

13. Improved error handling and error messages:

a. Exit code set to reflect outcome of call.

b. Shortened timeout for modem not responding.

c. Added "Response timeout" error message.

d. Added "" to "Date and time not set" messages.

14. Redesigned online registration to accept credit card and SWREG
payment.




Page 15
Problems corrected in PCCLOCK version 3.0 include:

1. Compatibility problems with DOS 2.1 and 2.1x and with some TSRs and
memory managers.

2. Problems whereby interrupt-driven I/O sometimes failed to
correctly process "~" and "|" in modem commands.

3. Errors recognizing the first few hours of DST and ST.

4. A problem whereby the date and time display was "invisible"
when some BIOS versions were used.

5. A problem whereby an "*" in a modem command resulted in an
erroneous "Invalid data received" message.

6. Problems using interrupt-driven I/O with 16550A UARTs.

Functional differences between PCCLOCK 3.0 and previous versions
include:

1. Command-line switches /I (INT) and /P (POLLED) are used to
select interrupt-driven or polled serial I/O, rather than
the "Serial I/O" configuration parameter or the
key used with previous versions.

2. Running PCCLOCK with the /A (AUTO) switch sets the exit code
rather than creating or deleting file PCCLOCK.ERR. In a
batch file, use "IF ERRORLEVEL . . ." rather than "IF EXIST
PCCLOCK.ERR . . .".


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 find PCCLOCK to be useful or enjoyable and continue to use
it 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.

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.

Page 16
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 is accompanied by this user's guide. A reasonable
fee may be charged for media, copying, and shipping and handling
or for transmission time.


How to Register
---------------

To become a registered PCCLOCK user, run PCCLOCK, press to
exit, and follow the displayed instructions.

If no printer is available, or if 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 (5.25" or 3.5"). For
direct orders, shipping and handling is free. Payment must be by
cash, check, money order, or postal money order, and in U.S.
dollars. Checks and money orders must be drawn on a U.S. bank.


Special Discounts for Registered Users
--------------------------------------

Registered users of PCCLOCK are eligible to receive:

* Free membership in CompuServe, a leading online information
service, including user ID and password, a $15 usage credit,
and a subscription to "CompuServe Magazine". Among other
benefits, CompuServe membership enables you to locate and
download thousands of shareware and public domain programs and,
in many cases, obtain support directly from the programs'
authors via electronic mail.

* A one-year subscription to "Shareware Magazine", regularly
$19.95, at the special rate of $14.95. Features news and
reviews of low-cost, quality PC and Macintosh software, plus
regular columns for beginners and shareware programmers.
Edited by Mike Callahan, author of the best-selling book "Dr.
File Finder's Guide to Shareware".

* The latest issue of the "JCSM Shareware Collection" CD-ROM, or
an additional issue if a subscriber, for $9.95, half the
regular price, plus shipping and handling. This CD-ROM
contains over 2000 up-to-date shareware programs from nearly
1000 authors and features an easy-to-use indexing and retrie
system.

* Public (software) Library's "Source Book of Free and Low-Cost
Software" plus six reviews disks for $13.40, 33% off the
regular price of $19.95, plus $5 shipping and handling. With
nearly 1000 pages of descriptions of the more than 7000
programs that make up the world's largest collection of

Page 17
shareware and public domain software, "PC Magazine" calls it
"by far the most thorough and reliable guide to shareware
available anywhere". Reviews disks include full text of book
plus updates.

* A one-year subscription to "PsL News", Public (software)
Library's catalog/magazine for $12, regularly $18. "PsL News"
reviews hundreds of new and updated programs each month and
serves as a companion to PsL's "Source Book". John Dvorak of
"PC Magazine" says, "Do yourself a favor and subscribe to this
gem . . . pays for itself in software discoveries".

* An introductory issue of PsL's monthly shareware CD-ROM for
$5.95, 70% off the regular price of $19.95, with your
subscription. Each CD contains all of the hundreds of new and
updated programs added to PsL's collection during the past
month plus a number of bonus programs. Future issues are
$19.95, shipping and handling are $4 per issue, and
subscriptions may be cancelled at any time.

Complete instructions on how to take advantage of any or all of
these offers is in included in the printed user's guide you
receive when you register your copy of PCCLOCK.


Bypassing the Registration Reminder Screen
------------------------------------------

Registered users may bypass the registration reminder screen
normally displayed when PCCLOCK is exited. Instructions for
bypassing the screen are given in the printed user's guide sent
to registered users.


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
CompuServe, GEnie, Internet, or U.S. 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, or via CompuServe mail to

Page 18
75046,2272, GEnie mail to M.SADAWAY1, or Internet mail to
[email protected] Thank you.


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 better than a
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.

Shareware bearing the ASP name is fully functional, not a
stripped-down or demo version, and all features of the program
are described in the documentation, so you can fully evaluate the
software before you pay for it. 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.













Page 19
_______
____|__ | (R) Michael J. Sadaway
--| | |------------------ P. O. Box 128-P
| ____|__ | Association of South Walpole, MA 02071
| | |_| Shareware CompuServe: 75046,2272
|__| o. | Professionals GEnie: M.SADAWAY1
-----| | |-------------------- Internet: 75046,2272
|___|___| MEMBER @compuserve.com


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.


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 20


 December 27, 2017  Add comments

Leave a Reply