Category : Communication (modem) tools and utilities
Archive   : SC40.ZIP
Filename : SC40.DOC

Set-Clock

Version 4.0






Users Guide
















by



Terry Dutcher
P.O. Box 59458
Potomac, MD
20859








15 September 1992

/.\
Table of Contents

License . . . . . . . . . . . . . . . . . . . . . . . . iii
Some Thoughts on Shareware . . . . . . . . . . . . . . . v

1. Introduction . . . . . . . . . . . . . . . . . . . . 1
1.1 Set-Clock Overview . . . . . . . . . . . . . . 1
1.2 What's Here . . . . . . . . . . . . . . . . . . 1
1.3 What's New . . . . . . . . . . . . . . . . . . 2
1.4 How It Works . . . . . . . . . . . . . . . . . 2
1.5 Registration . . . . . . . . . . . . . . . . . 3
1.6 Support Policy. . . . . . . . . . . . . . . . . 3

2. The CLKSET program . . . . . . . . . . . . . . . . . 4
2.1 CLKSET Overview . . . . . . . . . . . . . . . . 4
2.2 Using CLKSET . . . . . . . . . . . . . . . . . 4
2.2.1 The No Daylight Savings (/nd) Switch . . 4
2.2.2 The lto (Local Time Offset) Parameter . 5
2.2.3 The Time Source String . . . . . . . . . 5
2.3 The Shareware Notice . . . . . . . . . . . . . 5
2.4 Messages . . . . . . . . . . . . . . . . . . . 6
2.4.1 Normal Messages . . . . . . . . . . . . 6
2.4.2 Error Messages . . . . . . . . . . . . . 6

3. The Configuration File and Program . . . . . . . . . 8
3.1 The Configuration File . . . . . . . . . . . . 8
3.2 CFG-SC Overview . . . . . . . . . . . . . . . . 8
3.3 Using CFG-SC . . . . . . . . . . . . . . . . . 9

4. Set-Clock and Procomm Plus V1 & V2 . . . . . . . . . 10
4.1 Setup . . . . . . . . . . . . . . . . . . . . . 10
4.2 Invocation . . . . . . . . . . . . . . . . . . 10

5. Set-Clock and Procomm Plus for Windows . . . . . . . 11
5.1 Setup . . . . . . . . . . . . . . . . . . . . . 11
5.2 Invocation . . . . . . . . . . . . . . . . . . 11

6. Set-Clock and Qmodem . . . . . . . . . . . . . . . . 12
6.1 Setup . . . . . . . . . . . . . . . . . . . . . 12
6.2 Invocation . . . . . . . . . . . . . . . . . . 12

7. Set-Clock and Telix . . . . . . . . . . . . . . . . 13
7.1 Setup . . . . . . . . . . . . . . . . . . . . . 13
7.2 Invocation . . . . . . . . . . . . . . . . . . 13

8. Using Set-Clock with Windows . . . . . . . . . . . . 14

Appendix 1 - An Explanation of USA Standard Times . . . 15
Appendix 2 - What's in the NAVNIST.ZIP file . . . . . . 17
Appendix 3 - What's in the GOODIES.ZIP file . . . . . . 18

Registration Form . . . . . . . . . . . . . . . . . . . 19

Set-Clock, CLKSET and CFG-SC are Copyright (C) 1989-92 by Terry
Dutcher, All Rights Reserved. No parts of Set-Clock, CLKSET,
CFG-SC or this document may be copied, except as provided
in the following License.

ii
/.\

Shareware License

Unless otherwise noted, the term Set-Clock refers to the
combination of the Set-Clock script file(s) and the CLKSET
and CFG-SC programs. Set-Clock V4.0 is not public domain or
free software, but is distributed as "Shareware." The
programs are LICENSED, not sold. Nothing in this agreement
shall be construed as conveying title in the licensed
programs to the user.

The author grants non-registered users a 15 day limited
license to "try out" the software on a private, non-
commercial basis, for the express purpose of determining if
Set-Clock is suitable for their needs. If, at the end of
this period, you continue to use the programs, you must pay
the $7.50 registration fee for a full single user license.
This license allows you to; use the programs, make as many
complete copies of the programs and documentation as you
wish for yourself and others, and to distribute the programs
and documentation via electronic or other means. If you do
not register your copy you must discontinue using Set-Clock.

The license does not allow you to; sell the programs or any
modification of them, request donations for distribution of
the programs or in any other way try to make money from Set-
Clock. You may not remove this notice. If you do give away
copies of Set-Clock, you must distribute the unaltered
programs and documentation together in their entirety.

Operators of electronic bulletin board systems (SYSOPS) are
encouraged to post Set-Clock for downloading by users. If
you are a distributor of public domain or user-supported
software, you may distribute Set-Clock. A fee of not to
exceed $5 per disk may be charged for copy service, handling
and materials.

The author has taken due care in the preparation of this
document and the accompanying programs including research,
development and testing to ascertain their effectiveness.
The author makes no warranty, expressed or implied of any
kind with regard to the programs or documentation. In no
event shall the author be liable for incidental or
consequential damages in connection with or arising out of
the furnishing, performance or use of these programs.

