OS/2 Shareware BBS: InfoMgt/InfoMgt.zip/wldck153.zip/WLDCLOCK.HLP

OS/2 Help File | 1996-11-23 | 53KB | 730 lines

ΓòÉΓòÉΓòÉ 1. Introduction ΓòÉΓòÉΓòÉ

World Clock is a multi-city time display clock for OS/2 V2.1 and Warp.  World
Clock allows you to define between one and twenty-four clocks.  You can select
any city or any location around the world, for each clock.  Choose from over
550 cities in the provided City List or build your own Custom City List.

World Clock starts with six clocks defined by default.  This was the fixed
number of clocks defined in versions before V1.50.  If you don't need six
clocks, you can delete the definitions of the unwanted clocks.  Fewer clocks
will reduce the time it takes to load World Clock, and will reduce the run-time
overhead.  You can add additional clock definitions at any time.

World Clock gets the time from your computer's internal clock.  In order to
display the time at other locations, World Clock must know some things about
your local time zone.  The information about your local time zone and other
options of World Clock are maintained in an OS/2-style notebook.  The Settings
Notebook is opened by pressing {Ctrl}S while the World Clock window has the
focus, or by clicking on a City Name or Time Display with mouse-button #1 (the
left button, if your mouse is right-handed), or by clicking on a City Name or
Time Display with mouse-button #2 and then selecting "Settings" from the "Pop
Up" menu.

The Settings notebook has eleven pages.  Each page contains choices or options
by which you can tailor World Clock to your specific needs.  When you install
World Clock and run it for the first time, you should open the Settings
notebook and turn to the Local Zone page.  World Clock gets the time from your
computer's internal clock.  In order to display the time at other locations,
World Clock must know your Local Time Zone  and your current Daylight Savings
Time status.  It is important to set these now.

If the time in your computer's clock is not correct, you can set it by clicking
on the "Set Date/Time" button on the Local Zone page or by turning to the
Atomic Time page.  There you can get the correct time and date by communicating
by telephone with an atomic-clock time server.  You will need at least a 1200
Baud modem to use this feature, which is available only through US telephone
numbers.  Separate utilities are available for calling such servers through the
internet, which may be more useful if you are located in another country, or
simply to avoid a long-distance telephone call.

Once your Local Zone information and computer time is set, you should turn to
the City List page, it is used to define each clock.  You will see a list of
over 550 cities from which you can choose.  You can also build your own Custom
City List. Use the Font page to select a smaller font for a long city name.  Or
use the Size page to make the clocks larger.

Turn to the Layout, Color, Timer and Alarm pages to further customize World
Clock.

Please see Disclaimer.

Please see Registration.

Please see Contacting the Author.

Please see World Clock Product Location for information on where to find World
Clock.

Please see Known Problems for information about odd World Clock behavior.

World Clock allows you to use Drag & Drop wherever it can.  For example, to
change or delete clocks or alarms, you can Drag & Drop the item from its list
box to the appropriate button or the shredder.

A word of warning about Drag & Drop.  If you move the mouse quickly, after
starting a Drag operation, OS/2 may decide the mouse pointer is over an item
above or below the item you intend to drag.  This can lead to the Drag & Drop
operation being preformed on the wrong item.  You should pay close attention to
the warning messages.


ΓòÉΓòÉΓòÉ 2. Disclaimer ΓòÉΓòÉΓòÉ

Keystone Software Corp. makes no representation or warranty with respect to the
adequacy of this program or the documentation which describes it for any
specific purpose, or with respect to its adequacy to produce any particular
result.  In no event shall Keystone Software Corp., its employees, its
contractors, the authors of the program and documentation, or Watcom (Watcom
International Corporation and all of its subsidiaries) be liable for special,
direct, indirect or consequential damages, losses, costs, charges, claims,
demands or claim for lost profits, fees or expenses of any nature or kind.


ΓòÉΓòÉΓòÉ 3. Trademarks ΓòÉΓòÉΓòÉ

IBM, OS/2 and Warp are registered trademarks of International Business Machines
Corporation, Armonk, N.Y.

