World of Ham Radio 1994 January

home *** CD-ROM | disk | FTP | other *** search

/ World of Ham Radio 1994 January / AMSOFT_1994.iso / misc / suntime / prog / anytime.doc < prev next >

Wrap

Text File | 1993-12-31 | 12.5 KB | 263 lines

Any-Time Version 1.2 by RejTech - - - - - - - - - - - - - - - - - Copyright(c) 1992, RejTech P.O. Box 721247 Oklahoma City, Oklahoma 73172-1247 OVERVIEW: --------- ANYTIME is a program which will display the current time in up to eleven cities (worldwide) simultaneously. The program uses a modern user interface which is very simple to use and can be controlled either from the keyboard or with a mouse. The cities displayed are selected from a database which currently contains over 1300 entries and may be customized using any ASCII text editor. INSTALLATION: ------------- Simply copy all files to any desired directory. Files contained on the installation disk: ANYTIME.EXE - Main Program File ANYTIME.CFG - Stores Current Program Configuration ANYTIME.DOC - Documentation for ANYTIME.EXE (this file) REJTECH.COM - Software Registration Module REGISTER.BAT - Batch procedure to print registration form and receive a discount for registering both ANYTIME and SUNTIME together. CITIES.DAT - City Data File TIMEZONE.DAT - Time Zone Definition File Both data files (CITIES.DAT and TIMEZONE.DAT) are required for operation and must be in the same directory as ANYTIME.EXE. OPERATION: ---------- Using this program is very simple. To start the program from DOS simply type "ANYTIME" and hit <Enter> at the DOS prompt. When the program has been activated, just select one of the 4 buttons shown at the bottom of the screen (by pressing the indicated function key or clicking on the button with your mouse): [About] - Displays the program version and registration information. Buttons at the bottom of this window allow E-Z program registration plus the setting of various program options. [Cities] - Allows selection of a new city to replace one of the currently displayed cities. Three picklists will be displayed in succession to complete this process. To select an entry from a pick-list, simply scroll thru the list using your mouse and the scroll-bar at the right or by using the cursor keys. When the desired entry is highlighted, press enter or click on that entry to select it. Any-Time Version 1.2 by RejTech - - - - - - - - - - - - - - - - - OPERATION (Continued): ---------------------- 1st picklist: Selects a new city to replace an existing entry shown on the screen. 2nd picklist: Selects the slot containing the old entry that is to be replaced. 3rd picklist: Selects the time zone associated with the new city. Initially, the default time zone for the city will be highlighted. To select it, simply press <Enter>. Note: for automatic daylight savings time adjust- ments, always select the default (STANDARD) time zone for the city. At any time during this process, you can hit <Esc> or click with the mouse cursor outside of the pick- list window to cancel the selection. [Zones] - Selects the base time zone for the computer. This selection only needs to be made once when the program is installed and thereafter only when the time changes from STANDARD to DAYLIGHT (or vice versa). This base time zone is displayed on line 2 of the program window along with the current computer time. This must be correct to enable the program to compute the correct time in the cities selected. [Exit] - Ends the program. Your current configuration will be saved before exiting the program, therefore the next time you execute "ANYTIME", the same cities will be shown. DATA FILES: ----------- The data files CITIES.DAT and TIMEZONE.DAT are simple ASCII text files which can be edited with any ASCII text editor. You may add or delete cities at will, but fields must begin in the same column on each line (one city per line), therefore your text editor should not insert any 'TAB' characters. Comment lines may be inserted in the files by placing an asterisk in column 1. Any-Time Version 1.2 by RejTech - - - - - - - - - - - - - - - - - DATA FILES (Continued): ----------------------- The CITIES.DAT file currently contains over 1300 cities which have been compiled from several sources. The program should be able to handle up to 2600 entries (128K of data). The current database is for the most part correct, but no guarantee can be made as to it's accuracy. Although minor corrections have been made to the data since version 1.0, it is essentially the same database. No attempt has been made to make updates for the recent changes in the USSR. Users, please let me know of any changes needed to existing cities in the database. Also, if you believe there is a major city which should included in the file, I will consider adding it to the next version. Thanks for your help in this area. The TIMEZONE.DAT file defines time zones used in CITIES.DAT. All 24 time zones are currently defined here along with several location- specific time zones. For areas where a non-standard time zone is used (Saudi-Arabia, etc), a code of 'XXX' should be placed in the 'CITIES .DAT' file. This will cause the standard time to be computed based on the longitude of the city. Note - The 3-digit time zone code MUST match in both files. If you decide to change this in the TIMEZONE.DAT file, you must also change each occurance of it in the CITIES.DAT file. - The program SUNTIME.EXE also uses these same data files. If you are using both programs, keep them in the same directory so that they may each share a single copy of the data files. DAYLIGHT SAVINGS TIME: ---------------------- If the 'Auto DST' flag in the CITIES.DAT file is set to 'Y' for the chosen city, that city is assumed to use the standard "Daylight Savings Time" pattern adopted by the United States. Under this system, day- light savings time begins on the first Sunday in April and ends on the last Sunday in October. If a city does not follow this pattern, this flag should be set to 'N'. You will then need to manually select a time zone corresponding to daylight savings time when it is in effect. In future versions, this flag may be expanded to a code which will signify different (non US) DST patterns (...users with information on other DST patterns used throughout the world are encouraged to let me know about them so that they can be incorperated into future versions). Any-Time Version 1.2 by RejTech - - - - - - - - - - - - - - - - - SETTING PROGRAM OPTIONS ----------------------- Version 1.2 allows user selection of various program options such as time and date display format, screen colors and video display mode. To register, select the <About> button in the program's main window, then select the <Setup> button. This will open a dialog box which allows change of the current program options: 1. Video Mode - Enter 'F' for the fastest video display. If this causes problems, select 'D' or 'B'. Both of these options will eliminate snow on CGA monitors. The 'B' option (Bios) is the most compatible but is also the slowest. 2. Reset Video - Select 'Y' to force the video mode to be reset. This may be necessary if previous software did not leave the screen in normal text mode. Note that selecting 'Y' may force the screen to be cleared with certain video-display adaptors. 3. Cursor Size - Select 'S' for the standard cursor or 'B' for a larger block cursor (useful for LCD displays). 4. Clear Screen - Enter 'Y' to force the screen to be cleared to a textured background when the program is started. 5. Time Mode - Enter '2' for a 12-hour display format or '4' for a 24-hour display format. 6. Time Seperator - Enter the character that should be used to delimit the hours/minutes/seconds in the time display (normally a colon). 7. Date Mode - Enter 'M' to display dates in Month/day/year order, 'D' to display dates in Day/month/year order, or 'Y' to display in Year/Month/Day order. 8. Date Seperator - Enter the character that should be used to delimit the month/day/year in the date display (normally a dash). 9. Left Window Column - Enter a number from 1 to 18 to specify the screen column where the program window should be placed (normally 10 to center on screen). 10. Color Scheme - Enter 'C' for a CYAN (blue-green) display background on the display. Enter 'W' for a WHITE background, or 'B' for a BLUE background. When the options are set as desired, select the <Proceed> button (or press the <F2> key) to register the changes. Pressing the <Cancel> button (or <Esc> key) will abandon any changes made. SOFTWARE LICENSE REGISTRATION: ------------------------------ This program is copyrighted shareware and should be registered if you find it useful and intend to use it. A single user registration fee is only $5.00. To register, select the <About> button in the programs main window, then select the <Register> button. You will then be prompted for required information and a mailable registration form will be printed on your system printer. If this process fails or you do not have a printer connected to LPT1, send your name, address and and $5.00 (Check or MO, U.S.) to: RejTech, ANYTIME v1.2 Registration P.O. Box 721247 Oklahoma City, Oklahoma 73172-1247. Please state version number so that I can be sure you have the latest release. You may freely distribute the original program package to anyone that you think might benefit from it, provided all the files stated above are supplied intact and unaltered, including the REJTECH.COM file. Thanks for your support. Any-Time Version 1.2 by RejTech - - - - - - - - - - - - - - - - - WARRANTY: --------- This program is provided on an AS-IS basis WITHOUT warranty of any kind. As with all computer software, it could contain logic errors which might give erroneous results. RejTech will not be held liable for any damages, whether direct or consequential, arising from the use of this software. Please direct any comments or report any bugs to the address given above. You may also leave me a message on CompuServe. Rob Jordan, RejTech CompuServe ID: 70515,722