Set-Clock is provided "AS IS" without warranty of any kind,
either expressed or implied, including, but not limited to,
the implied warranties of merchantability and fitness for a
particular task. The entire risk as to the quality and
performance of Set-Clock is with the user. The author does
not warrant that the operation of Set-Clock will be
uninterrupted or error free.

In no event will the author be liable for any damages,
including lost profits, lost savings or other incidental or
consequential damages arising out of the use or inability to

iii
/.\

use Set-Clock even if the author has been advised of the
possibility of such damages, or for any claim by any other
party.

Your continued use of Set-Clock beyond the fifteen day trial
period, with or without registration, acknowledges that you
have read this agreement, understand it and agree to be
bound by its terms and conditions. You further agree that
it is the complete and exclusive agreement between yourself
and the author which supersedes any prior agreement, oral or
written, and any other communications between the author and
yourself relating to the subject matter of this agreement.





































Procomm is a registered trademark of Datastorm Technologies
Inc.

Qmodem is a registered trademark of Mustang Software, Inc.

Telix is a registered trademark of Exis Inc.


iv
/.\


Some Thoughts on Shareware

Just because Shareware is low priced doesn't mean it's low
quality. Of the $500 you paid for that commercial package,
the R&D and programming costs probably came in at about $50.
With Shareware, you don't pay for the glitzy package,
advertising, and high cost distribution methods.

Why bother to register? Why pay for it? The Shareware
author has the right to be paid for his efforts. Shareware
is not free. If you "buy" a disk full of software for $4 or
whatever, all you paid for was the disk and someone's time
to get the collection together. Many programmers make their
living via Shareware. The license fee/registration you pay
is their paycheck.

The Shareware authors who are dedicated to the REAL concept
of Shareware probably won't mind if you sent $5 or $10
instead of the $15 suggested. Understand however, if you're
expecting the author to spend hours guiding you through
problems you're having, he may be reluctant without "full"
payment. Remember, if it's REALLY not worth anything then
you probably wouldn't be using it.

You can tell good software from junk software. There are a
lot of responsible programmers out there who keep up with
their customers. Registration also allows them to let you
know when there are bugs found and corrected, enhancements,
and upgrades.

The author of Set-Clock and CLKSET intends for them to be
"good" software. To that end, he would like to hear from
anyone that has a comment or suggestion. Even if you don't
register your copy, please print the SEND-ME.IN file, fill
in the blanks, and drop it in the mail. The people who did
so for Versions 2.7 and 3.1 made the leap to 4.0 possible,
and so it goes.

Commercial users wanting a site license and resellers /
integrators that wish to incorporate Set-Clock or CLKSET into
other packages must contact the author for license terms.




Honor Role

Ray Moreau, Greg Sigler, Thomas Gross, Rick Shaw, Robert
Perrault, Harry Myers III, Steve Siwek, Leslie Clark, John
Dove, Jim Goldschmidt






v
/.\
1. Introduction

There has been a proliferation of programs that call and get
the time. Some have not correctly dealt with COM ports or
clones. Some take up large amounts of disk space. The list
goes on. Set-Clock overcomes these by using your
communications program as the front end. Unlike most time
setting programs, Set-Clock lets you use PC-Pursuit instead
of a long distance call to access the time signal source.

Set-Clock was first written for PCs that did not have a
built in battery backed up (i.e. AT style) clock. When used
with a PC of that type, it can be placed in the Autoexec
file to set the DOS date and time every time the machine is
booted. In machines that do "keep time" you may wish to use
it once a month or so to correct time drift. See the
chapter on your comm program for more details.

Set-Clock is not intended to be something that will set the
DOS time and date to exactly that of the Atomic Clock, but
rather something that gets you in the ball park. For most,
the correct time within a few seconds will do. For those
who wish a more precise time, other software must be used.

Set-Clock V4.0 was developed using Procomm Plus Versions
1.1B and 2.01, Procomm Plus for Windows Version 1.0, Telix
Version 3.15, and Qmodem Version 4.5.

1.1 Set-Clock Overview

This document gives you all the information you need to get
Set-Clock up and running on your computer. Chapter one is
an overview of Set-Clock distribution. Chapter two
documents the CLKSET routine. Chapter three tells about the
new configuration program. Chapters four through seven
detail the use of Set-Clock with the different
communications programs. Chapter eight gives instructions
on installing Set-Clock under Windows with your DOS comm
program. Appendix 1 tells about time zones and daylight
savings time. Appendix two and three document the NAVNIST
and GOODIES zip files. Users are encouraged to read this
chapter and then the one specific to their communications
program. Come back later and read the rest for more detail.

1.2 What's Here

As distributed, the Set-Clock Version 4.0 archive contains
27 files:

READ.ME - The quick start guide to Set-Clock
SEND-ME.IN - The registration form for Set-Clock
SC40.DOC - What you are reading
CLKSET.EXE - The Clock Setting program
CLKSET.PIF - Windows 3.1 PIF file for CLKSET
CFG-SC.EXE - The Configuration program
CFG-SC.PIF - Windows 3.1 PIF file for CFG-SC