Watcom and VX-REXX are trademarks of Watcom International Corporation.

CompuServe is a registered trademark of CompuServe Incorporated.

Other trademarks are the trademarks of their respective trademark owners.


ΓòÉΓòÉΓòÉ 4. Known Problems ΓòÉΓòÉΓòÉ

Sometimes there are problems with World Clock that have their root cause in
Watcom's VXRexx (the tool I use to build World Clock) or in IBM's OS/2 Warp.
Since Warp comes in many flavors (Connect & Server versions) and FixPacks are
available, bugs can exist in some versions and not others.

I try my best to code around these problems but that isn't always possible.
This section briefly describes the Known Problems and what you might be able to
do about them.  Please feel free to Contact Me for additional help or if your
problem isn't listed here.

Sometimes an error message is displayed when OS/2 is shutdown and World Clock
is still running.  I have been able to reduce the frequency of this problem but
not completely eliminate it.  It has no harmful effect other that the annoyance
of having to respond to the message.

Users with FixPack 17 applied often can't get to the World Clock Information
and Registration windows (the z-order problem, Warp loses the window).  This
makes it difficult to enter the Registration information.  I believe there is a
correction for this in FixPack 22 and Warp v4 (Merlin).  Please Contact Me for
an alternative means of entering your Registration-Code.

Warp Connect & Server seem to have a problem posting "Change" events for
Spin-Buttons.  A fix is expected in FixPack 23.  IBM doesn't make all FixPacks
available to the general public.  Since FixPack 22 is generally available, 23
probably won't be.  You may have to look around for FixPack 23 or ask IBM about
it or just the Spin-Button fix.  This problem is fixed in Warp v4 (Merlin).

World Clock uses Spin-Buttons in a few different places, the circumvention
depends upon which Spin-Button is being changed.  I have added some code to
relieve this problem but the code may not cover every case.

Some Spin-Buttons select the clock you want to configure.  If you can't select
the clock you want with the Spin-Button, turn to the City List page, select the
clock you want and return to the original page to make the setting.

Spin-Buttons are used to set the number of Columns and Rows of clocks
displayed.  Normally the Columns and Rows displayed change instantly.  If they
don't, try changing the focus to another object on the page (click somewhere
else, I added code to detect the loss of focus).  If this doesn't work, Contact
Me for additional help.

Thank you very much for your patiences with these problems.


ΓòÉΓòÉΓòÉ 5. Local Zone ΓòÉΓòÉΓòÉ

World Clock gets the time from your computer's internal clock.  In order to
display the time at other locations, World Clock must know your Local Time Zone
and your current Daylight Savings Time status.

Select your Local Time Zone from the list-box.  The Time Zones are numbered
West and East of Greenwich, England.  There are Time Zone names and places
displayed on the right to aid your selection.  If you are in a time zone that
is not an integral number of hours from Greenwich, set the number of minutes to
change the time difference from Greenwich.

Next set your Time Zone's Daylight Savings Time status.  Note "Off" means your
Time Zone is not presently in Daylight Savings Time.  When Daylight Savings
Time changes in your Local Time Zone you should make the correct setting here
and then set the time in your computer.  You can set the time in your computer
by clicking on the "Set Date/Time" button to use the OS/2 System Clock Settings
or by turning to the Atomic Time page and calling for the time.

World Clock can free you from changing the time in your computer's internal
clock to Daylight Savings Time.  If you want the internal clock in your
computer to exactly match the time in your locality, then you should set the
Local Zone information and internal clock to match your locality.  If you would
like to keep your computers internal clock on Standard Time, then you should
set the Daylight Savings Time indicator to "Off" and leave it that way all year
long.  You can set one of the display clocks to your local time and set the
Daylight Savings Time indicator for that clock to match the local time.  In
this way your internal clock can remain on Standard Time and you can still see
the current local time.