1
/.\
SC40P1.ASP - Set-Clock for PCPLUS V1
SC40P1.PIF - and its' PIF file
SC40P1-P.ASP - PC-Pursuit Set-Clock for PCPLUS V1
SC40P1-P.PIF - and its' PIF file
SC40P2.ASX - Set-Clock for PCPLUS V2
SC40P2.PIF - and its' PIF file
SC40P2-P.ASX - PC-Pursuit Set-Clock for PCPLUS V2
SC40P2-P.PIF - and its' PIF file
SC40PW.WAX - Set-Clock for PCPLUS/Win
SC40PW-P.WAX - PC-Pursuit Set-Clock for PCPLUS/Win
SC40Q.SCR - Set-Clock for Qmodem
SC40Q.PIF - and its' PIF file
SC40Q-P.SCR - PC-Pursuit Set-Clock for Qmodem
SC40Q-P.PIF - and its' PIF file
SC40T.SLC - Set-Clock for Telix
SC40T.PIF - and its' PIF file
SC40T-P.SLC - PC-Pursuit Set-Clock for Telix
SC40T-P.PIF - and its' PIF file
NAVNIST.ZIP - Info from the Naval Observatory and NIST - ACTS
GOODIES.ZIP - Some "extra" goodies

When you pass Set-Clock on to a friend or another BBS, all
these files must be included.


1.3 What's New

Here is what happened to transform Version 3.1 into Version
4.0. The biggest change was to add the ability to create
the configuration file while running Set-Clock. Users no
longer have to use an editor to set up this file but instead
should use the configuration program CFG-SC. If Set-Clock
can not find the configuration file it will attempt to
invoke CFG-SC on the fly. CFG-SC will display a sample file
and allow the user to enter the necessary data.

Another change is the ability to get the time signal from
the National Institute of Standards and Technology clock in
Bolder CO. If you call long distance this may be a cheaper
option. The NIST clock is also accessable via PC-Pursuit.
Information on the NIST - ACTS is available in the
NAVNIST.ZIP file.

1.4 How It Works

Set-Clock is implemented as a combination of script file and
external program that work in conjunction with your existing
communications program. By taking advantage of the fact that
it doesn't have to worry about how to talk to a com port,
dial a modem, etc. it stays small and only concerns itself
with getting the date/time string and setting the PC's time
and date.

The Set-Clock script is the shell that gets the date/time
string and builds the command line for CLKSET. CLKSET then
takes over, parses the line, and sets the time and date
directly via DOS interrupts.

2
/.\
Setup and use of Set-Clock with each of the different
supported communications programs is explained in its own
section.

Set-Clock has been tested under Windows 3.1. You can create
an icon that will run Set-Clock using the correct command
line for your program or use one of the included PIF files.
Set-Clock can also be launched manually while you are using
the program under Windows. Remember that your program will
exit after Set-Clock completes. See chapter eight for
details.


1.5 Registration

A Set-Clock registration licenses the user to use the
product on a regular basis. Users need register only one
version of Set-Clock, registration includes licensed use of
all upgrades. Registered users can always get the most
current version by sending a blank floppy and self addressed
stamped envelope (big enough to hold the floppy, of course)
to the author. The latest version will also be available on
the "official distribution BBS":

The Herndon Byte eXchange (HBX) Veterans Memorial Gateway (VMG)
Herndon VA (703)471-8010

If you purchased Set-Clock through a distributor of public
domain or user-supported software, you did NOT pay for the
license. The fee was to cover the costs of copying the
disk(s), the media and handling overhead. That is, you paid
for the vendors service. Registration for Set-Clock costs
$7.50 and assumes you have already received a copy of the
programs from whatever source.

When you register, you will receive by return mail,
instructions on how to remove the shareware reminder notice
from CLKSET. You will also get a User Certificate and, for
Procomm and Telix users, a source code listing of the
compiled script you are using. Printed copies of this
documentation are also available for an modest fee.


1.6 Support Policy

The nature and pricing of Set-Clock makes the author unable
to provide telephone support for users. Every attempt will
be made to address questions left on the official
distribution BBS in an appropriate and timely manner.
Questions may also be addressed to the author by US Mail.
However, this support will be on a when-time-is-available
basis and the author is NOT responsible to provide support
in any form to non-registered users. Information will be
posted on the distribution BBS when it becomes available as
well as bug fixes or patches. Upgrades to Set-Clock will be
made when appropriate to improve, enhance or correct the
product.

3
/.\
2. The CLKSET Program

CLKSET is a routine that sets the time and date on your PC.
It is a shareware product. CLKSET is not and never has been
in the public domain. If you use it, please register it.
Registered users will be given a key to disable the
shareware notice. Sharing with friends is encouraged, but
when a copy is passed out it must be the complete package,
including the unaltered CLKSET, CFG-SC, Set-Clock scripts,
and documentation.

2.1 CLKSET Overview

CLKSET has the ability to set the DOS time and an AT class
CMOS clock. While it was developed to be used in
conjunction with the Set-Clock script, it may be invoked
directly from the DOS command line as explained in the
following section.

CLKSET automatically adjusts for daylight savings time as
practiced in the United States. This feature may be
overridden by a command line switch if the user is in an
area that does not use this sunlight conservation method
(Arizona comes to mind).

2.2 Using CLKSET

CLKSET is invoked by the shell script (or by hand) using the
following DOS command line:

clkset [/nd] lto t_s_s

where

CLKSET - is the name of the routine
/nd - is a switch that disables the automatic daylight
savings time processing
lto - is the local time offset from UTC
t_s_s - is the time source string received from NIST - ACTS
or the Naval Observatory

The switch is optional and not case sensitive. You may test
CLKSET with your computer by manually issuing the following
command line:

clkset /nd 0 48866 245 000000 x

This should set your computers time and date to midnight of
September 1, 1992 and may be checked by the DOS time and
date commands.

2.2.1 The No Daylight Savings (/nd) Switch

CLKSET correctly finds the first Sunday in April and the
last Sunday in October and adjusts the time forward by one
hour if the current date falls in between. Use the /nd
switch if you are in an area that doesn't "do" daylight

4
/.\
savings time. This is true in certain parts of the US and
other countries. An explanation of how daylight savings
time works in the US, a list of US time zones, and other
useful information can be found in Appendix 1.

2.2.2 The lto (Local Time Offset) Parameter

lto is how many hours need to be added or subtracted from
Universal Time to get to your time zone. For example,
Chicago is 6 hours BEHIND Universal Time, most of Europe is
2 hours AHEAD of Universal time. lto is assumed to be a
negative number (i.e. your time zone is to the west of
England). If you put a minus on the command line
immediately preceding lto then that number of hours will be
ADDED to the time (minus a minus is a plus). See some of
the files in NAVNIST.ZIP or Appendix 1 for more coverage on
the subject of Universal Time and time zones.

Time Zone | Local Time Offset
-----------+-------------------
Eastern | 5
Central | 6
Mountain | 7
Pacific | 8

When figuring out what number to use for lto, DO NOT count
the daylight savings time effect (CLKSET will perform that
calculation on its own) unless you are going to use the /nd
switch.

2.2.3 The Time Source String

The time source strings generated by the Naval Observatory
and the NIST - ACTS are slightly different. The Naval
Observatory string is of the form;

MJD DOY HHMMSS UTC OTM

while the NIST - ACTS string looks like;

MJD YR-MN-DY HH:MM:SS blah blah UTC(NIST) OTM

MJD is the modified julian date (start with 47892 and add 1
for every day past January 1, 1990.) DOY is the day of the
year (commonly refered to as julian date). OTM is the on
time mark, usually an asterisk. Therefore, the test case in
Section 2.2 had a modified julian date of 48866, the 245th
day of the year, and an hour/minute/second of midnight. More
information on the modified julian date and other components
of the string can be found in the files in the NAVNIST.ZIP
archive.

2.3 The Shareware Notice

CLKSET is designed with a reminder that it is shareware. It
has a simple notice that is displayed after the time and
date have been set that prompts you to register. Users who

5
/.\
have paid the $7.50 will be sent a "key" to "lock up" the
notice so that it does not get displayed. Please take the
time to print off the registration form and send it in along
with any comments or suggestions. Thanks.


2.4 Messages

This section lists all the messages that CLKSET can produce.


2.4.1 Normal Messages

CLKSET V4.0, Copyright (C) 1992 Terry Dutcher, All Rights Reserved.
This is an [registered / unregistered] copy.

- This is the banner that is printed when CLKSET starts.


CLKSET -- Time and Date set to:
HH:MM:SS MM/DD/YYYY

- This is the message printed as CLKSET exits.


If you find Set-Clock and CLKSET useful, a registration fee of
at least $7.50 would be appreciated. When you register,
instructions on how to remove this notice will be sent to you
by return mail.

Please send check or money order to:

Terry Dutcher
P.O. Box 59458
Potomac, MD 20859

- This is the shareware message that can be disabled when you
register.


2.4.2 Error Messages

Usage: clkset [/nd] lto time_source_string

- There are too few arguments on the command line.


CLKSET -- Invalid command line switch >XXX<.

- There is an unrecognized switch on the command line.


CLKSET -- Invalid LTO. >NN<

- The local time offset is not in the -23 to +23 range.



6
/.\


CLKSET -- Invalid MJD. >NNNNN<

- The modified julian date is not for a valid year (1992-99).


CLKSET -- Invalid DOY. >NNN<

- The day of year is not in the 1 to 366 range.


CLKSET -- Invalid GMT. >NNNNNN<

- The gmt is not in the 000000 to 235959 range.


CLKSET -- Year out of range or MJD >NNNNN< not in sync with DOY >NNN<.

- The mjd is for a year outside of the range 1992-99 or (mjd
- doy) does not give a mjd in the 1992-99 range.


CLKSET -- Year not in range. >NN<

- The year is outside of the range 1992-99.


CLKSET -- Invalid hour. >NN<

- The hour is not in the 0 to 23 range.


CLKSET -- Invalid minute. >NN<

- The minute is not in the 0 to 59 range.


CLKSET -- Invalid second. >NN<

- The second is not in the 0 to 59 range.


CLKSET -- Invalid YY-MM-DD. >NN<

- The year/month/day string is inconsistent.












7
/.\

3. The Configuration File and Program

This section tells you about the Set-Clock configuration
file and the configuration file editor.

3.1 The Configuration File