Your computer's internal clock can even be set to the time in some other time
zone, e.g. Greenwich, England, or local time at your corporate headquarters.
This can be useful if you set the time from a corporate WAN or if you need to
keep database timestamps in sync.  World Clock will display correct times as
long as you set the Local Zone information correctly, which means it must match
the time in your computer.  Again you can see the current local time by setting
one of the display clocks to it.


ΓòÉΓòÉΓòÉ 6. City List ΓòÉΓòÉΓòÉ

The City List page is used to define clocks.  Select a clock from the list box
and click on "Change" to open the Clock Detail window.  Or click on "Add" to
copy the currently selected clock definition to a new clock and to open the
Clock Detail window.

Use the "Delete" button to Delete a clock definition.  You can also delete a
clock definition by dragging the clock line from the list box to the Shredder
or to the "Delete" button.

Use the Up and Down arrow buttons to move the selected clock up or down within
the list.  This will change its position within the World Clock window display.

Note:  From time to time corrections must be made to the City List.  These
corrections are included in new versions of World Clock.  If you were using a
City that has changed, you may need to redefine the clock that references that
city.  World Clock may have a problem finding the City you were using (the list
is a simple list and not a database with unique indexes).  The solution is to
redefine the clock and select the same city (in its corrected form).  This
won't occur often but when it does, we apologize for any inconvenience.

If you notice any mistakes or deficiencies in the City List, please Contact the
Author.

If the supplied City List does not meet your needs, you can define your own
Custom City List.


ΓòÉΓòÉΓòÉ 6.1. Clock Detail ΓòÉΓòÉΓòÉ

You define the settings for a clock in the Clock Detail window.  Choose the
city from the city list of over 550 cities, or build your own Custom City List.

The number of characters of the City Name to be displayed on the clock is set
with the spin button.  Use the Font page to select a smaller font for a long
city name, or use the Size page to make the Clocks larger.  Use the radio
buttons to set the present Daylight Savings Time status for the city you have
selected.  Use the check box to choose whether or not to display seconds on the
Time Display of the selected clock.  Use the radio buttons to select 12-Hour or
24-Hour time display style.  If you choose not to display seconds on any of the
clocks, see the Timer page.


ΓòÉΓòÉΓòÉ 7. Layout ΓòÉΓòÉΓòÉ

The Layout page allows you to define the number of columns and rows of clocks
within the World Clock window.  This defines the size of the World Clock
Window.  The Clocks are numbered from left to right and from top to bottom.
The clocks will be displayed in the first row until the number of columns is
reached, then they start in the next row until the clocks are completed.  The
spin buttons set the rows and columns.  The number of clocks that can be
displayed is the rows times the columns.  If you have defined a smaller number
of clocks, some of the window will be empty.  If you have more than that number
of clocks defined, some of the clocks will not be displayed.

This feature has changed with version 1.5 of World Clock.  Previous versions
defined a fixed number (six) of clocks, and the Layout feature was designed for
that number of clocks.

Check the "Pop Up to Top" box if you want World Clock to keep itself always
visible, on top of all other windows.

The "Hint Bar Placement" selection allows you to define where and when you want
"Hints" displayed.  There are five selections.  "Top as needed" displays the
hint bar at the top of the window when the "Pop Up" menu is displayed.  "Bottom
as needed" displays the hint bar at the bottom of the window when the "Pop Up"
menu is displayed.  "None" never displays hints.  "Top always" always displays
the hint bar at the top of the window. "Bottom always" always displays the hint
bar at the bottom of the window.

Press {Shift}F10 when the World Clock window has the focus to display the "Pop
Up" menu (Context Menu) at the screen position of the mouse.

Check "Display Title" if you want the World Clock window displayed with the
System Menu and Title Bar.  If left un-checked the System Menu and Title Bar
are not displayed and the window is smaller.  If the System Menu is not
displayed, you must use the Context Menu to close and exit World Clock.

Check "Display Date In Title" to display the Date in the Title Bar.  This may
interfere with some programs, e.g. Stardock's "Object Desktop", that keep track
of windows by what they find in the Title Bar (whether or not the Title Bar is
actually displayed).  If left un-checked "World Clock" is the text in the
caption, this should keep such programs happy.