The configuration file is called SC40.CFG (SC40-P.CFG for
PC-Pursuit users.) The operation of Set-Clock is controlled
by this file. It keeps the phone number of the time signal
source, the first part of the CLKSET command line, and the
name of the time signal source. Reconfigure Set-Clock by
changing these lines. A sample file follows;

202-653-0351 ;Naval Observatory (or NIST ACTS) number
clkset 5 ;clkset command w/ east coast offset
navy ;which time signal source

The first line in the file is the phone number. It should
include and dialing codes or prefixes as necessary. NOTICE,
TELIX users must have an "M" as the first character. Qmodem
users should put in the "tag" for the dialing directory
entry that holds the phone number.

The second line is the first part of the CLKSET command.
Include the /nd switch before the lto if desired. Modify
the lto to be correct for your time zone.

The third line is the time signal source. It will be either
"navy" or "nist". Just four characters in lower case.

The configuration file for the PC Pursuit version contains
slightly different information than the one for regular Set-
Clock as can be seen in the following sample.

202-459-7800 ;local SprintNet access #
UserId,Password ;PC Pursuit UserId and Password
clkset 5 ;clkset command w/ east coast offset
navy ;which time signal source

Instead of the time signal source phone number, the user's
local SprintNet access number is on the first line. The
second line holds the user's PC Pursuit ID and password.
(Use only a comma to separate these fields). Set-Clock uses
this information to generate the "C D/DCWAS/12,User-
ID,Password" or "C D/CODEN/12,User-ID,Password" string that
connects you to the DC or Denver modem bank. The third line
contains the first part of the CLKSET command line and the
fourth the time signal source.

Use CFG-SC to create and maintain the configuration file.

3.2 CFG-SC Overview

CFG-SC is the routine that creates and/or modifies the Set-
Clock configuration file. It is shareware. CFG-SC is not

8
/.\
and never has been in the public domain.

When Set-Clock is run, it checks for the existance of the
configuration file. If the file is not found it looks for
the configuration program CFG-SC.EXE. If that is not found
Set-Clock exits with a fatal error message. If the program
is there Set-Clock will attempt to create the configuration
file by running it.

3.3 Using CFG-SC

You may modify your configuration file at any time using
CFG-SC. It takes the following command line:

cfg-sc comm_pgm [pursuit]

where

CFG-SC - is the name of the program
comm_pgm - is the name of your communication program
(Procomm, Qmodem, Telix)
pursuit - is an optional flag to indicate you are a PC-
Pursuit user (the word pursuit IS the flag)

A sample configuration file is displayed along with each of
the current entries in the file. The user is then given the
opportunity to change each entry. At the end, the user may
accept or reject the changes and save the entries to disk.

The Set-Clock script will automatically invoke CFG-SC if it
can not find the configuration file. It looks in the same
directory that your communications program is executing from
for both the file and the editor. CFG-SC only looks in the
current directory when reading or writing SC40[-P].CFG.
























9
/.\
4. Using Set-Clock with Procomm Plus V1 or V2

This section is for the DOS versions of Procomm Plus.

4.1 Setup

To use Set-Clock with Procomm Plus you need the following
executables from the distribution archive; CFG-SC.EXE and
CLKSET.EXE. Place them in the same directory as PCPLUS.EXE.

If you are using version 1.x then extract SC40P1.ASP. Users
of version 2.x should extract SC40P2.ASX. Put these files in
the directory where you keep your other script files.

If you live outside of the Washington DC (Naval Observatory)
or Denver CO (NIST - ACTS) local calling areas and would
like to use PC Pursuit instead of long distance then extract
SC40P1-P.ASP or SC40P2-P.ASX instead of the regular script.

4.2 Invocation

If you are using the PC Pursuit version of Set-Clock,
replace the SC40P[1/2] with SC40P[1/2]-P in the following
discussion.

Set-Clock is designed to be placed in your AUTOEXEC.BAT file
and is invoked via the /F switch when starting Procomm Plus.
Set-Clock uses Procomm Plus to manage the com port and modem
and fetch the date/time string. It builds the command line
and calls CLKSET to set the DOS (and CMOS) time and date.

The following is an example of what you might put in your
AUTOEXEC.BAT file;
.
.
CD \PCPLUS ;change to PCPLUS directory
PCPLUS /FSC40Pn ;invoke Set-Clock
.
.

You can call up Set-Clock at any point with the command
"PCPLUS /FSC40Pn" where "n" is 1 or 2 depending on your
version of Procomm. If you invoke Set-Clock when you are in
Procomm with the alt-F5 key, you will be dropped out to DOS
when it is finished.

It's that simple. Remember, put the shell script, CLKSET
and CFG-SC in the directory you normally run Procomm Plus
from. The script will only search the default (current)
directory for its config file and the CLKSET and CFG-SC
routines.

Setting the time on a machine that has a hardware clock that
is not supported by CLKSET is easy to do. Create a batch
file that invokes Set-Clock and then uses the manufacture's
software or another program to set the hardware clock from
the DOS time and date.

10
/.\
5. Using Set-Clock with Procomm Plus for Windows

This section is for the Windows version of Procomm Plus.

5.1 Setup

To use Set-Clock with Procomm Plus for Windows you need the
following executables from the distribution archive; CFG-
SC.EXE and CLKSET.EXE. Place them in the same directory as
PW.EXE. Extract SC40PW.WAX and put it in the directory with
your other script files.

If you live outside of the Washington DC (Naval Observatory)
or Denver CO (NIST - ACTS) local calling areas and would
like to use PC Pursuit instead of long distance then extract
SC40PW-P.WAX instead of the regular script.

Extract the PIF files for CLKSET and CFG-SC and put them in
the main windows directory or with your other PIFs.

Create an icon for Set-Clock by duplicating the PCPLUS/Win
icon in the PCPLUS/Win group. Modify the icon properties
(Alt+Enter) and; change the description to Set-Clock, add
" SC40PW.WAX" (or " SC40PW-P.WAX" for PC-Pursuit) after the
PW.EXE on the command line, and (if you wish) change the
icon. (Try the clock icon from the windows clock.exe file.)
Click OK and your in business.

Create a CFG-SC icon by duplicating an MS-DOS icon from the
Main program group. Modify its' properties as follows;
change the description to be CFG-SC (or something), change
the working directory to be the same one as for PCPLUS/Win,
change the command line to be "cfg-sc procomm" (sans quotes)
add pursuit to the line if you are a PC-Pursuit user, and
change the icon. (Try the swiss army knife from the
progman.exe file.) Click OK and you are done.

5.2 Invocation

Start Set-Clock by double clicking the icon you created for
it. Update the config file by double clicking on the CFG-SC
icon.

If you invoke Set-Clock when you are in Procomm, you will be
dropped out to the program manager when it is finished.

It's that simple. Remember, put CLKSET and CFG-SC in the
directory with the Procomm Plus for Windows executable and
the script in the script subdirectory. Set-Clock will only
search the executable directory for its' config file and the
CLKSET and CFG-SC routines.

Setting the time on a machine that has a hardware clock that
is not supported by CLKSET is easy to do. Create a batch
file that invokes Set-Clock and then uses the manufacture's
software or another program to set the hardware clock from
the DOS time and date.

11
/.\
6. Using Set-Clock with QMODEM

6.1 Setup

To use Set-Clock with QMODEM you need the following
executables from the distribution archive; CFG-SC.EXE and
CLKSET.EXE. Place them in the same directory as QMODEM.EXE.

Extract the Set-Clock script SC40Q.SCR and place it in the
directory with your other scripts.

If you live outside of the Washington DC (Naval Observatory)
or Denver CO (NIST - ACTS) local calling areas and would
like to use PC Pursuit instead of long distance then extract
SC40Q-P.SCR instead of the regular script.

Create a dialing directory entry for the Naval Observatory,
(202)653-0351, NIST - ACTS (303)494-4774, or your local
SPRINT pad. The com port should be set for 1200 baud with 7
bit even parity or 8 bit no parity. Do NOT link the Set-
Clock script (or any other script) to this entry. Note that
you will use the "tag" for this entry as the first line of
the configuration file.

6.2 Invocation

If you are using the PC Pursuit version of Set-Clock,
replace the SC40Q with SC40Q-P in the following discussion.

Set-Clock is designed to be placed in your AUTOEXEC.BAT file
and is invoked via the /S= switch when starting QMODEM.
Set-Clock uses QMODEM to manage the com port and modem and
fetch the date/time string. It builds the command line and
calls CLKSET to set the DOS (and CMOS) time and date.

The following is an example of what you might put in your
AUTOEXEC.BAT file;
.
CD \QMODEM ;change to QMODEM directory
QMODEM /S=SC40Q[-P] ;invoke Set-Clock
.

You can call up Set-Clock at any point with the command
"QMODEM /S=SC40Q[-P]". If you invoke Set-Clock when you are
in QMODEM with the alt-F key, you will be dropped out to DOS
when it is finished.

It's that simple. Remember, put the shell script, CLKSET
and CFG-SC in the directory you normally run QMODEM from.
The script will only search the default (current) directory
for its config file and the CLKSET and CFG-SC routines.

Setting the time on a machine that has a hardware clock that
is not supported by CLKSET is easy to do. Create a batch
file that invokes Set-Clock and then uses the manufacture's
software or another program to set the hardware clock from
the DOS time and date.

12
/.\
7. Using Set-Clock with Telix

7.1 Regular Setup

To use Set-Clock with Telix you need the following
executables from the distribution archive; CFG-SC.EXE and
CLKSET.EXE. Place them in the same directory as TELIX.EXE.

Extract the Set-Clock script SC40T.SLC and place it in the
directory with your other scripts.

If you live outside of the Washington DC (Naval Observatory)
or Denver CO (NIST - ACTS) local calling areas and would
like to use PC Pursuit instead of long distance then extract
SC40T-P.SLC instead of the regular script.

7.2 Invocation

If you are using the PC Pursuit version of Set-Clock,
replace the SC40T with SC40T-P in the following discussion.

Set-Clock is designed to be placed in your AUTOEXEC.BAT file
and is invoked via the /S switch when starting Telix. Set-
Clock uses Telix to manage the com port and modem and fetch
the date/time string. It builds the command line and calls
CLKSET to set the DOS (and CMOS) time and date.