The Date can be displayed in a Date Bar.  The Date Bar can be used when the
Date can't be displayed in the Title Bar or when the Date displayed in the
Title Bar is too large to display properly.  The Date Bar Page offers many
options for defining the appearance of the Date in the Date Bar.

The following are a few examples of the various ways to display the World Clock
window.


ΓòÉΓòÉΓòÉ 8. Date Bar ΓòÉΓòÉΓòÉ

The Date Bar can be used when the Date can't be displayed in the Title Bar or
when the Date displayed in the Title Bar is too large to display properly.  The
Date Bar is at the top of the window and is as wide as the window (clock width
* columns).  The Date Format page offers the option of setting the Font,
BackGround Color, ForeGround Color, Date Bar Height and Date Display Format.
See the Layout Page documentation for sample views of the World Clock window
with and without the Date Bar.

Check "Display Date In Bar" to display the Date in a Date Bar.

The font may be set through the use of a Font Dialog window or the OS/2 Font
Palette.  The Font Dialog is the simpler means of selecting and setting the
Date Bar Font, while the OS/2 Font Palette is a little more difficult to use at
first but makes it possible to try various fonts conveniently.  The current
font is named and displayed on the wide button at the top of the page.

Clicking on the wide button at the top of the page will open the Font Dialog
window.  The font, its size and style are selected from drop-down combo boxes.
Pressing "OK" will set the font.

To use the OS/2 Font Palette press the "Open Font Palette" button.  The Font
Palette is used to select and define Fonts.  Click mouse button #2 on the
desired font on the Palette and drag it to the wide button at the top of the
page to set the font.

The BackGround and ForeGround Colors can also be set in two ways.  The simple
way is to use the list of colors on this page.  The OS/2 Color Palette is a
little more difficult to use but makes it possible to select from a greater
range of colors.

The drop-down-combo box contains a list of basic colors.  "Date BackGround" and
"Date ForeGround" radio buttons specify which color area is being set.

To use the OS/2 Color Palette press the "Open Color Palette" button.  The Color
Palette is used to select the colors.  To set the background color, click with
mouse button #2 on the desired color and drag it to the wide button at the top
of the page.  To set the foreground color, click with mouse button #2 on the
desired color while holding down the Ctrl key, and drag it to the wide button.

The Date Bar Height is set by entering a value in the spin button entry field
or fine tuning it with the spin button arrows.  The screen units of measure are
Twips or Pixels.  The current units are set on the Size page.

The Date Bar Format is selected from the drop-down-combo box of formats.  The
formats display the current date in various ways.

Press the "OS/2 Default" button to set the Date Bar to the default OS/2 font
and colors.

Press the "WC Default" button to set the Date Bar to the
"<default>/<default>/Blue" World Clock font and colors.

Press the "UnDo" button to UnDo all changes to the Date Bar settings.

World Clock now saves font and color changes made by dragging fonts or colors
from the OS/2 Font or Color Palette to clock parts when the Settings notebook
is NOT open.


ΓòÉΓòÉΓòÉ 9. Size ΓòÉΓòÉΓòÉ

The height and width of the individual clocks are set on the Size page.  All
clocks are the same size.  Clocks have two parts: the City Name part and the
Time Display part; these two parts can be of different heights but are the same
width.  By setting clock sizes along with Font sizes you can tailor World Clock
to look the way you want.  If you have a network server screen that isn't used
much, you can set large clock and font sizes to turn it into a large World
Clock display screen.

The position of the World Clock window on the screen can also be set on the
Size page.

The screen units of measure are Twips or Pixels, Twips is the default.  A Twip
is defined as a twentieth of a point, where a point is 1/72nd of a logical
screen inch, as defined by the video driver.  Use the radio buttons to choose
Twips or Pixels.  Because of the difference in size between Twips and Pixels,
switching from Twips to Pixels and back may not return to the same value. This
difference in size and the way some screen drivers work may cause slight
positioning discrepancies.