The following is an example of what you might put in your
AUTOEXEC.BAT file;
.
CD \TELIX ;change to Telix directory
TELIX /SSC40T[-P] ;invoke Set-Clock
.

You can call up Set-Clock at any point with the command
"TELIX /SSC40T[-P]". If you invoke Set-Clock when you are
in Telix with the alt-F5 key, you will be dropped out to DOS
when it is finished.

It's that simple. Remember, put CLKSET and CFG-SC in the
directory you normally run Telix from and the Set-Clock
script with your other scripts. The script will only search
the default (current) directory for its config file and the
CLKSET and CFG-SC routines.

Setting the time on a machine that has a hardware clock that
is not supported by CLKSET is easy to do. Create a batch
file that invokes Set-Clock and then uses the manufacture's
software or another program to set the hardware clock from
the DOS time and date.








13
/.\
8. Using Set-Clock with Windows

Set-Clock can be used in a Windows environment. The
following paragraphs outline the steps you need to take to
create icons for Set-Clock and for the CFG-SC.

Follow the setup instructions in the chapter for your comm
program and make sure Set-Clock works correctly under DOS
first.

Extract the PIF files for CLKSET, CFG-SC and your comm
program. Put them in the main windows directory or with
your other PIFs. The Set-Clock PIF has the same name as the
Set-Clock script for your comm program.

Create an icon for Set-Clock by duplicating an MS-DOS icon
from the Main program group. Modify its' properties
(Alt+Enter) as follows; change the description to Set-
Clock, change the working directory to be the same one as
your comm program, modify the command to be the Set-Clock
PIF, and (if you wish) change the icon. (Try the clock icon
from the windows clock.exe file.) Click OK and your in
business.

Create a CFG-SC icon by duplicating an MS-DOS icon from the
Main program group. Modify its' properties as follows;
change the description to be CFG-SC (or something), change
the working directory to be the same on as for your comm
program, change the command line to be "cfg-sc procomm"
(sans quotes) add pursuit to the line if you are a PC-
Pursuit user, and change the icon. (Try the swiss army
knife from the progman.exe file.) Click OK and you are
done.

Use the PIF editor to tweak the PIF for the correct
directory info etc.

Double click on the correct icon to invoke Set-Clock or CFG-
SC. You will be returned to the program manager when the
programs exit.


















14
/.\
Appendix 1 - An Explanation of USA Standard Times

STANDARD TIME: In the U.S. the standard time is governed by
the Uniform Time Act of 1966 with amendments of 1972. This
law specifies the times of change-over to advanced time and
back to standard time. The amendment of 1972 gives
permission to a state to exempt the most easternmost portion
of that state from the time change. For example, the
easternmost part of Indiana does not use Daylight Saving
Time. Areas or states presently not on advanced time are
Arizona, Hawaii, Puerto Rico, the US Virgin Islands,
American Samoa and, the previously mentioned eastern part of
Indiana.

The Uniform Time Act is administered by the Department of
Transportation. In 1986 another amendment was passed by
Congress which changes the dates of change-over.

The new rule is: Spring change to advanced time on first
Sunday in April (0200 local time). Fall return to standard
time on last Sunday in October (0200 local time).

Remember we ADVANCE the clocks on the FIRST SUNDAY in APRIL
and RETARD the clocks on the LAST SUNDAY in OCTOBER. SPRING
FORWARD / FALL BACK.

US Time Zone UTC Offset Big Cities
-------------------------------------------------------------
Eastern Standard 5 Hrs behind UTC New York, Washington
Eastern Daylight 4 Hrs behind UTC
Central Standard 6 Hrs behind UTC Chicago, Houston
Central Daylight 5 Hrs behind UTC
Mountain Standard 7 Hrs behind UTC Denver
Mountain Daylight 6 Hrs behind UTC
Pacific Standard 8 Hrs behind UTC L.A., San Francisco
Pacific Daylight 7 Hrs behind UTC
Alaska Standard 9 Hrs behind UTC Most of Alaska (AKST)
Alaska Daylight 8 Hrs behind UTC
Aleutian Standard 10 Hrs behind UTC Islands West of 170W
Aleutian Daylight 9 Hrs behind UTC
Hawaii 10 Hrs behind UTC
Arizona 7 Hrs behind UTC
Indiana (east) 5 Hrs behind UTC
Bering 11 Hrs behind UTC Samoa, Midway

The reference time for international traffic is Universal
Time (UT, or UTC if accuracy greater than 1 second is
implied). This time is referenced to the meridian of
Greenwich, the international reference meridian for
longitude. For every 15 degrees you go east from Greenwich
you must add 1 hour (and subtract if you go west). For this
reason, the 15 degree multiples of the meridians are the
centers of standard time zones around the globe. The
standard zone times are, therefore, offset from UT by an
integer number of hours. However, there are exceptions,
e.g., the standard time for Newfoundland which is 3 1/2
hours behind UTC.

15
/.\

Regarding time zones outside the USA, there is no generally
accepted nomenclature. Each region has adopted some
practice but one and the same zone may be called one thing
in one area and be given a different name in another. As an
example you may take our Eastern Standard Time (EST) which
is also used on the west coast of South America. It would
make little sense for the Peruvians or the Colombians to
call their time EST when they are on the West coast of the
continent. Even more confusing is the situation with the
East 8 hour zone. It is used in Western Australia, central
Indonesia, the Philippines, all of China (China Standard
Time), and in the USSR where it is West-Central Siberian
Time. Obviously, the Russians will not call it Western
Australia Time. In addition, we have the problem with the
always changing Daylight Saving Time conventions which
depend on the local political decisions.