ΓòÉΓòÉΓòÉ 10. Color ΓòÉΓòÉΓòÉ

The background and foreground colors for each clock are set on the Color page.
The default color for all clocks is <default>/Blue which means blue characters
on the OS/2 System default button-background color.  The background and
foreground colors can be set in two ways.  The simple way is to use the list of
colors on this page.  The OS/2 Color Palette is a little more difficult to use
but makes it possible to select from a greater range of colors.

The drop-down combo box supplies a list of basic colors.  "City BackGround",
"City ForeGround", "Time BackGround" and "Time ForeGround" radio buttons
specify which color area is set.

To use the OS/2 Color Palette press the "Open Color Palette" button.  The Color
Palette is used to select the colors.  The current colors for the Clock Title
area and Time Display area are specified and displayed on the large buttons on
the Color page.

To set the background color, click with mouse button #2 on the desired color,
and drag it to the one of the large buttons to the right of City/Time.  To set
the foreground color, click with mouse button #2 on the desired color, while
holding down the Ctrl key, and drag it to one of the large buttons to the right
of City/Time.

Use the spin button to change the Clock selection.

Press the "Apply to All Clocks" to set all clocks to the colors of the
currently selected clock.

Press the "OS/2 Default" button to set the selected clock to the default OS/2
colors.

Press the "WC Default" button to set the selected clock to the "<default>/Blue"
World Clock colors.

Press the "UnDo" button to UnDo all changes to all clocks.

World Clock now saves color changes made by dragging colors from the OS/2 Color
Palette to clock parts when the Settings notebook is NOT open.


ΓòÉΓòÉΓòÉ 11. Font ΓòÉΓòÉΓòÉ

The font for the City Name Title and Time parts of a selected clock is set from
the Font page.  The default font for all clocks is <default> which means the
default OS/2 system font.  The current fonts for the Clock Title area and Time
Display areas are specified and displayed on the large buttons at the top of
the Font Page.

The fonts may be set through the use of a Font Dialog window or the OS/2 Font
Palette.  The Font Dialog is the simpler means of selecting and setting fonts.
The OS/2 Font Palette is a little more difficult to use at first but makes it
possible to try different fonts easily.

Pressing one of the buttons at the top of the page will open the Font Dialog
window.  Press the button to the right of "City" to set the Clock Title area
font.  Press the button to the right of "Time" to set the Time Display area
font.  The font and its size and style are selected from drop-down combo boxes.
Pressing "OK" will set the font.

To use the OS/2 Font Palette press the "Open Font Palette" button.  The Font
Palette is used to select and define fonts.  Click on the desired font on the
Palette with mouse button #2 and drag it to one of the large buttons to right
of City/Time to set the font.

Use the spin button to change the selected clock.  p. Press the "Apply to All
Clocks" button to set all clocks to the same font as the currently selected
clock.

Press the "Default" button to set all clocks to the default font.

Press the "UnDo" button to undo all changes to all clocks.

World Clock now saves font changes made by dragging fonts from the OS/2 Font
Palette to clock parts when the Settings notebook is NOT open.


ΓòÉΓòÉΓòÉ 12. Custom Cities ΓòÉΓòÉΓòÉ

If the extensive list of cities in the City List, included with World Clock
does not include a city you need, you can maintain a list of cities (or time
zones) of your own.  The Custom Cities page displays your cities in a list.
Clicking on "Add" or "Change", after you click on a city in the list, will
pop-up a city data window.  Enter the City Name information in the data entry
field and set the Time Zone from the list-box.  Click on "OK" or "Cancel" to
return to the Custom Cities page.  The "Delete" button will delete the selected
city and "Save" will save your entire city list in a disk file.  Clicking on
"Save" with an empty list of cities will erase the Custom cities list.


ΓòÉΓòÉΓòÉ 13. Atomic Time ΓòÉΓòÉΓòÉ

After setting your Local Time Zone information, you can turn to the Atomic
Clock page and call for the correct time.  World Clock will call an atomic
clock of the U.S. Naval Observatory, in Washington, D.C. (area code 202) for
the date and time.  The call takes about one minute.  If you are far from
Washington, you will probably wish to use an alternative method.  There are
utilities which can be downloaded from the Hobbes, Walnut, and Leo sites (among
others) that access atomic clocks through the Internet, thus avoiding telephone
charges altogether.

To use this feature, you will need a modem capable of data rates of 1200 bps.
World Clock needs to know to which port your modem is attached.  You may need
to enter a modem initialization string to set your modem.  You can change the
dial and hang-up code if necessary.  You can also add prefix digits to the
telephone number, if this is necessary to dial out of your phone system.
Clicking on "Call" will dial the Atomic clock, get the time and date and set
your computer's system clock.  Be sure you have set your Local Time Zone
settings, because the Atomic Clock returns the time in Greenwich, and your
local information is needed to adjust the time and date for your location.  For
this procedure to work, the modem and its port must not be in use by any other
running program.

If the Atomic Clock call encounters any problems, your computer's clock will
not be changed.

There are other atomic clocks around the world in addition to this one at the
U.S. Naval Observatory, in Washington, D.C. that can be called for the time and
date.  Most of them present the time and date information in different formats.
This mechanism has only been tested with the atomic clock in Washington.  It is
unlikely it will work with other atomic clocks.


ΓòÉΓòÉΓòÉ 14. Timer ΓòÉΓòÉΓòÉ

By default, World Clock updates the time displayed on the clocks every second.
You can use a spin button on the Timer page you to change the time between
display updates.  You can set the clocks to be updated every 1, 2, 3, 4, 5, 10,
15, 20, 30, 60, or 120 seconds.  If you display seconds, see City List, a timer
setting of 1 is best.  If you don't display seconds, a setting of 60 or 120,
may save some system overhead.  This may improve the speed performance of
slower computers.


ΓòÉΓòÉΓòÉ 15. Alarms ΓòÉΓòÉΓòÉ

You can set alarms for each clock on the Alarms page.  Use the spin button to
select a clock.  Alarms sound according to the clock they are set for.  For
example, if one of your clocks displays London time and you want to know when
it is 4:00 pm in London, set an alarm in your London clock for 4:00 pm.

When an alarm sounds, a window pops up; if you have multimedia installed and
have set a multimedia filename the multimedia file is played.  Any multimedia
file can be played including sound, music and video.

Set the 'Display Alarm Indicator ""' check box to display the Alarm Indicator
"" to the right of the time for clocks that have one or more alarms set.

Click on "Add" to add a new alarm.  Click on an alarm from the list box, and
then click on "Change" or "Delete" to change or delete the alarm.

Enter or change the Alarm time in the Time Entry field.  Use the radio buttons
to set the Alarm for an "Every Day" alarm or "Today Only".  "Every Day" alarms
will be repeated every day until you delete them; "Today Only" alarms will be
deleted automatically after the alarm is sounded.

In the Alarm Message entry field, enter a message to be displayed when the
alarm sounds,

Enter a multimedia filename or use the "Find" button to find a multimedia file
to play when the Alarm is made.

Click on "OK" to accept the new or changed alarm.  Click on "Cancel" to cancel
the new or changed Alarm.

Click on "Play" to try the multimedia file.


ΓòÉΓòÉΓòÉ 16. Saving Settings ΓòÉΓòÉΓòÉ

Closing the Settings notebook saves all your settings in WLDCLOCK.INI.  This
file is read when World Clock is started, and its contents used to configure
World Clock according to your settings.


ΓòÉΓòÉΓòÉ 17. Context Menu ΓòÉΓòÉΓòÉ

The Context Menu gives you quick access to some of World Clock's options.  It
is a pop up menu that is invoked by pressing {Shift}F10 when the World Clock
window has the focus or by clicking on a clock with mouse button #2.  Most of
the menu options have help entries of their own.  Those that don't are
explained here.


ΓòÉΓòÉΓòÉ 17.1. View World Clock Book ΓòÉΓòÉΓòÉ