Note from the author of Set-Clock:

The above information was extracted from the Naval
Observatory BBS. For a more in depth look at time zones,
keeping accurate time, an explanation of UTC and modified
julian dates, see the files in NAVNIST.ZIP.































16
/.\

Appendix 2 - Contents of the NAVNIST.ZIP File


-*Disclaimer*- -*Disclaimer*- -*Disclaimer*- -*Disclaimer*-

The author of Set-Clock takes no responsibility for the
information contained in the following files. It was
obtained from the Naval Observatory's Bulletin Board System
and the NIST - ACTS. It is included here for informational
purposes only. No attempt has been made to verify the
information.

-*Disclaimer*- -*Disclaimer*- -*Disclaimer*- -*Disclaimer*-


Some information about the Naval Observatory and NIST - ACTS
has been captured for the Set-Clock users' general knowledge
and use. It has been stored in the ZIP file NAVNIST.ZIP.
Extract as much or as little as you wish and enjoy.


A list of the ZIP contents follows:

CLOCK.NVY - Info on the USNO master clock
MODJULDA.NVY - Info on what is a modified julian date
UTCTIME.NVY - Info on time zones, GMT, and UT
TSFORMAT.NVY - Info on the USNO time signal format
TSFORMAT.NST - Info on the NIST time signal format


The following is the output from PKUNZIP's verbose command.
If what you get is different from this list, the file has
been tampered with.


PKUNZIP (R) FAST! Extract Utility Version 1.1 03-15-90
Copr. 1989-1990 PKWARE Inc. All Rights Reserved. PKUNZIP/h for help
PKUNZIP Reg. U.S. Pat. and Tm. Off.

Searching ZIP: NAVNIST.ZIP - Naval Observatory & NIST - ACTS Information

Length Method Size Ratio Date Time CRC-32 Attr Name
------ ------ ----- ----- ---- ---- ------ ---- ----
7109 Implode 3310 54% 08-08-90 00:00 fc9003e2 --w CLOCK.NVY
7506 Implode 3559 53% 08-07-90 23:57 87ba4a2c --w MODJULDA.NVY
23882 Implode 9553 60% 08-07-90 23:50 e0acffc7 --w UTCTIME.NVY
6441 Implode 3231 50% 08-07-90 23:58 9138e8d8 --w TSFORMAT.NVY
6303 Implode 2484 61% 12-30-90 23:58 663af2e8 --w TSFORMAT.NST
------ ------ --- -------
51241 22137 57% 5







17
/.\

Appendix 3 - Contents of the GOODIES.ZIP File


The Goody Bag

This is the READ.ME / documentation for the files in
GOODIES.ZIP. The programs contained there in are shareware.
They are NOT public domain. You may not SELL them. You may
use them and share them with your friends. If you share
them, they must not be altered in any way. These things are
provided "AS IS". Please do not separate them from the Set-
Clock distribution.


Now that thats been said let's proceed. There are three
files in the archive; a simple DOS screen saver, a little
wait-a-bit program for use in batch files, and one of the
best Murphy's law programs on the face of this earth. (It
has over 600 sayings!)

SCR_SAV.EXE - turns your screen into an every varying quilt
of characters and colors. It runs until any key is pressed.
It is NOT a TSR that activates after an idle period.

WAIT.EXE - suspends execution until the number of seconds
given on the command line have passed. Keyboard input will
stack up while it is executing. A Control-C will interrupt
it.

MURPHY.EXE - for your autoexec file or anywhere else you
wish to stop and smile. (A good idea to place WAIT after
this one to give yourself a chance to read the saying.)
This program is full of over 600 Murphy's laws, fortune
cookie and "May a ..." type of sayings.

Use them in good health and enjoy. As always, your comments
are welcomed. Please print off the SEND-ME.IN file and let
the author know what they are.


















John 3:16
18
/.\

Registration Form for Set-Clock / CLKSET V4.0


Name: ______________________________________________

Address1: ______________________________________________

Address2: ______________________________________________

City: ______________________________________________

State/Province: ______________________ Zip Code: ____________



Single User Registration: $7.50

(for a hard copy of the documentation add $2.50) _____

Total enclosed: _____


Which "flavor" of Set-Clock are you using:

PCPLUS V1.x ___, PCPLUS V2.x ___, PCPLUS/Win ___,
Qmodem ___, Telix ___


Are you a PC Pursuit user?: Yes ___, No ___


How did you obtain Set-Clock? : _______________________________

_______________________________________________________________

_______________________________________________________________


Comments / Suggestions: _______________________________________

_______________________________________________________________

_______________________________________________________________

_______________________________________________________________


Send to: Terry Dutcher
P.O. Box 59458
Potomac, MD 20859


Thanks. With your paid registration comes a User Certificate,
instructions on how to remove the shareware notice / delay from
CLKSET and (if your Set-Clock script was compiled) a source code
listing.

19