The OS/2 "View" program is called to display the World Clock documentation.  It
is the same information that is available under "Help" but the View program
allows you to read it from beginning to end more easily.


ΓòÉΓòÉΓòÉ 17.2. Minimize ΓòÉΓòÉΓòÉ

Minimize will minimize the World Clock window.  This is the same as the
Minimize option on the OS/2 System Menu in the upper left hand corner of most
windows.  It is useful when you don't have the Title Bar displayed.


ΓòÉΓòÉΓòÉ 17.3. Move & UnMove ΓòÉΓòÉΓòÉ

Move will put the World Clock window into the OS/2 Move mode and allow you to
position the window.  This is the same as the Move option on the OS/2 System
Menu in the upper-left corner of most windows.  It is also similar to clicking
with mouse button #2 on the Title Bar to move the window.  It is useful when
you don't have the Title Bar displayed.

Moving the window in this way does not save the new position in the Settings
file.  You must open the settings notebook, turn to the Size page to verify the
position and close the settings notebook, to save the new position.

This allows you to move the World Clock window temporarily, and have it return
to its original position next time it is started.

UnMove will return the World Clock window to the position defined on the Size
page of the settings notebook.


ΓòÉΓòÉΓòÉ 17.4. Close ΓòÉΓòÉΓòÉ

Close will close the World Clock window.  This is the same as the Close option
on the OS/2 System Menu in the upper left hand corner of most windows.  It is
also the same as double clicking on the System Menu to close the window.  It is
the only way to close the window when the Title Bar is not displayed (except,
of course, for doing so through the OS/2 Task List or by the close button
provided by several extensions to the operating systems).


ΓòÉΓòÉΓòÉ 17.5. Reset Window Size ΓòÉΓòÉΓòÉ

Reset Window Size will re-size the World Clock window to size defined by the
current clock row and column settings.  This is useful if you have changed the
window size by stretching it to better see the hints.


ΓòÉΓòÉΓòÉ 18. Registration ΓòÉΓòÉΓòÉ

World Clock is sold as Shareware: "Try before you buy".  If you like World
Clock and haven't registered and paid for your copy, you should do so.

You have 30 days to try World Clock after which you should register or stop
using it.  You will have another 30 days after sending your registration fee,
to allow time to receive and enter your registration code, after which World
Clock may stop working, undo your settings or just continue to remind you to
register.

The registration fee is $25.00 U.S. for check and credit card payments and
$29.50 when paying through CompuServe SWReg ID:  5786.  Checks must be drawn on
U.S. banks and payable in the U.S.A.  Credit card sales are through EDI Tech.

You can bring up the Registration menu by pressing {Ctrl}R while the World
Clock window has the focus or by selecting "Registration" from the context
menu.  You can bring up the context menu by clicking on the window with the
mouse button #2 or pressing {Shift}F10 while the World Clock window has the
focus.

If you pay by credit card, you can send the registration information by e-mail.
See: Contacting the Author.  Also see how to put the registration information
in the clipboard, below.

Fill in the requested information and print the registration form if you wish
to mail it with your check or credit card information.  Please contact Louis
LaBrunda with any questions or for volume discount information.  You can find
the latest version of World Clock in the IBM OS/2 Users Forum (Go OS2USER) on
CompuServe.  Your registration code will work with all V1.x versions.

Be sure to enter your name the way you wish it to be displayed in the
Information window.  Your name is used in the Registration-Code verification
process.  Your name and Registration-Code are linked and must by entered in the
Registration window for your copy of World Clock to be considered Registered.
Your address is necessary for us to return your Registration-Code by Mail.
Your Comments are also welcome.

Clicking on "Create/Print Form" will create the file "RegForm.Txt" and open a
Printer List window.  The contents of the registration form are also placed in
the clipboard.  You can print the form by selecting a printer and clicking on
"Print".  You can also exit without printing the form and send the
"RegForm.Txt" via e-mail or print it in any way you choose.  If you use CIM for
OS/2 or some other CompuServe or e-mail interface, the registration form image
can be inserted from the clipboard into an e-mail message.

If you choose not to register World Clock and wish to remove it from your
system, just delete the World Clock folder, and the folder that VRObj.DLL is
stored in probably C:\VXRexx.  If you have VXRexx or any other product of
Keystone Software Corp. or of others that use VRObj.DLL, don't delete that
folder or the directory in which VRObj.DLL is stored.  You can also delete the
World Clock Desktop Object.

Since World Clock is sold as shareware it may be distributed by anyone as long
as it is complete and no more than a reasonable media fee is charged.

See Disclaimer.


ΓòÉΓòÉΓòÉ 19. Contacting the Author ΓòÉΓòÉΓòÉ

You can reach Louis LaBrunda and Keystone Software Corp. at:

          Louis LaBrunda
          Keystone Software Corp.
          P.O. Box 265
          Liberty Corner, NJ  07938-0265

     Voice:         908-647-5905
     CompuServe:    71604,1662
     Internet:      [e-mail]
     HomePage:      http://ourworld.compuserve.com/homepages/Louis_LaBrunda

 Please contact us about your OS/2 consulting and software needs.


ΓòÉΓòÉΓòÉ 20. Product Location ΓòÉΓòÉΓòÉ

World Clock can be found on the Keystone Software Corp. HomePage:

http://ourworld.compuserve.com/homepages/Louis_LaBrunda

It can also be found in the IBM OS/2 User Forum on CompuServe (GO OS2USER), and
other Forums.  Search for WldCk* to find the latest version.

KSC products can also be found on many BBS's and FTP sites.  Keystone is
working on a new larger Web site that will contain more of its products and be
capable of FTP transfers.


ΓòÉΓòÉΓòÉ 21. Desktop Object ΓòÉΓòÉΓòÉ

This Menu option will create a Desktop Program Object you can use to start the
World Clock program.  It may also create a shadow in the StartUp folder, that
causes World Clock to be started by OS/2 when it boots.  The Install process
creates the same objects, but if they have somehow been lost or corrupted, this
option will recreate them for you.


ΓòÉΓòÉΓòÉ 22. Watcom's VRObj.DLL ΓòÉΓòÉΓòÉ

World Clock requires Watcom's VXRexx VRObj.DLL runtime library, version 2.1
patch level "D".  It can be found as VRObj21D.Zip on BBS's, FTP sites, in the
IBM OS/2 User Forum on CompuServe and on the KSC WEB page.  See:  Contacting
the Author and Product Location.  If you already have this or a later version
of VRObj.DLL you don't need to get it again.

You may have other programs that use VRObj.DLL, if so, you may have more than
one copy of the file.  You only need the latest version and having older
versions can cause problems.  When starting, World Clock or one of your other
programs may complain about the version of VRObj.DLL running and ask if it
should continue.  If you get this message, you probably have an old version
around somewhere.  If you allow the program to continue, it may run just fine,
or it may behave in an odd manner, or not run at all.

DLLs are shared in memory by programs written to use them.  If an old program
runs and causes an old version of a DLL to be loaded it will run properly.
Subsequently loaded programs that require a newer version will not cause the
newer version of the DLL to replace the older version in memory; the older
version of the DLL may not be able to support the newer program properly.

You can use the OS/2 "Find" tool on the LaunchPad or "Seek and Scan Files" from
the Productivity folder to locate all the copies of VRObj.DLL.  Be careful and
only delete the older versions.

World Clock puts VRObj.DLL in the C:\VXRexx folder or where ever you chose at
installation time.  This folder or a folder where you keep DLLs is a good place
to keep it.  The folder name should be in the "LibPath" statement in your
"ConFig.SYS" file.


ΓòÉΓòÉΓòÉ 23. Running from a LAN or Server ΓòÉΓòÉΓòÉ

World Clock can be run from a LAN or Server disk.  This allows for the saving
of disk space on each user PC and for simple upgrading to new versions of World
Clock.  The registration fee should be paid for each PC user.  Please Contact
the Author for volume prices and information on how to install and run World
Clock from a LAN or Server disk.